From da25daeb51160282604a58a7c8f84e596841f3ef Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 9 May 2010 23:21:12 +0600 Subject: [PATCH 01/76] first commit (move from factor-gir); basis/pango is gir-based now (very draft version); add gstreamer and gtkglext modules and samples --- basis/atk/Atk-1.0.gir | 8681 ++ basis/atk/atk.factor | 12 + basis/atk/authors.txt | 1 + basis/gdk/Gdk-2.0.gir | 22284 ++++ basis/gdk/authors.txt | 1 + basis/gdk/gdk.factor | 12 + basis/gdk/gl/GdkGL-1.0.gir | 30343 ++++++ basis/gdk/gl/authors.txt | 1 + basis/gdk/gl/gl.factor | 19 + basis/gdk/pixbuf/GdkPixbuf-2.0.gir | 2523 + basis/gdk/pixbuf/authors.txt | 1 + basis/gdk/pixbuf/pixbuf.factor | 6 + basis/gio/Gio-2.0.gir | 23740 +++++ basis/gio/authors.txt | 1 + basis/gio/gio.factor | 6 + basis/gir/authors.txt | 1 + basis/gir/common/common.factor | 20 + basis/gir/ffi/ffi.factor | 211 + basis/gir/gir.factor | 24 + basis/gir/loader/loader.factor | 245 + basis/gir/repository/repository.factor | 60 + basis/gir/types/types.factor | 135 + basis/glib/GLib-2.0.gir | 20295 ++++ basis/gmodule/GModule-2.0.gir | 108 + basis/gmodule/authors.txt | 1 + basis/gmodule/gmodule.factor | 6 + basis/gobject/GObject-2.0.gir | 6231 ++ basis/gobject/authors.txt | 1 + basis/gobject/gobject.factor | 50 + basis/gst/Gst-0.10.gir | 22063 ++++ basis/gst/authors.txt | 1 + basis/gst/gst.factor | 27 + basis/gtk/Gtk-2.0.gir | 88485 ++++++++++++++++ basis/gtk/authors.txt | 1 + basis/gtk/gl/GtkGL-1.0.gir | 173 + basis/gtk/gl/authors.txt | 1 + basis/gtk/gl/gl.factor | 15 + basis/gtk/gtk.factor | 23 + basis/pango/Pango-1.0.gir | 7445 ++ basis/pango/authors.txt | 1 + basis/pango/cairo/PangoCairo-1.0.gir | 203 + extra/gir/samples/lowlevel/authors.txt | 1 + .../samples/lowlevel/gstreamer/authors.txt | 1 + .../lowlevel/gstreamer/gstreamer.factor | 63 + .../samples/lowlevel/hello-world/authors.txt | 1 + .../lowlevel/hello-world/hello-world.factor | 44 + extra/gir/samples/lowlevel/lowlevel.factor | 81 + extra/gir/samples/lowlevel/opengl/authors.txt | 1 + .../gir/samples/lowlevel/opengl/opengl.factor | 93 + 49 files changed, 233742 insertions(+) create mode 100644 basis/atk/Atk-1.0.gir create mode 100644 basis/atk/atk.factor create mode 100644 basis/atk/authors.txt create mode 100644 basis/gdk/Gdk-2.0.gir create mode 100644 basis/gdk/authors.txt create mode 100644 basis/gdk/gdk.factor create mode 100644 basis/gdk/gl/GdkGL-1.0.gir create mode 100644 basis/gdk/gl/authors.txt create mode 100644 basis/gdk/gl/gl.factor create mode 100644 basis/gdk/pixbuf/GdkPixbuf-2.0.gir create mode 100644 basis/gdk/pixbuf/authors.txt create mode 100644 basis/gdk/pixbuf/pixbuf.factor create mode 100644 basis/gio/Gio-2.0.gir create mode 100644 basis/gio/authors.txt create mode 100644 basis/gio/gio.factor create mode 100644 basis/gir/authors.txt create mode 100644 basis/gir/common/common.factor create mode 100644 basis/gir/ffi/ffi.factor create mode 100755 basis/gir/gir.factor create mode 100644 basis/gir/loader/loader.factor create mode 100644 basis/gir/repository/repository.factor create mode 100644 basis/gir/types/types.factor create mode 100644 basis/glib/GLib-2.0.gir create mode 100644 basis/gmodule/GModule-2.0.gir create mode 100644 basis/gmodule/authors.txt create mode 100644 basis/gmodule/gmodule.factor create mode 100644 basis/gobject/GObject-2.0.gir create mode 100644 basis/gobject/authors.txt create mode 100644 basis/gobject/gobject.factor create mode 100644 basis/gst/Gst-0.10.gir create mode 100644 basis/gst/authors.txt create mode 100644 basis/gst/gst.factor create mode 100644 basis/gtk/Gtk-2.0.gir create mode 100644 basis/gtk/authors.txt create mode 100644 basis/gtk/gl/GtkGL-1.0.gir create mode 100644 basis/gtk/gl/authors.txt create mode 100644 basis/gtk/gl/gl.factor create mode 100644 basis/gtk/gtk.factor create mode 100644 basis/pango/Pango-1.0.gir create mode 100644 basis/pango/authors.txt create mode 100644 basis/pango/cairo/PangoCairo-1.0.gir create mode 100644 extra/gir/samples/lowlevel/authors.txt create mode 100644 extra/gir/samples/lowlevel/gstreamer/authors.txt create mode 100644 extra/gir/samples/lowlevel/gstreamer/gstreamer.factor create mode 100644 extra/gir/samples/lowlevel/hello-world/authors.txt create mode 100644 extra/gir/samples/lowlevel/hello-world/hello-world.factor create mode 100644 extra/gir/samples/lowlevel/lowlevel.factor create mode 100644 extra/gir/samples/lowlevel/opengl/authors.txt create mode 100644 extra/gir/samples/lowlevel/opengl/opengl.factor diff --git a/basis/atk/Atk-1.0.gir b/basis/atk/Atk-1.0.gir new file mode 100644 index 0000000000..27bb0f0466 --- /dev/null +++ b/basis/atk/Atk-1.0.gir @@ -0,0 +1,8681 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/atk/atk.factor b/basis/atk/atk.factor new file mode 100644 index 0000000000..c03b6397d6 --- /dev/null +++ b/basis/atk/atk.factor @@ -0,0 +1,12 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax +gir glib gobject glib.ffi ; + +IN: atk.ffi + +TYPEDEF: guint64 AtkState +TYPEDEF: GSList AtkAttributeSet + +IN-GIR: atk vocab:atk/Atk-1.0.gir + diff --git a/basis/atk/authors.txt b/basis/atk/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/atk/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gdk/Gdk-2.0.gir b/basis/gdk/Gdk-2.0.gir new file mode 100644 index 0000000000..1005087db9 --- /dev/null +++ b/basis/gdk/Gdk-2.0.gir @@ -0,0 +1,22284 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gdk/authors.txt b/basis/gdk/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gdk/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gdk/gdk.factor b/basis/gdk/gdk.factor new file mode 100644 index 0000000000..fc414cbce4 --- /dev/null +++ b/basis/gdk/gdk.factor @@ -0,0 +1,12 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax cairo.ffi +gir glib gobject gio gmodule gdk.pixbuf glib.ffi ; + +IN: gdk.ffi + +TYPEDEF: guint32 GdkNativeWindow +TYPEDEF: guint32 GdkWChar + +IN-GIR: gdk vocab:gdk/Gdk-2.0.gir + diff --git a/basis/gdk/gl/GdkGL-1.0.gir b/basis/gdk/gl/GdkGL-1.0.gir new file mode 100644 index 0000000000..e86bb7963a --- /dev/null +++ b/basis/gdk/gl/GdkGL-1.0.gir @@ -0,0 +1,30343 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gdk/gl/authors.txt b/basis/gdk/gl/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gdk/gl/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gdk/gl/gl.factor b/basis/gdk/gl/gl.factor new file mode 100644 index 0000000000..09d86d2e57 --- /dev/null +++ b/basis/gdk/gl/gl.factor @@ -0,0 +1,19 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.c-types alien.libraries alien.syntax combinators kernel system vocabs.parser words +gir glib gobject gio gmodule gdk gdk.ffi gdk.pixbuf ; + +<< +"gdk.gl" { + { [ os winnt? ] [ "" "cdecl" add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdkglext-x11-1.0.so" "cdecl" add-library ] } +} cond +>> + +IN: gdk.gl.ffi + +<< ulong "unsigned long" current-vocab create typedef >> + +IN-GIR: gdk.gl vocab:gdk/gl/GdkGL-1.0.gir + diff --git a/basis/gdk/pixbuf/GdkPixbuf-2.0.gir b/basis/gdk/pixbuf/GdkPixbuf-2.0.gir new file mode 100644 index 0000000000..4c73110402 --- /dev/null +++ b/basis/gdk/pixbuf/GdkPixbuf-2.0.gir @@ -0,0 +1,2523 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gdk/pixbuf/authors.txt b/basis/gdk/pixbuf/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gdk/pixbuf/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gdk/pixbuf/pixbuf.factor b/basis/gdk/pixbuf/pixbuf.factor new file mode 100644 index 0000000000..d9550bd44c --- /dev/null +++ b/basis/gdk/pixbuf/pixbuf.factor @@ -0,0 +1,6 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gir glib gobject gio gmodule ; + +IN-GIR: gdk.pixbuf vocab:gdk/pixbuf/GdkPixbuf-2.0.gir + diff --git a/basis/gio/Gio-2.0.gir b/basis/gio/Gio-2.0.gir new file mode 100644 index 0000000000..273e6f09be --- /dev/null +++ b/basis/gio/Gio-2.0.gir @@ -0,0 +1,23740 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gio/authors.txt b/basis/gio/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gio/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gio/gio.factor b/basis/gio/gio.factor new file mode 100644 index 0000000000..bd20272f77 --- /dev/null +++ b/basis/gio/gio.factor @@ -0,0 +1,6 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gir glib gobject ; + +IN-GIR: gio vocab:gio/Gio-2.0.gir + diff --git a/basis/gir/authors.txt b/basis/gir/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gir/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gir/common/common.factor b/basis/gir/common/common.factor new file mode 100644 index 0000000000..10e7820432 --- /dev/null +++ b/basis/gir/common/common.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: assocs kernel namespaces ; +IN: gir.common + +CONSTANT: ffi-vocab "ffi" + +SYMBOL: current-lib + +SYMBOL: lib-aliases +lib-aliases [ H{ } ] initialize + +SYMBOL: type-infos +type-infos [ H{ } ] initialize + +SYMBOL: aliases +aliases [ H{ } ] initialize + +: get-lib-alias ( lib -- alias ) + lib-aliases get-global at ; diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor new file mode 100644 index 0000000000..a233f35794 --- /dev/null +++ b/basis/gir/ffi/ffi.factor @@ -0,0 +1,211 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien alien.c-types alien.parser assocs combinators +combinators.short-circuit effects fry generalizations +gir.common gir.types kernel locals math math.parser namespaces +parser prettyprint quotations sequences vocabs.parser words +words.constant ; +IN: gir.ffi + +: string>c-type ( str -- c-type ) + parse-c-type ; + +: define-each ( nodes quot -- ) + '[ dup @ >>ffi drop ] each ; inline + +: ffi-invoker ( func -- quot ) + { + [ return>> c-type>> string>c-type ] + [ drop current-lib get ] + [ identifier>> ] + [ parameters>> [ c-type>> string>c-type ] map ] + [ varargs?>> [ void* suffix ] when ] + } cleave \ alien-invoke 5 narray >quotation ; + +: ffi-effect ( func -- effect ) + [ parameters>> [ name>> ] map ] + [ varargs?>> [ "varargs" suffix ] when ] + [ return>> type>> none-type? { } { "result" } ? ] tri + ; + +: define-ffi-function ( func -- word ) + [ identifier>> create-in dup ] + [ ffi-invoker ] [ ffi-effect ] tri define-declared ; + +: define-ffi-functions ( functions -- ) + [ define-ffi-function ] define-each ; + +: signal-param-c-type ( param -- c-type ) + [ c-type>> ] [ type>> ] bi + { + [ none-type? ] + [ simple-type? ] + [ enum-type? ] + [ bitfield-type? ] + } 1|| [ dup "*" tail? [ CHAR: * suffix ] unless ] unless ; + +: signal-ffi-invoker ( signal -- quot ) + [ return>> signal-param-c-type string>c-type ] + [ parameters>> [ signal-param-c-type string>c-type ] map ] bi + "cdecl" [ [ ] 3curry dip alien-callback ] 3curry ; + +: signal-ffi-effect ( signal -- effect ) + [ parameters>> [ name>> ] map ] + [ return>> type>> none-type? { } { "result" } ? ] bi + dup . ; + +:: define-ffi-signal ( signal class -- word ) ! сделать попонятнее + signal dup . + [ + name>> class c-type>> swap ":" glue create-in + [ void* swap typedef ] keep dup + ] keep + [ signal-ffi-effect "callback-effect" set-word-prop ] + [ drop current-lib get "callback-library" set-word-prop ] + [ signal-ffi-invoker (( quot -- alien )) define-inline ] 2tri ; + +: define-ffi-signals ( signals class -- ) + '[ _ define-ffi-signal ] define-each ; + +: const-value ( const -- value ) + [ value>> ] [ type>> name>> ] bi { + { "int" [ string>number ] } + { "double" [ string>number ] } + { "utf8" [ ] } + } case ; + +: define-ffi-enum ( enum -- word ) + [ + members>> [ + [ c-identifier>> create-in ] + [ value>> ] bi define-constant + ] each + ] [ c-type>> create-in [ int swap typedef ] keep ] bi ; + +: define-ffi-enums ( enums -- ) + [ define-ffi-enum ] define-each ; + +: define-ffi-bitfields ( bitfields -- ) + [ define-ffi-enum ] define-each ; + +: define-ffi-record ( record -- word ) + [ disguised?>> void* void ? ] + [ c-type>> create-in ] bi [ typedef ] keep ; + +: define-ffi-records ( records -- ) + [ define-ffi-record ] define-each ; + +: define-ffi-record-content ( record -- ) + { + [ constructors>> define-ffi-functions ] + [ functions>> define-ffi-functions ] + [ methods>> define-ffi-functions ] + } cleave ; + +: define-ffi-records-content ( records -- ) + [ define-ffi-record-content ] each ; + +: define-ffi-union ( union -- word ) + c-type>> create-in [ void* swap typedef ] keep ; + +: define-ffi-unions ( unions -- ) + [ define-ffi-union ] define-each ; + +: define-ffi-callback ( callback -- word ) + c-type>> create-in [ void* swap typedef ] keep ; + +: define-ffi-callbacks ( callbacks -- ) + [ define-ffi-callback ] define-each ; + +: define-ffi-interface ( interface -- word ) + c-type>> create-in [ void swap typedef ] keep ; + +: define-ffi-interfaces ( interfaces -- ) + [ define-ffi-interface ] define-each ; + +! Доделать +: define-ffi-interface-content ( interface -- ) + { + [ methods>> define-ffi-functions ] + } cleave ; + +: define-ffi-interfaces-content ( interfaces -- ) + [ define-ffi-interface-content ] each ; + +: get-type-invoker ( name -- quot ) + [ "GType" current-lib get ] dip + { } \ alien-invoke 5 narray >quotation ; + +: define-ffi-class ( class -- word ) + c-type>> create-in [ void swap typedef ] keep ; + +: define-ffi-classes ( class -- ) + [ define-ffi-class ] define-each ; + +: define-ffi-class-content ( class -- ) + { + [ constructors>> define-ffi-functions ] + [ functions>> define-ffi-functions ] + [ methods>> define-ffi-functions ] + [ [ signals>> ] keep define-ffi-signals ] + } cleave ; + +: define-ffi-classes-content ( class -- ) + [ define-ffi-class-content ] each ; + +: define-get-type ( node -- word ) + get-type>> dup { "intern" f } member? [ drop f ] + [ + [ create-in dup ] [ get-type-invoker ] bi + { } { "type" } define-declared + ] if ; + +: define-get-types ( namespace -- ) + { + [ enums>> [ define-get-type drop ] each ] + [ bitfields>> [ define-get-type drop ] each ] + [ records>> [ define-get-type drop ] each ] + [ unions>> [ define-get-type drop ] each ] + [ interfaces>> [ define-get-type drop ] each ] + [ classes>> [ define-get-type drop ] each ] + } cleave ; + +: define-ffi-const ( const -- word ) + [ name>> create-in dup ] [ const-value ] bi define-constant ; + +: define-ffi-consts ( consts -- ) + [ define-ffi-const ] define-each ; + +: define-ffi-alias ( alias -- ) + drop ; + +: define-ffi-aliases ( aliases -- ) + [ define-ffi-alias ] each ; + +: prepare-vocab ( repository -- ) + includes>> lib-aliases get '[ _ at ] map sift + [ ffi-vocab "." glue ] map + { "alien.c-types" } append + [ dup using-vocab? [ drop ] [ use-vocab ] if ] each ; + +: define-ffi-namespace ( namespace -- ) + { + [ aliases>> define-ffi-aliases ] + [ consts>> define-ffi-consts ] + [ enums>> define-ffi-enums ] + [ bitfields>> define-ffi-bitfields ] + [ records>> define-ffi-records ] + [ unions>> define-ffi-unions ] + [ interfaces>> define-ffi-interfaces ] + [ classes>> define-ffi-classes ] + [ callbacks>> define-ffi-callbacks ] + [ records>> define-ffi-records-content ] + [ classes>> define-ffi-classes-content ] + [ interfaces>> define-ffi-interfaces-content ] + [ functions>> define-ffi-functions ] + } cleave ; + +: define-ffi-repository ( repository -- ) + [ prepare-vocab ] + [ namespace>> define-ffi-namespace ] bi ; + diff --git a/basis/gir/gir.factor b/basis/gir/gir.factor new file mode 100755 index 0000000000..6483d18e35 --- /dev/null +++ b/basis/gir/gir.factor @@ -0,0 +1,24 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors assocs combinators gir.common gir.ffi gir.loader +kernel lexer locals namespaces sequences vocabs.parser xml ; +IN: gir + +: with-child-vocab ( name quot -- ) + swap current-vocab name>> + [ swap "." glue set-current-vocab call ] keep + set-current-vocab ; inline + +:: define-gir-vocab ( vocab-name file-name -- ) + file-name file>xml xml>repository + + vocab-name [ set-current-vocab ] [ current-lib set ] bi + { + [ + namespace>> name>> vocab-name swap + lib-aliases get set-at + ] + [ ffi-vocab [ define-ffi-repository ] with-child-vocab ] + } cleave ; + +SYNTAX: IN-GIR: scan scan define-gir-vocab ; diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor new file mode 100644 index 0000000000..410380e639 --- /dev/null +++ b/basis/gir/loader/loader.factor @@ -0,0 +1,245 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors ascii combinators fry gir.common gir.repository +gir.types kernel math math.parser sequences splitting xml.data +xml.traversal ; +FROM: namespaces => set get ; +IN: gir.loader + +: word-started? ( word letter -- ? ) + [ last letter? ] [ LETTER? ] bi* and ; + +: camel>factor ( name -- name' ) + dup 1 head + [ 2dup word-started? [ [ CHAR: - suffix ] dip ] when suffix ] + reduce rest >lower ; + +: underscored>factor ( name -- name' ) + [ [ CHAR: _ = not ] keep CHAR: - ? ] map >lower ; + +: full-type-name>type ( name -- type ) + [ type new ] dip + camel>factor "." split1 dup [ swap ] unless + [ get-lib-alias >>namespace ] [ >>name ] bi* absolute-type ; + +: node>type ( xml -- type ) + "name" attr full-type-name>type ; + +: xml>array-info ( xml -- array-info ) + [ array-info new ] dip { + [ "zero-terminated" attr [ "1" = ] [ t ] if* >>zero-terminated? ] + [ "length" attr [ string>number ] [ f ] if* >>length ] + [ "fixed-size" attr [ string>number ] [ f ] if* >>fixed-size ] + } cleave ; + +: xml>type ( xml -- array-info type ) + dup name>> main>> { + { "array" + [ + [ xml>array-info ] + [ first-child-tag node>type ] bi + ] + } + { "type" [ node>type f swap ] } + { "varargs" [ drop f f ] } + } case ; + +: load-parameter ( param xml -- param ) + [ "transfer-ownership" attr >>transfer-ownership ] + [ first-child-tag "type" attr >>c-type ] + [ + first-child-tag xml>type + [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* + ] tri ; + +: load-type ( type xml -- type ) + { + [ "name" attr camel>factor >>name ] + [ node>type >>type ] + [ "type" attr >>c-type ] + [ "type-name" attr >>type-name ] + [ "get-type" attr >>get-type ] + } cleave ; + +: xml>parameter ( xml -- parameter ) + [ parameter new ] dip { + [ "name" attr >>name ] + [ "direction" attr dup "in" ? >>direction ] + [ "allow-none" attr "1" = >>allow-none? ] + [ load-parameter ] + } cleave ; + +: xml>return ( xml -- return ) + [ return new ] dip { + [ drop "result" >>name ] + [ load-parameter ] + } cleave ; + +: load-parameters ( xml callable -- callable ) + [ + "parameters" tag-named "parameter" tags-named + [ xml>parameter ] map + dup { f } tail? [ but-last [ t >>varargs? ] dip ] when + >>parameters + ] + [ "return-value" tag-named xml>return >>return ] bi ; + +: xml>function ( xml -- function ) + [ function new ] dip { + [ "name" attr underscored>factor >>name ] + [ "identifier" attr >>identifier ] + [ load-parameters ] + } cleave ; + +: (type>param) ( type -- param ) + [ parameter new ] dip + [ c-type>> CHAR: * suffix >>c-type ] [ type>> >>type ] bi + "none" >>transfer-ownership + "in" >>direction ; + +: type>self-param ( type -- self ) + (type>param) "self" >>name ; + +: type>sender-param ( type -- sender ) + (type>param) "sender" >>name ; + +: signal-data-param ( -- param ) + parameter new + "user_data" >>name + "gpointer" >>c-type + type new "any" >>name >>type + "none" >>transfer-ownership + "in" >>direction ; + +: xml>property ( xml -- property ) + [ property new ] dip { + [ "name" attr >>name ] + [ "writable" attr "1" = >>writable? ] + [ "readable" attr "0" = not >>readable? ] + [ "construct" attr "1" = >>construct? ] + [ "construct-only" attr "1" = >>construct-only? ] + [ first-child-tag xml>type nip >>type ] + } cleave ; + +: xml>callback ( xml -- callback ) + [ callback new ] dip { + [ load-type ] + [ load-parameters ] + } cleave ; + +: xml>signal ( xml -- signal ) + [ signal new ] dip { + [ "name" attr camel>factor >>name ] + [ node>type >>type ] + [ "type" attr >>c-type ] + [ + load-parameters + [ signal-data-param suffix ] change-parameters + ] + } cleave ; + +: load-functions ( xml tag-name -- functions ) + tags-named [ xml>function ] map ; + +: xml>class ( xml -- class ) + [ class new ] dip { + [ load-type ] + [ "abstract" attr "1" = >>abstract? ] + [ + "parent" attr [ full-type-name>type ] [ f ] if* + >>parent + ] + [ "type-struct" attr >>type-struct ] + [ "constructor" load-functions >>constructors ] + [ "function" load-functions >>functions ] + [ + "method" load-functions over type>self-param + '[ [ _ prefix ] change-parameters ] map + >>methods + ] + [ + "signal" tags-named [ xml>signal ] map + over type>sender-param + '[ [ _ prefix ] change-parameters ] map + >>signals + ] + } cleave ; + +: xml>interface ( xml -- interface ) + [ interface new ] dip { + [ load-type ] + [ + "method" load-functions over type>self-param + '[ [ _ prefix ] change-parameters ] map + >>methods + ] + } cleave ; + +: xml>member ( xml -- member ) + [ enum-member new ] dip { + [ "name" attr underscored>factor >>name ] + [ "identifier" attr >>c-identifier ] + [ "value" attr string>number >>value ] + } cleave ; + +: xml>enum ( xml -- enum ) + [ enum new ] dip { + [ load-type ] + [ "member" tags-named [ xml>member ] map >>members ] + } cleave ; + +: xml>record ( xml -- record ) + [ record new ] dip { + [ load-type ] + [ "disguised" attr "1" = >>disguised? ] + [ "constructor" load-functions >>constructors ] + [ "function" load-functions >>functions ] + [ + "method" load-functions over type>self-param + '[ [ _ prefix ] change-parameters ] map + >>methods + ] + } cleave ; + +: xml>union ( xml -- union ) + [ union new ] dip load-type ; + +: xml>alias ( xml -- alias ) + [ alias new ] dip { + [ node>type >>name ] + [ "target" attr full-type-name>type >>target ] + } cleave ; + +: xml>const ( xml -- const ) + [ const new ] dip { + [ "name" attr >>name ] + [ "value" attr >>value ] + [ first-child-tag "type" attr >>c-type ] + [ first-child-tag xml>type nip >>type ] + } cleave ; + +: xml>namespace ( xml -- namespace ) + [ namespace new ] dip { + [ "name" attr camel>factor dup current-lib set >>name ] + [ "alias" tags-named [ xml>alias ] map >>aliases ] + [ "record" tags-named [ xml>record ] map >>records ] + [ "union" tags-named [ xml>union ] map >>unions ] + [ "callback" tags-named [ xml>callback ] map >>callbacks ] + [ "interface" tags-named [ xml>interface ] map >>interfaces ] + [ "class" tags-named [ xml>class ] map >>classes ] + [ "constant" tags-named [ xml>const ] map >>consts ] + [ "enumeration" tags-named [ xml>enum ] map >>enums ] + [ "bitfield" tags-named [ xml>enum ] map >>bitfields ] + [ "function" load-functions >>functions + ] + } cleave ; + +: xml>repository ( xml -- repository ) + [ repository new ] dip { + [ + "" "include" f tags-named + [ "name" attr camel>factor ] map >>includes + ] + [ "namespace" tag-named xml>namespace >>namespace ] + } cleave ; + diff --git a/basis/gir/repository/repository.factor b/basis/gir/repository/repository.factor new file mode 100644 index 0000000000..5a067850fc --- /dev/null +++ b/basis/gir/repository/repository.factor @@ -0,0 +1,60 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: ; +IN: gir.repository + +TUPLE: node name ; + +TUPLE: repository includes namespace ; + +TUPLE: namespace < node + aliases consts classes interfaces records unions callbacks + enums bitfields functions ; + +TUPLE: alias < node target ; + +TUPLE: typed < node type c-type ; + +TUPLE: const < typed value ffi ; + +TUPLE: type-node < node + type c-type type-name get-type ffi ; + +TUPLE: record < type-node + constructors methods functions disguised? ; + +TUPLE: union < type-node ; + +TUPLE: class < record + abstract? parent type-struct signals ; + +TUPLE: interface < type-node + methods ; + +TUPLE: property < type-node + readable? writable? construct? construct-only? ; + +TUPLE: callable < type-node + return parameters varargs? ; + +TUPLE: function < callable identifier ; + +TUPLE: callback < type-node return parameters varargs? ; + +TUPLE: signal < callback ; + +TUPLE: parameter < typed + direction allow-none? length? transfer-ownership array-info + local ; + +TUPLE: return < typed + transfer-ownership array-info local ; + +TUPLE: type name namespace ; + +TUPLE: array-info zero-terminated? fixed-size length ; + +TUPLE: enum-member < node value c-identifier ; + +TUPLE: enum < type-node members ; + diff --git a/basis/gir/types/types.factor b/basis/gir/types/types.factor new file mode 100644 index 0000000000..2cf0006c9d --- /dev/null +++ b/basis/gir/types/types.factor @@ -0,0 +1,135 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien alien.c-types assocs combinators.short-circuit +gir.common gir.repository kernel namespaces specialized-arrays ; +IN: gir.types + +TUPLE: gwrapper { underlying alien } ; +TUPLE: grecord < gwrapper ; +TUPLE: gobject < gwrapper ; + +SPECIALIZED-ARRAYS: + void* bool int uint char uchar short ushort long ulong + longlong ulonglong float double ; + +CONSTANT: simple-types H{ + { "any" { + void* *void* >void*-array + } } + { "boolean" { + bool *bool >bool-array + } } + { "int" { + int *int >int-array + } } + { "uint" { + uint *uint >uint-array + } } + { "int8" { + char *char >char-array + } } + { "uint8" { + uchar *uchar >uchar-array + } } + { "int16" { + short *short >short-array + } } + { "uint16" { + ushort *ushort >ushort-array + } } + { "int32" { + int *int >int-array + } } + { "uint32" { + uint *uint >uint-array + } } + { "int64" { + longlong *longlong + >longlong-array + } } + { "uint64" { + ulonglong *ulonglong + >ulonglong-array + } } + { "long" { + long *long >long-array + } } + { "ulong" { + ulong *ulong >ulong-array + } } + { "float" { + float *float >float-array + } } + { "double" { + double *double >double-array + } } + { "size_t" { + ulong *ulong >ulong-array + } } + { "ssize_t" { + long *long >long-array + } } + { "time_t" { + long *long >long-array + } } + { "gtype" { + ulong *ulong >ulong-array + } } +} + +TUPLE: type-info c-type-word type-word ; + +TUPLE: enum-info < type-info ; + +TUPLE: bitfield-info < type-info ; + +TUPLE: record-info < type-info ; + +TUPLE: union-info < type-info ; + +TUPLE: callback-info < type-info ; + +TUPLE: class-info < type-info ; + +TUPLE: interface-info < type-info ; + +: aliased-type ( alias -- type ) + aliases get ?at [ aliased-type ] when ; + +: get-type-info ( type -- info ) + aliased-type type-infos get at ; + +PREDICATE: none-type < type + [ namespace>> not ] [ name>> "none" = ] bi and ; + +PREDICATE: simple-type < type + aliased-type + [ namespace>> not ] [ name>> simple-types key? ] bi and ; + +PREDICATE: utf8-type < type + aliased-type + [ namespace>> not ] [ name>> "utf8" = ] bi and ; + +PREDICATE: any-type < type + aliased-type + [ namespace>> not ] [ name>> "any" = ] bi and ; + +PREDICATE: enum-type < type get-type-info enum-info? ; + +PREDICATE: bitfield-type < type get-type-info bitfield-info? ; + +PREDICATE: record-type < type get-type-info record-info? ; + +PREDICATE: union-type < type get-type-info union-info? ; + +PREDICATE: callback-type < type get-type-info callback-info? ; + +PREDICATE: class-type < type get-type-info class-info? ; + +PREDICATE: interface-type < type get-type-info interface-info? ; + +: absolute-type ( type -- type' ) + dup { + [ namespace>> ] [ simple-type? ] + [ utf8-type? ] [ none-type? ] + } 1|| [ current-lib get >>namespace ] unless ; diff --git a/basis/glib/GLib-2.0.gir b/basis/glib/GLib-2.0.gir new file mode 100644 index 0000000000..dec330b8c8 --- /dev/null +++ b/basis/glib/GLib-2.0.gir @@ -0,0 +1,20295 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gmodule/GModule-2.0.gir b/basis/gmodule/GModule-2.0.gir new file mode 100644 index 0000000000..27a64f081b --- /dev/null +++ b/basis/gmodule/GModule-2.0.gir @@ -0,0 +1,108 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gmodule/authors.txt b/basis/gmodule/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gmodule/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gmodule/gmodule.factor b/basis/gmodule/gmodule.factor new file mode 100644 index 0000000000..a33150cc2f --- /dev/null +++ b/basis/gmodule/gmodule.factor @@ -0,0 +1,6 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gir glib ; + +IN-GIR: gmodule vocab:gmodule/GModule-2.0.gir + diff --git a/basis/gobject/GObject-2.0.gir b/basis/gobject/GObject-2.0.gir new file mode 100644 index 0000000000..8534b3a39c --- /dev/null +++ b/basis/gobject/GObject-2.0.gir @@ -0,0 +1,6231 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gobject/authors.txt b/basis/gobject/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gobject/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gobject/gobject.factor b/basis/gobject/gobject.factor new file mode 100644 index 0000000000..d9135119ad --- /dev/null +++ b/basis/gobject/gobject.factor @@ -0,0 +1,50 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax alien.c-types alien.destructors +alien.libraries combinators kernel literals math system +gir glib glib.ffi ; + +IN: gobject.ffi + +TYPEDEF: void* GSignalCMarshaller +TYPEDEF: void GStrv +! есть alias +TYPEDEF: gchar* gchararray + +IN-GIR: gobject vocab:gobject/GObject-2.0.gir + +IN: gobject.ffi + +FORGET: GIOCondition + +FUNCTION: void g_object_unref ( GObject* self ) ; + +DESTRUCTOR: g_object_unref + +! Исправление неправильного типа параметра для GtkWidget-child-notify +! (разобраться) +TYPEDEF: GParamSpec GParam + +<< CONSTANT: G_TYPE_FUNDAMENTAL_SHIFT 2 >> +CONSTANT: G_TYPE_INVALID $[ 0 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_NONE $[ 1 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_INTERFACE $[ 2 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_CHAR $[ 3 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_UCHAR $[ 4 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_BOOLEAN $[ 5 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_INT $[ 6 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_UINT $[ 7 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_LONG $[ 8 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_ULONG $[ 9 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_INT64 $[ 10 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_UINT64 $[ 11 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_ENUM $[ 12 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_FLAGS $[ 13 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_FLOAT $[ 14 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_DOUBLE $[ 15 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_STRING $[ 16 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_POINTER $[ 17 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_BOXED $[ 18 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_PARAM $[ 19 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_OBJECT $[ 20 G_TYPE_FUNDAMENTAL_SHIFT shift ] + diff --git a/basis/gst/Gst-0.10.gir b/basis/gst/Gst-0.10.gir new file mode 100644 index 0000000000..d187fe1341 --- /dev/null +++ b/basis/gst/Gst-0.10.gir @@ -0,0 +1,22063 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gst/authors.txt b/basis/gst/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gst/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gst/gst.factor b/basis/gst/gst.factor new file mode 100644 index 0000000000..a386e7d4b8 --- /dev/null +++ b/basis/gst/gst.factor @@ -0,0 +1,27 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax alien.libraries combinators +kernel system +gir glib glib.ffi gobject gmodule ; + +<< +"gst" { + { [ os winnt? ] [ "" "cdecl" add-library ] } + { [ os macosx? ] [ "" "cdecl" add-library ] } + { [ os unix? ] [ "libgstreamer-0.10.so" "cdecl" add-library ] } +} cond +>> + +IN: gst.ffi + +TYPEDEF: gpointer GstClockID +TYPEDEF: guint64 GstClockTime +TYPEDEF: gint64 GstClockTimeDiff + +! Временное исправление отсутвующих типов libxml2 +TYPEDEF: void* xmlNodePtr +TYPEDEF: void* xmlDocPtr +TYPEDEF: void* xmlNsPtr + +IN-GIR: gst vocab:gst/Gst-0.10.gir + diff --git a/basis/gtk/Gtk-2.0.gir b/basis/gtk/Gtk-2.0.gir new file mode 100644 index 0000000000..9eeb927e85 --- /dev/null +++ b/basis/gtk/Gtk-2.0.gir @@ -0,0 +1,88485 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gtk/authors.txt b/basis/gtk/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gtk/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gtk/gl/GtkGL-1.0.gir b/basis/gtk/gl/GtkGL-1.0.gir new file mode 100644 index 0000000000..a2d54ffdeb --- /dev/null +++ b/basis/gtk/gl/GtkGL-1.0.gir @@ -0,0 +1,173 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gtk/gl/authors.txt b/basis/gtk/gl/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/gtk/gl/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/gtk/gl/gl.factor b/basis/gtk/gl/gl.factor new file mode 100644 index 0000000000..53569b6c62 --- /dev/null +++ b/basis/gtk/gl/gl.factor @@ -0,0 +1,15 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax alien.libraries combinators kernel system +gir glib gobject gio gmodule gdk.pixbuf gdk gdk.gl gtk gtk.ffi ; + +<< +"gtk.gl" { + { [ os winnt? ] [ "" "cdecl" add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgtkglext-x11-1.0.so" "cdecl" add-library ] } +} cond +>> + +IN-GIR: gtk.gl vocab:gtk/gl/GtkGL-1.0.gir + diff --git a/basis/gtk/gtk.factor b/basis/gtk/gtk.factor new file mode 100644 index 0000000000..1882eb8ac6 --- /dev/null +++ b/basis/gtk/gtk.factor @@ -0,0 +1,23 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.syntax alien.libraries cairo.ffi combinators +kernel system +gir glib glib.ffi gobject gio gmodule gdk.pixbuf gdk atk ; + +<< +"gtk" { + { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" "cdecl" add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgtk-x11-2.0.so" "cdecl" add-library ] } +} cond +>> + +IN: gtk.ffi + +TYPEDEF: void GtkAllocation +TYPEDEF: void GtkEnumValue +TYPEDEF: void GtkFlagValue +TYPEDEF: GType GtkType + +IN-GIR: gtk vocab:gtk/Gtk-2.0.gir + diff --git a/basis/pango/Pango-1.0.gir b/basis/pango/Pango-1.0.gir new file mode 100644 index 0000000000..06ce0e31f0 --- /dev/null +++ b/basis/pango/Pango-1.0.gir @@ -0,0 +1,7445 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/pango/authors.txt b/basis/pango/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/basis/pango/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/basis/pango/cairo/PangoCairo-1.0.gir b/basis/pango/cairo/PangoCairo-1.0.gir new file mode 100644 index 0000000000..13d9e9d924 --- /dev/null +++ b/basis/pango/cairo/PangoCairo-1.0.gir @@ -0,0 +1,203 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/extra/gir/samples/lowlevel/authors.txt b/extra/gir/samples/lowlevel/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/extra/gir/samples/lowlevel/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/extra/gir/samples/lowlevel/gstreamer/authors.txt b/extra/gir/samples/lowlevel/gstreamer/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/extra/gir/samples/lowlevel/gstreamer/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor new file mode 100644 index 0000000000..c8a2c4e620 --- /dev/null +++ b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor @@ -0,0 +1,63 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.c-types alien.strings fry byte-arrays +io.encodings.utf8 kernel locals math prettyprint +gst gst.ffi glib.ffi gobject.ffi gtk gtk.ffi ; +IN: gir.samples.lowlevel.gstreamer + +! CONSTANT: uri "http://www.xiph.org/vorbis/listen/compilation-ogg-q4.ogg" +CONSTANT: uri "http://tinyvid.tv/file/3gocxnjott7wr.ogg" + +:: gstreamer-win ( -- window ) + f f gst_init + "playbin" "player" [ utf8 string>alien ] bi@ gst_element_factory_make :> pipeline + + GType gint64 [ heap-size ] bi@ 2 * + :> value + value G_TYPE_STRING g_value_init drop + value uri utf8 string>alien g_value_set_string + + pipeline "uri" utf8 string>alien value g_object_set_property + + ! pipeline GST_STATE_PLAYING gst_element_set_state drop + + GTK_WINDOW_TOPLEVEL gtk_window_new :> window + + window + [ "GStreamer" utf8 string>alien gtk_window_set_title ] + [ 300 200 gtk_window_set_default_size ] + [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri + + gtk_fixed_new :> frame + window frame gtk_container_add + + "Start" utf8 string>alien gtk_button_new_with_label :> button + button 140 30 gtk_widget_set_size_request + frame button 80 60 gtk_fixed_put + + button "clicked" utf8 string>alien + [ nip GST_STATE_PLAYING gst_element_set_state drop ] GtkButton:clicked + pipeline f 0 g_signal_connect_data drop + + window "destroy" utf8 string>alien + [ + nip [ GST_STATE_NULL gst_element_set_state drop ] + [ gst_object_unref ] bi + ] GtkObject:destroy + pipeline f 0 g_signal_connect_data drop + + window ; + +:: gstreamer-main ( -- ) + f f gtk_init + gstreamer-win :> window + + window "destroy" utf8 string>alien + [ 2drop gtk_main_quit ] GtkObject:destroy + f f 0 g_signal_connect_data drop + + window gtk_widget_show_all + + gtk_main ; + +MAIN: gstreamer-main + diff --git a/extra/gir/samples/lowlevel/hello-world/authors.txt b/extra/gir/samples/lowlevel/hello-world/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/extra/gir/samples/lowlevel/hello-world/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/extra/gir/samples/lowlevel/hello-world/hello-world.factor b/extra/gir/samples/lowlevel/hello-world/hello-world.factor new file mode 100644 index 0000000000..6f832167fe --- /dev/null +++ b/extra/gir/samples/lowlevel/hello-world/hello-world.factor @@ -0,0 +1,44 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.strings gtk gobject.ffi gtk.ffi io.encodings.utf8 +kernel locals ; +IN: gir.samples.lowlevel.hello-world + +:: hello-world-win ( -- window ) + GTK_WINDOW_TOPLEVEL gtk_window_new :> window + + window + [ "Hello world!" utf8 string>alien gtk_window_set_title ] + [ 300 200 gtk_window_set_default_size ] + [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri + + gtk_fixed_new :> frame + window frame gtk_container_add + + "Say 'Hello!'" utf8 string>alien gtk_button_new_with_label :> button + button 140 30 gtk_widget_set_size_request + frame button 80 60 gtk_fixed_put + + "" utf8 string>alien gtk_label_new :> label + frame label 120 110 gtk_fixed_put + + button "clicked" utf8 string>alien + [ nip "Hello! :)" utf8 string>alien gtk_label_set_text 1 ] GtkButton:clicked + label f 0 g_signal_connect_data drop + + window ; + +:: hello-world-main ( -- ) + f f gtk_init + hello-world-win :> window + + window "destroy" utf8 string>alien + [ 2drop gtk_main_quit ] GtkObject:destroy + f f 0 g_signal_connect_data drop + + window gtk_widget_show_all + + gtk_main ; + +MAIN: hello-world-main + diff --git a/extra/gir/samples/lowlevel/lowlevel.factor b/extra/gir/samples/lowlevel/lowlevel.factor new file mode 100644 index 0000000000..98b8a1ceb6 --- /dev/null +++ b/extra/gir/samples/lowlevel/lowlevel.factor @@ -0,0 +1,81 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.c-types alien.strings byte-arrays +gtk glib.ffi gobject.ffi gtk.ffi io.encodings.utf8 kernel +literals locals make math prettyprint sequences specialized-arrays +gir.samples.lowlevel.hello-world +gir.samples.lowlevel.opengl +gir.samples.lowlevel.gstreamer ; +IN: gir.samples.lowlevel + +SPECIALIZED-ARRAY: ulong + +CONSTANT: samples { + { "hello-world" "Simple 'Hello world!' program" [ hello-world-win ] } + { "opengl" "GtkGLExt sample program" [ opengl-win ] } + { "gstreamer" "Small GStreamer-based multimedia player " [ gstreamer-win ] } +} + +:: list-on-row-activited ( sender path column user_data -- ) + path gtk_tree_path_get_indices *int samples nth last + call( -- win ) gtk_widget_show_all ; + +:: main ( -- ) + f f gtk_init + + GTK_WINDOW_TOPLEVEL gtk_window_new :> window + + window + [ "Low-level Gtk samples" utf8 string>alien gtk_window_set_title ] + [ 300 400 gtk_window_set_default_size ] + [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri + + gtk_tree_view_new :> list + list 0 gtk_tree_view_set_headers_visible + + gtk_cell_renderer_text_new :> renderer + gtk_tree_view_column_new :> column + column "Sample" utf8 string>alien gtk_tree_view_column_set_title + column renderer 1 gtk_tree_view_column_pack_start + column renderer "markup" utf8 string>alien 0 gtk_tree_view_column_add_attribute + list column gtk_tree_view_append_column drop + + ulong-array{ $ G_TYPE_STRING } + [ length ] keep gtk_list_store_newv :> store + + list store gtk_tree_view_set_model + + store g_object_unref + + ! Временный фикс, нужно придумать что-то другое, так как нет + ! конструктора для создания GtkTreeIter + gint gpointer [ heap-size ] bi@ 3 * + :> iter + + GType gint64 [ heap-size ] bi@ 2 * + :> value + value G_TYPE_STRING g_value_init drop + samples [ + first2 swap [ "" % % "\n" % % ] "" make + value swap utf8 string>alien g_value_set_string + store iter gtk_list_store_append + store iter 0 value gtk_list_store_set_value + ] each + + list 300 300 gtk_widget_set_size_request + + window list gtk_container_add + + list "row-activated" + utf8 string>alien + [ list-on-row-activited ] GtkTreeView:row-activated dup . + f f 0 g_signal_connect_data . + + window "destroy" utf8 string>alien + [ 2drop gtk_main_quit ] GtkObject:destroy + f f 0 g_signal_connect_data drop + + window gtk_widget_show_all + + gtk_main ; + +MAIN: main + diff --git a/extra/gir/samples/lowlevel/opengl/authors.txt b/extra/gir/samples/lowlevel/opengl/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/extra/gir/samples/lowlevel/opengl/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gir/samples/lowlevel/opengl/opengl.factor new file mode 100644 index 0000000000..d4cbbc5f12 --- /dev/null +++ b/extra/gir/samples/lowlevel/opengl/opengl.factor @@ -0,0 +1,93 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.strings gtk gobject.ffi gtk.ffi gdk.gl gtk.gl gdk.gl.ffi +gtk.gl.ffi io.encodings.utf8 kernel locals math opengl.gl prettyprint ; +IN: gir.samples.lowlevel.opengl + +! Sample based on +! http://code.valaide.org/content/simple-opengl-sample-using-gtkglext + +:: on-configure ( sender event user-data -- result ) + sender gtk_widget_get_gl_context :> gl-context + sender gtk_widget_get_gl_window :> gl-drawable + + gl-drawable gl-context gdk_gl_drawable_gl_begin 1 = + [ + 0 0 200 200 glViewport + gl-drawable gdk_gl_drawable_gl_end + 1 + ] + [ 0 ] if ; + +:: on-expose ( sender event user-data -- result ) + sender gtk_widget_get_gl_context :> gl-context + sender gtk_widget_get_gl_window :> gl-drawable + + gl-drawable gl-context gdk_gl_drawable_gl_begin 1 = + [ + GL_COLOR_BUFFER_BIT glClear + + GL_TRIANGLES glBegin + 1.0 0.0 0.0 glColor3f + 0 1 glVertex2i + 0.0 1.0 0.0 glColor3f + -1 -1 glVertex2i + 0.0 0.0 1.0 glColor3f + 1 -1 glVertex2i + glEnd + + gl-drawable gdk_gl_drawable_is_double_buffered 1 = + [ gl-drawable gdk_gl_drawable_swap_buffers ] + [ glFlush ] if + + gl-drawable gdk_gl_drawable_gl_end + 1 + ] + [ 0 ] if ; + +:: opengl-win ( -- window ) + GTK_WINDOW_TOPLEVEL gtk_window_new :> window + + window + [ "OpenGL" utf8 string>alien gtk_window_set_title ] + [ 200 200 gtk_window_set_default_size ] + [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri + + window 1 gtk_container_set_reallocate_redraws + + GDK_GL_MODE_RGBA GDK_GL_MODE_DOUBLE bitor + gdk_gl_config_new_by_mode :> gl-config + + gtk_drawing_area_new :> drawing-area + drawing-area 200 200 gtk_widget_set_size_request + + drawing-area gl-config f 1 GDK_GL_RGBA_TYPE + gtk_widget_set_gl_capability . + + drawing-area "configure-event" utf8 string>alien + [ on-configure ] GtkWidget:configure-event + f f 0 g_signal_connect_data drop + + drawing-area "expose-event" utf8 string>alien + [ on-expose ] GtkWidget:expose-event + f f 0 g_signal_connect_data drop + + window drawing-area gtk_container_add + + window ; + +:: opengl-main ( -- ) + f f gtk_init + f f gtk_gl_init + opengl-win :> window + + window "destroy" utf8 string>alien + [ 2drop gtk_main_quit ] GtkObject:destroy + f f 0 g_signal_connect_data drop + + window gtk_widget_show_all + + gtk_main ; + +MAIN: opengl-main + From 56280003c50430941fe832a7259172c08a624313 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 9 May 2010 23:25:47 +0600 Subject: [PATCH 02/76] pango is gir-based now (very draft version) --- basis/glib/authors.txt | 3 +- basis/glib/glib.factor | 78 +++++++++++----- basis/glib/summary.txt | 1 - basis/glib/tags.txt | 1 - basis/pango/cairo/authors.txt | 3 +- basis/pango/cairo/cairo.factor | 103 +++++---------------- basis/pango/fonts/authors.txt | 2 - basis/pango/fonts/fonts.factor | 113 ----------------------- basis/pango/fonts/tags.txt | 1 - basis/pango/layouts/layouts-tests.factor | 11 --- basis/pango/layouts/layouts.factor | 66 ------------- basis/pango/pango.factor | 71 +++++++++----- basis/ui/text/pango/pango.factor | 6 +- 13 files changed, 128 insertions(+), 331 deletions(-) delete mode 100644 basis/glib/summary.txt delete mode 100644 basis/glib/tags.txt delete mode 100644 basis/pango/fonts/authors.txt delete mode 100644 basis/pango/fonts/fonts.factor delete mode 100644 basis/pango/fonts/tags.txt delete mode 100644 basis/pango/layouts/layouts-tests.factor delete mode 100644 basis/pango/layouts/layouts.factor diff --git a/basis/glib/authors.txt b/basis/glib/authors.txt index 367ba74d80..ce9bcc8313 100644 --- a/basis/glib/authors.txt +++ b/basis/glib/authors.txt @@ -1,2 +1 @@ -Matthew Willis -Slava Pestov +Anton Gorenko \ No newline at end of file diff --git a/basis/glib/glib.factor b/basis/glib/glib.factor index 7447f24151..e8aa1688df 100644 --- a/basis/glib/glib.factor +++ b/basis/glib/glib.factor @@ -1,36 +1,64 @@ -! Copyright (C) 2008 Matthew Willis. -! Copyright (C) 2009 Slava Pestov. -! See http://factorcode.org/license.txt for BSD license -USING: alien alien.c-types alien.syntax alien.destructors -combinators system alien.libraries ; -IN: glib +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien.c-types alien.libraries alien.syntax combinators gir +kernel system vocabs.parser words ; << - -{ - { [ os winnt? ] [ "glib" "libglib-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "glib" "/opt/local/lib/libglib-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ ] } +"glib" { + { [ os winnt? ] [ "libglib-2.0-0.dll" "cdecl" add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" "cdecl" add-library ] } + { [ os unix? ] [ drop ] } } cond - -{ - { [ os winnt? ] [ "gobject" "libgobject-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "gobject" "/opt/local/lib/libgobject-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ ] } -} cond - >> -LIBRARY: glib +IN: glib.ffi + +<< double "long double" current-vocab create typedef >> + +TYPEDEF: char gchar +TYPEDEF: uchar guchar +TYPEDEF: short gshort +TYPEDEF: ushort gushort +TYPEDEF: long glong +TYPEDEF: ulong gulong +TYPEDEF: int gint +TYPEDEF: uint guint +TYPEDEF: gint gboolean + +TYPEDEF: char gint8 +TYPEDEF: uchar guint8 +TYPEDEF: short gint16 +TYPEDEF: ushort guint16 +TYPEDEF: int gint32 +TYPEDEF: uint guint32 +TYPEDEF: longlong gint64 +TYPEDEF: ulonglong guint64 + +TYPEDEF: float gfloat +TYPEDEF: double gdouble + +TYPEDEF: long ssize_t +TYPEDEF: long time_t +TYPEDEF: size_t gsize +TYPEDEF: ssize_t gssize +TYPEDEF: size_t GType TYPEDEF: void* gpointer -TYPEDEF: int gint -TYPEDEF: bool gboolean +TYPEDEF: void* gconstpointer -FUNCTION: void g_free ( gpointer mem ) ; +TYPEDEF: guint8 GDateDay +TYPEDEF: guint16 GDateYear +TYPEDEF: gint GPid +TYPEDEF: guint32 GQuark +TYPEDEF: gint32 GTime +TYPEDEF: glong gintptr +TYPEDEF: gint64 goffset +TYPEDEF: gulong guintptr +TYPEDEF: guint32 gunichar +TYPEDEF: guint16 gunichar2 -LIBRARY: gobject +! Разобраться, почему в .gir есть такие типы +TYPEDEF: void any -FUNCTION: void g_object_unref ( gpointer object ) ; +IN-GIR: glib vocab:glib/GLib-2.0.gir -DESTRUCTOR: g_object_unref diff --git a/basis/glib/summary.txt b/basis/glib/summary.txt deleted file mode 100644 index a4b5d805a4..0000000000 --- a/basis/glib/summary.txt +++ /dev/null @@ -1 +0,0 @@ -Binding for GLib diff --git a/basis/glib/tags.txt b/basis/glib/tags.txt deleted file mode 100644 index bb863cf9a0..0000000000 --- a/basis/glib/tags.txt +++ /dev/null @@ -1 +0,0 @@ -bindings diff --git a/basis/pango/cairo/authors.txt b/basis/pango/cairo/authors.txt index 367ba74d80..ce9bcc8313 100644 --- a/basis/pango/cairo/authors.txt +++ b/basis/pango/cairo/authors.txt @@ -1,2 +1 @@ -Matthew Willis -Slava Pestov +Anton Gorenko \ No newline at end of file diff --git a/basis/pango/cairo/cairo.factor b/basis/pango/cairo/cairo.factor index 85d4cef424..db86f6504c 100644 --- a/basis/pango/cairo/cairo.factor +++ b/basis/pango/cairo/cairo.factor @@ -1,99 +1,37 @@ -! Copyright (C) 2008 Matthew Willis. -! Copyright (C) 2009 Slava Pestov. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -! -! pangocairo bindings, from pango/pangocairo.h -USING: arrays sequences alien alien.c-types alien.destructors -alien.libraries alien.syntax math math.functions math.vectors -destructors combinators colors fonts accessors assocs namespaces -kernel pango pango.fonts pango.layouts glib unicode.data images +USING: alien alien.c-types alien.destructors +alien.libraries alien.syntax alien.strings arrays math math.functions +math.vectors destructors combinators colors fonts accessors assocs +namespaces kernel unicode.data images sequences cache init system math.rectangles fry memoize io.encodings.utf8 -classes.struct cairo cairo.ffi ; -IN: pango.cairo +classes.struct cairo cairo.ffi +gir pango pango.ffi gobject gobject.ffi ; -<< { - { [ os winnt? ] [ "pangocairo" "libpangocairo-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "pangocairo" "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ ] } -} cond >> +<< +"pango.cairo" { + { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ drop ] } +} cond +>> -LIBRARY: pangocairo +IN-GIR: pango.cairo vocab:pango/cairo/PangoCairo-1.0.gir -C-TYPE: PangoCairoFontMap -C-TYPE: PangoCairoFont -FUNCTION: PangoFontMap* -pango_cairo_font_map_new ( ) ; -FUNCTION: PangoFontMap* -pango_cairo_font_map_new_for_font_type ( cairo_font_type_t fonttype ) ; - -FUNCTION: PangoFontMap* -pango_cairo_font_map_get_default ( ) ; - -FUNCTION: cairo_font_type_t -pango_cairo_font_map_get_font_type ( PangoCairoFontMap* fontmap ) ; - -FUNCTION: void -pango_cairo_font_map_set_resolution ( PangoCairoFontMap* fontmap, double dpi ) ; - -FUNCTION: double -pango_cairo_font_map_get_resolution ( PangoCairoFontMap* fontmap ) ; - -FUNCTION: PangoContext* -pango_cairo_font_map_create_context ( PangoCairoFontMap* fontmap ) ; - -FUNCTION: cairo_scaled_font_t* -pango_cairo_font_get_scaled_font ( PangoCairoFont* font ) ; - -! Update a Pango context for the current state of a cairo context -FUNCTION: void -pango_cairo_update_context ( cairo_t* cr, PangoContext* context ) ; - -FUNCTION: void -pango_cairo_context_set_font_options ( PangoContext* context, cairo_font_options_t* options ) ; - -FUNCTION: cairo_font_options_t* -pango_cairo_context_get_font_options ( PangoContext* context ) ; - -FUNCTION: void -pango_cairo_context_set_resolution ( PangoContext* context, double dpi ) ; - -FUNCTION: double -pango_cairo_context_get_resolution ( PangoContext* context ) ; - -! Convenience -FUNCTION: PangoLayout* -pango_cairo_create_layout ( cairo_t* cr ) ; +IN: pango.cairo.ffi FUNCTION: void pango_cairo_update_layout ( cairo_t* cr, PangoLayout* layout ) ; -! Rendering -FUNCTION: void -pango_cairo_show_glyph_string ( cairo_t* cr, PangoFont* font, PangoGlyphString* glyphs ) ; - -FUNCTION: void -pango_cairo_show_layout_line ( cairo_t* cr, PangoLayoutLine* line ) ; - FUNCTION: void pango_cairo_show_layout ( cairo_t* cr, PangoLayout* layout ) ; -FUNCTION: void -pango_cairo_show_error_underline ( cairo_t* cr, double x, double y, double width, double height ) ; +FUNCTION: PangoLayout* +pango_cairo_create_layout ( cairo_t* cr ) ; -! Rendering to a path -FUNCTION: void -pango_cairo_glyph_string_path ( cairo_t* cr, PangoFont* font, PangoGlyphString* glyphs ) ; - -FUNCTION: void -pango_cairo_layout_line_path ( cairo_t* cr, PangoLayoutLine* line ) ; - -FUNCTION: void -pango_cairo_layout_path ( cairo_t* cr, PangoLayout* layout ) ; - -FUNCTION: void -pango_cairo_error_underline_path ( cairo_t* cr, double x, double y, double width, double height ) ; +IN: pango.cairo TUPLE: layout < disposable font string selection layout metrics ink-rect logical-rect image ; @@ -107,7 +45,7 @@ SYMBOL: dpi : set-layout-text ( str layout -- ) #! Replace nulls with something else since Pango uses null-terminated #! strings - swap -1 pango_layout_set_text ; + swap utf8 string>alien -1 pango_layout_set_text ; : layout-extents ( layout -- ink-rect logical-rect ) PangoRectangle @@ -241,3 +179,4 @@ SYMBOL: cached-layouts cached-layout layout>> first-line ; [ cached-layouts set-global ] "pango.cairo" add-startup-hook + diff --git a/basis/pango/fonts/authors.txt b/basis/pango/fonts/authors.txt deleted file mode 100644 index 367ba74d80..0000000000 --- a/basis/pango/fonts/authors.txt +++ /dev/null @@ -1,2 +0,0 @@ -Matthew Willis -Slava Pestov diff --git a/basis/pango/fonts/fonts.factor b/basis/pango/fonts/fonts.factor deleted file mode 100644 index 979e40947c..0000000000 --- a/basis/pango/fonts/fonts.factor +++ /dev/null @@ -1,113 +0,0 @@ -! Copyright (C) 2008 Matthew Willis. -! Copyright (C) 2009 Slava Pestov. -! See http://factorcode.org/license.txt for BSD license -USING: pango alien.syntax alien.c-types alien.destructors -kernel glib accessors combinators destructors init fonts -memoize math ; -IN: pango.fonts - -LIBRARY: pango - -ENUM: PangoStyle -PANGO_STYLE_NORMAL -PANGO_STYLE_OBLIQUE -PANGO_STYLE_ITALIC ; - -TYPEDEF: int PangoWeight -C-TYPE: PangoFont -C-TYPE: PangoFontFamily -C-TYPE: PangoFontFace -C-TYPE: PangoFontMap -C-TYPE: PangoFontMetrics -C-TYPE: PangoFontDescription -C-TYPE: PangoGlyphString -C-TYPE: PangoLanguage - -CONSTANT: PANGO_WEIGHT_THIN 100 -CONSTANT: PANGO_WEIGHT_ULTRALIGHT 200 -CONSTANT: PANGO_WEIGHT_LIGHT 300 -CONSTANT: PANGO_WEIGHT_BOOK 380 -CONSTANT: PANGO_WEIGHT_NORMAL 400 -CONSTANT: PANGO_WEIGHT_MEDIUM 500 -CONSTANT: PANGO_WEIGHT_SEMIBOLD 600 -CONSTANT: PANGO_WEIGHT_BOLD 700 -CONSTANT: PANGO_WEIGHT_ULTRABOLD 800 -CONSTANT: PANGO_WEIGHT_HEAVY 900 -CONSTANT: PANGO_WEIGHT_ULTRAHEAVY 1000 - -FUNCTION: PangoFontDescription* -pango_font_description_new ( ) ; - -FUNCTION: void -pango_font_description_free ( PangoFontDescription* desc ) ; - -DESTRUCTOR: pango_font_description_free - -FUNCTION: PangoFontDescription* -pango_font_description_from_string ( c-string str ) ; - -FUNCTION: c-string -pango_font_description_to_string ( PangoFontDescription* desc ) ; - -FUNCTION: c-string -pango_font_description_to_filename ( PangoFontDescription* desc ) ; - -FUNCTION: void -pango_font_description_set_family ( PangoFontDescription* desc, c-string family ) ; - -FUNCTION: void -pango_font_description_set_style ( PangoFontDescription* desc, PangoStyle style ) ; - -FUNCTION: void -pango_font_description_set_weight ( PangoFontDescription* desc, PangoWeight weight ) ; - -FUNCTION: void -pango_font_description_set_size ( PangoFontDescription* desc, gint size ) ; - -FUNCTION: void -pango_font_map_list_families ( PangoFontMap* fontmap, PangoFontFamily*** families, int* n_families ) ; - -FUNCTION: c-string -pango_font_family_get_name ( PangoFontFamily* family ) ; - -FUNCTION: int -pango_font_family_is_monospace ( PangoFontFamily* family ) ; - -FUNCTION: void -pango_font_family_list_faces ( PangoFontFamily* family, PangoFontFace*** faces, int* n_faces ) ; - -FUNCTION: c-string -pango_font_face_get_face_name ( PangoFontFace* face ) ; - -FUNCTION: void -pango_font_face_list_sizes ( PangoFontFace* face, int** sizes, int* n_sizes ) ; - -FUNCTION: void pango_font_metrics_unref ( PangoFontMetrics* metrics ) ; - -DESTRUCTOR: pango_font_metrics_unref - -FUNCTION: int pango_font_metrics_get_ascent ( PangoFontMetrics* metrics ) ; - -FUNCTION: int pango_font_metrics_get_descent ( PangoFontMetrics* metrics ) ; - -FUNCTION: PangoFont* pango_font_map_load_font ( PangoFontMap* fontmap, PangoContext* context, PangoFontDescription* desc ) ; - -FUNCTION: PangoFontMetrics* pango_context_get_metrics ( PangoContext* context, PangoFontDescription* desc, PangoLanguage* language ) ; - -FUNCTION: PangoFontMetrics* pango_font_get_metrics ( PangoFont* font, PangoLanguage* language ) ; - -MEMO: (cache-font-description) ( font -- description ) - [ - [ pango_font_description_new |pango_font_description_free ] dip { - [ name>> pango_font_description_set_family ] - [ size>> float>pango pango_font_description_set_size ] - [ bold?>> PANGO_WEIGHT_BOLD PANGO_WEIGHT_NORMAL ? pango_font_description_set_weight ] - [ italic?>> PANGO_STYLE_ITALIC PANGO_STYLE_NORMAL ? pango_font_description_set_style ] - [ drop ] - } 2cleave - ] with-destructors ; - -: cache-font-description ( font -- description ) - strip-font-colors (cache-font-description) ; - -[ \ (cache-font-description) reset-memoized ] "pango.fonts" add-startup-hook diff --git a/basis/pango/fonts/tags.txt b/basis/pango/fonts/tags.txt deleted file mode 100644 index bb863cf9a0..0000000000 --- a/basis/pango/fonts/tags.txt +++ /dev/null @@ -1 +0,0 @@ -bindings diff --git a/basis/pango/layouts/layouts-tests.factor b/basis/pango/layouts/layouts-tests.factor deleted file mode 100644 index a4a83f79a8..0000000000 --- a/basis/pango/layouts/layouts-tests.factor +++ /dev/null @@ -1,11 +0,0 @@ -IN: pango.layouts.tests -USING: pango.layouts pango.cairo tools.test glib fonts accessors -sequences combinators.short-circuit math destructors ; - -[ t ] [ - [ - "Helvetica" >>name 12 >>size - "OH, HAI" - cached-layout ink-rect>> dim>> - ] with-destructors [ 0 > ] all? -] unit-test \ No newline at end of file diff --git a/basis/pango/layouts/layouts.factor b/basis/pango/layouts/layouts.factor deleted file mode 100644 index 3f3b02c7c7..0000000000 --- a/basis/pango/layouts/layouts.factor +++ /dev/null @@ -1,66 +0,0 @@ -! Copyright (C) 2008 Matthew Willis. -! Copyright (C) 2009 Slava Pestov. -! See http://factorcode.org/license.txt for BSD license. -USING: arrays sequences alien alien.c-types alien.destructors -alien.syntax math math.functions math.vectors destructors combinators -colors fonts accessors assocs namespaces kernel pango pango.fonts -glib unicode.data images cache init -math.rectangles fry memoize io.encodings.utf8 classes.struct ; -IN: pango.layouts - -LIBRARY: pango - -C-TYPE: PangoLayout -C-TYPE: PangoLayoutIter -C-TYPE: PangoLayoutLine - -FUNCTION: PangoLayout* -pango_layout_new ( PangoContext* context ) ; - -FUNCTION: PangoContext* -pango_layout_get_context ( PangoLayout* layout ) ; - -FUNCTION: void -pango_layout_set_text ( PangoLayout* layout, c-string text, int length ) ; - -FUNCTION: c-string -pango_layout_get_text ( PangoLayout* layout ) ; - -FUNCTION: void -pango_layout_get_size ( PangoLayout* layout, int* width, int* height ) ; - -FUNCTION: void -pango_layout_set_font_description ( PangoLayout* layout, PangoFontDescription* desc ) ; - -FUNCTION: PangoFontDescription* -pango_layout_get_font_description ( PangoLayout* layout ) ; - -FUNCTION: void -pango_layout_get_pixel_size ( PangoLayout* layout, int* width, int* height ) ; - -FUNCTION: void -pango_layout_get_extents ( PangoLayout* layout, PangoRectangle* ink_rect, PangoRectangle* logical_rect ) ; - -FUNCTION: void -pango_layout_get_pixel_extents ( PangoLayout* layout, PangoRectangle* ink_rect, PangoRectangle* logical_rect ) ; - -FUNCTION: PangoLayoutLine* -pango_layout_get_line_readonly ( PangoLayout* layout, int line ) ; - -FUNCTION: void -pango_layout_line_index_to_x ( PangoLayoutLine* line, int index_, uint trailing, int* x_pos ) ; - -FUNCTION: gboolean -pango_layout_line_x_to_index ( PangoLayoutLine* line, int x_pos, int* index_, int* trailing ) ; - -FUNCTION: PangoLayoutIter* -pango_layout_get_iter ( PangoLayout* layout ) ; - -FUNCTION: int -pango_layout_iter_get_baseline ( PangoLayoutIter* iter ) ; - -FUNCTION: void -pango_layout_iter_free ( PangoLayoutIter* iter ) ; - -DESTRUCTOR: pango_layout_iter_free - diff --git a/basis/pango/pango.factor b/basis/pango/pango.factor index 3a249c664c..aba7528089 100644 --- a/basis/pango/pango.factor +++ b/basis/pango/pango.factor @@ -1,31 +1,29 @@ -! Copyright (C) 2008 Matthew Willis. -! Copyright (C) 2009 Slava Pestov. -! See http://factorcode.org/license.txt for BSD license -USING: arrays system alien.destructors alien.c-types alien.syntax alien -combinators math.rectangles kernel math alien.libraries classes.struct -accessors ; -IN: pango +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien.syntax alien.c-types alien.destructors +alien.strings alien.libraries arrays classes.struct combinators +destructors fonts init kernel math math.rectangles memoize +io.encodings.utf8 system +gir glib glib.ffi ; -! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -! Helpful functions from other parts of pango -! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! +<< +"pango" { + { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ drop ] } +} cond +>> -<< { - { [ os winnt? ] [ "pango" "libpango-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "pango" "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ ] } -} cond >> +IN: pango.ffi -LIBRARY: pango +TYPEDEF: void PangoLayoutRun ! не совсем верно +TYPEDEF: guint32 PangoGlyph -CONSTANT: PANGO_SCALE 1024 +IN-GIR: pango vocab:pango/Pango-1.0.gir -: pango>float ( n -- x ) PANGO_SCALE /f ; inline -: float>pango ( x -- n ) PANGO_SCALE * >integer ; inline +IN: pango.ffi -C-TYPE: PangoContext - -FUNCTION: PangoContext* pango_context_new ( ) ; +FORGET: PangoRectangle STRUCT: PangoRectangle { x int } @@ -33,7 +31,36 @@ STRUCT: PangoRectangle { width int } { height int } ; +IN: pango + +CONSTANT: PANGO_SCALE 1024 + +: pango>float ( n -- x ) PANGO_SCALE /f ; inline +: float>pango ( x -- n ) PANGO_SCALE * >integer ; inline + : PangoRectangle>rect ( PangoRectangle -- rect ) [ [ x>> pango>float ] [ y>> pango>float ] bi 2array ] [ [ width>> pango>float ] [ height>> pango>float ] bi 2array ] bi ; + +DESTRUCTOR: pango_font_description_free + +DESTRUCTOR: pango_layout_iter_free + +! перенести в ui.*? +MEMO: (cache-font-description) ( font -- description ) + [ + [ pango_font_description_new |pango_font_description_free ] dip { + [ name>> utf8 string>alien pango_font_description_set_family ] + [ size>> float>pango pango_font_description_set_size ] + [ bold?>> PANGO_WEIGHT_BOLD PANGO_WEIGHT_NORMAL ? pango_font_description_set_weight ] + [ italic?>> PANGO_STYLE_ITALIC PANGO_STYLE_NORMAL ? pango_font_description_set_style ] + [ drop ] + } 2cleave + ] with-destructors ; + +: cache-font-description ( font -- description ) + strip-font-colors (cache-font-description) ; + +[ \ (cache-font-description) reset-memoized ] "pango" add-startup-hook + diff --git a/basis/ui/text/pango/pango.factor b/basis/ui/text/pango/pango.factor index 39a7b30348..9cea94bec4 100644 --- a/basis/ui/text/pango/pango.factor +++ b/basis/ui/text/pango/pango.factor @@ -1,8 +1,8 @@ ! Copyright (C) 2009, 2010 Slava Pestov. ! See http://factorcode.org/license.txt for BSD license. USING: accessors assocs cache kernel math math.vectors -namespaces pango.cairo pango.layouts ui.text ui.text.private -pango sequences ; +namespaces pango pango.cairo ui.text ui.text.private +sequences ; IN: ui.text.pango SINGLETON: pango-renderer @@ -31,4 +31,4 @@ M: pango-renderer line-metrics ( font string -- metrics ) [ cached-layout metrics>> ] if-empty ; -pango-renderer font-renderer set-global \ No newline at end of file +pango-renderer font-renderer set-global From e97f10ff6bbc262e0032ff97b46e0d67d6b62793 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Tue, 11 May 2010 23:31:35 +0600 Subject: [PATCH 03/76] add generation of records as STRUCT: with slots when the record is listed in IMPLEMENT-STRUCTS:, add generation of enumerations as ENUM: --- basis/gdk/gdk.factor | 19 ++++++- basis/gdk/pixbuf/pixbuf.factor | 1 + basis/gio/gio.factor | 1 + basis/gir/common/common.factor | 2 + basis/gir/ffi/ffi.factor | 51 +++++++++++++++---- basis/gir/gir.factor | 9 +++- basis/gir/loader/loader.factor | 18 +++++++ basis/gir/repository/repository.factor | 5 +- basis/glib/glib.factor | 3 +- basis/gobject/gobject.factor | 3 +- basis/gst/gst.factor | 1 + basis/gtk/gl/gl.factor | 1 + basis/gtk/gtk.factor | 1 + basis/pango/pango.factor | 2 +- .../gir/samples/lowlevel/opengl/opengl.factor | 17 +++---- 15 files changed, 105 insertions(+), 29 deletions(-) diff --git a/basis/gdk/gdk.factor b/basis/gdk/gdk.factor index fc414cbce4..a91962a23c 100644 --- a/basis/gdk/gdk.factor +++ b/basis/gdk/gdk.factor @@ -1,12 +1,29 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax cairo.ffi +USING: alien.syntax alien.libraries cairo.ffi +combinators kernel system gir glib gobject gio gmodule gdk.pixbuf glib.ffi ; +EXCLUDE: alien.c-types => pointer ; + +<< +"gdk" { + { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" "cdecl" add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdk-x11-2.0.so" "cdecl" add-library ] } +} cond +>> IN: gdk.ffi TYPEDEF: guint32 GdkNativeWindow TYPEDEF: guint32 GdkWChar +IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton +GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility +GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty +GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient +GdkEventNoExpose GdkEventWindowState GdkEventSetting +GdkEventOwnerChange GdkEventGrabBroken ; + IN-GIR: gdk vocab:gdk/Gdk-2.0.gir diff --git a/basis/gdk/pixbuf/pixbuf.factor b/basis/gdk/pixbuf/pixbuf.factor index d9550bd44c..7f6dcf1600 100644 --- a/basis/gdk/pixbuf/pixbuf.factor +++ b/basis/gdk/pixbuf/pixbuf.factor @@ -1,6 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: gir glib gobject gio gmodule ; +EXCLUDE: alien.c-types => pointer ; IN-GIR: gdk.pixbuf vocab:gdk/pixbuf/GdkPixbuf-2.0.gir diff --git a/basis/gio/gio.factor b/basis/gio/gio.factor index bd20272f77..341997fb50 100644 --- a/basis/gio/gio.factor +++ b/basis/gio/gio.factor @@ -1,6 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: gir glib gobject ; +EXCLUDE: alien.c-types => pointer ; IN-GIR: gio vocab:gio/Gio-2.0.gir diff --git a/basis/gir/common/common.factor b/basis/gir/common/common.factor index 10e7820432..e8b7569b73 100644 --- a/basis/gir/common/common.factor +++ b/basis/gir/common/common.factor @@ -16,5 +16,7 @@ type-infos [ H{ } ] initialize SYMBOL: aliases aliases [ H{ } ] initialize +SYMBOL: implement-structs + : get-lib-alias ( lib -- alias ) lib-aliases get-global at ; diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index a233f35794..2f82345739 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.parser assocs combinators -combinators.short-circuit effects fry generalizations +USING: accessors alien alien.c-types alien.enums alien.parser arrays assocs classes.parser +classes.struct combinators combinators.short-circuit compiler.units effects definitions fry generalizations gir.common gir.types kernel locals math math.parser namespaces parser prettyprint quotations sequences vocabs.parser words words.constant ; @@ -52,10 +52,10 @@ IN: gir.ffi : signal-ffi-effect ( signal -- effect ) [ parameters>> [ name>> ] map ] [ return>> type>> none-type? { } { "result" } ? ] bi - dup . ; + ; :: define-ffi-signal ( signal class -- word ) ! сделать попонятнее - signal dup . + signal [ name>> class c-type>> swap ":" glue create-in [ void* swap typedef ] keep dup @@ -75,12 +75,13 @@ IN: gir.ffi } case ; : define-ffi-enum ( enum -- word ) + [ c-type>> (CREATE-C-TYPE) dup ] [ members>> [ [ c-identifier>> create-in ] - [ value>> ] bi define-constant - ] each - ] [ c-type>> create-in [ int swap typedef ] keep ] bi ; + [ value>> ] bi 2array + ] map + ] bi int swap define-enum ; : define-ffi-enums ( enums -- ) [ define-ffi-enum ] define-each ; @@ -88,9 +89,33 @@ IN: gir.ffi : define-ffi-bitfields ( bitfields -- ) [ define-ffi-enum ] define-each ; +: fields>struct-slots ( fields -- slots ) + [ + [ name>> ] [ c-type>> string>c-type ] + [ drop { } ] tri + ] map ; + +! Сделать для всех типов создание DEFER: +: define-ffi-record-defer ( record -- word ) + c-type>> create-in void* swap [ typedef ] keep ; + +: define-ffi-records-defer ( records -- ) + [ define-ffi-record-defer ] define-each ; + : define-ffi-record ( record -- word ) - [ disguised?>> void* void ? ] - [ c-type>> create-in ] bi [ typedef ] keep ; + dup ffi>> forget + dup { + [ fields>> empty? not ] + [ c-type>> implement-structs get-global member? ] + } 1&& + [ + dup . + [ c-type>> create-class-in dup ] + [ fields>> fields>struct-slots ] bi define-struct-class + ] [ + [ disguised?>> void* void ? ] + [ c-type>> create-in ] bi [ typedef ] keep + ] if ; : define-ffi-records ( records -- ) [ define-ffi-record ] define-each ; @@ -185,7 +210,7 @@ IN: gir.ffi : prepare-vocab ( repository -- ) includes>> lib-aliases get '[ _ at ] map sift [ ffi-vocab "." glue ] map - { "alien.c-types" } append + ! { "alien.c-types" } append [ dup using-vocab? [ drop ] [ use-vocab ] if ] each ; : define-ffi-namespace ( namespace -- ) @@ -194,11 +219,15 @@ IN: gir.ffi [ consts>> define-ffi-consts ] [ enums>> define-ffi-enums ] [ bitfields>> define-ffi-bitfields ] - [ records>> define-ffi-records ] + + [ records>> define-ffi-records-defer ] + [ unions>> define-ffi-unions ] [ interfaces>> define-ffi-interfaces ] [ classes>> define-ffi-classes ] [ callbacks>> define-ffi-callbacks ] + [ records>> define-ffi-records ] + [ records>> define-ffi-records-content ] [ classes>> define-ffi-classes-content ] [ interfaces>> define-ffi-interfaces-content ] diff --git a/basis/gir/gir.factor b/basis/gir/gir.factor index 6483d18e35..283fb2caf9 100755 --- a/basis/gir/gir.factor +++ b/basis/gir/gir.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors assocs combinators gir.common gir.ffi gir.loader -kernel lexer locals namespaces sequences vocabs.parser xml ; +kernel lexer locals namespaces prettyprint sequences vocabs.parser xml ; IN: gir : with-child-vocab ( name quot -- ) @@ -12,6 +12,7 @@ IN: gir :: define-gir-vocab ( vocab-name file-name -- ) file-name file>xml xml>repository + implement-structs get-global . vocab-name [ set-current-vocab ] [ current-lib set ] bi { [ @@ -19,6 +20,10 @@ IN: gir lib-aliases get set-at ] [ ffi-vocab [ define-ffi-repository ] with-child-vocab ] - } cleave ; + } cleave + f implement-structs set-global ; SYNTAX: IN-GIR: scan scan define-gir-vocab ; + +SYNTAX: IMPLEMENT-STRUCTS: + ";" parse-tokens implement-structs set-global ; diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor index 410380e639..5902b90b26 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gir/loader/loader.factor @@ -42,6 +42,7 @@ IN: gir.loader } { "type" [ node>type f swap ] } { "varargs" [ drop f f ] } + { "callback" [ drop f "any" f type boa ] } } case ; : load-parameter ( param xml -- param ) @@ -188,10 +189,27 @@ IN: gir.loader [ "member" tags-named [ xml>member ] map >>members ] } cleave ; +: xml>field ( xml -- field ) + [ field new ] dip { + [ "name" attr >>name ] + [ "writable" attr "1" = >>writable? ] + ! Для некоторых field есть callback в качестве типа, решить, как лучше сделать + [ + first-child-tag dup name>> main>> "callback" = + [ drop "gpointer" ] [ "type" attr ] if + >>c-type + ] + [ + first-child-tag xml>type + [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* + ] + } cleave ; + : xml>record ( xml -- record ) [ record new ] dip { [ load-type ] [ "disguised" attr "1" = >>disguised? ] + [ "field" tags-named [ xml>field ] map >>fields ] [ "constructor" load-functions >>constructors ] [ "function" load-functions >>functions ] [ diff --git a/basis/gir/repository/repository.factor b/basis/gir/repository/repository.factor index 5a067850fc..4fb43c44e3 100644 --- a/basis/gir/repository/repository.factor +++ b/basis/gir/repository/repository.factor @@ -20,8 +20,11 @@ TUPLE: const < typed value ffi ; TUPLE: type-node < node type c-type type-name get-type ffi ; +TUPLE: field < typed + writable? length? array-info ; + TUPLE: record < type-node - constructors methods functions disguised? ; + fields constructors methods functions disguised? ; TUPLE: union < type-node ; diff --git a/basis/glib/glib.factor b/basis/glib/glib.factor index e8aa1688df..ec8aedaa96 100644 --- a/basis/glib/glib.factor +++ b/basis/glib/glib.factor @@ -58,7 +58,8 @@ TYPEDEF: guint32 gunichar TYPEDEF: guint16 gunichar2 ! Разобраться, почему в .gir есть такие типы -TYPEDEF: void any +TYPEDEF: gpointer pointer +TYPEDEF: gpointer any IN-GIR: glib vocab:glib/GLib-2.0.gir diff --git a/basis/gobject/gobject.factor b/basis/gobject/gobject.factor index d9135119ad..d2274d74a7 100644 --- a/basis/gobject/gobject.factor +++ b/basis/gobject/gobject.factor @@ -1,8 +1,9 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.c-types alien.destructors +USING: alien.syntax alien.destructors alien.libraries combinators kernel literals math system gir glib glib.ffi ; +EXCLUDE: alien.c-types => pointer ; IN: gobject.ffi diff --git a/basis/gst/gst.factor b/basis/gst/gst.factor index a386e7d4b8..41723b78ae 100644 --- a/basis/gst/gst.factor +++ b/basis/gst/gst.factor @@ -3,6 +3,7 @@ USING: alien.syntax alien.libraries combinators kernel system gir glib glib.ffi gobject gmodule ; +EXCLUDE: alien.c-types => pointer ; << "gst" { diff --git a/basis/gtk/gl/gl.factor b/basis/gtk/gl/gl.factor index 53569b6c62..01b3180509 100644 --- a/basis/gtk/gl/gl.factor +++ b/basis/gtk/gl/gl.factor @@ -2,6 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien.syntax alien.libraries combinators kernel system gir glib gobject gio gmodule gdk.pixbuf gdk gdk.gl gtk gtk.ffi ; +EXCLUDE: alien.c-types => pointer ; << "gtk.gl" { diff --git a/basis/gtk/gtk.factor b/basis/gtk/gtk.factor index 1882eb8ac6..7aede500e0 100644 --- a/basis/gtk/gtk.factor +++ b/basis/gtk/gtk.factor @@ -3,6 +3,7 @@ USING: alien.syntax alien.libraries cairo.ffi combinators kernel system gir glib glib.ffi gobject gio gmodule gdk.pixbuf gdk atk ; +EXCLUDE: alien.c-types => pointer ; << "gtk" { diff --git a/basis/pango/pango.factor b/basis/pango/pango.factor index aba7528089..a460919d24 100644 --- a/basis/pango/pango.factor +++ b/basis/pango/pango.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.syntax alien.c-types alien.destructors +USING: accessors alien alien.syntax alien.c-types alien.destructors alien.strings alien.libraries arrays classes.struct combinators destructors fonts init kernel math math.rectangles memoize io.encodings.utf8 system diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gir/samples/lowlevel/opengl/opengl.factor index d4cbbc5f12..bf3dd06edf 100644 --- a/extra/gir/samples/lowlevel/opengl/opengl.factor +++ b/extra/gir/samples/lowlevel/opengl/opengl.factor @@ -53,26 +53,21 @@ IN: gir.samples.lowlevel.opengl [ 200 200 gtk_window_set_default_size ] [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri - window 1 gtk_container_set_reallocate_redraws + ! window 1 gtk_container_set_reallocate_redraws GDK_GL_MODE_RGBA GDK_GL_MODE_DOUBLE bitor gdk_gl_config_new_by_mode :> gl-config - gtk_drawing_area_new :> drawing-area - drawing-area 200 200 gtk_widget_set_size_request + window gl-config f 1 GDK_GL_RGBA_TYPE + gtk_widget_set_gl_capability drop - drawing-area gl-config f 1 GDK_GL_RGBA_TYPE - gtk_widget_set_gl_capability . - - drawing-area "configure-event" utf8 string>alien + window "configure-event" utf8 string>alien [ on-configure ] GtkWidget:configure-event f f 0 g_signal_connect_data drop - drawing-area "expose-event" utf8 string>alien + window "expose-event" utf8 string>alien [ on-expose ] GtkWidget:expose-event - f f 0 g_signal_connect_data drop - - window drawing-area gtk_container_add + f f 0 g_signal_connect_data drop window ; From 0d743f94ffef9123bb2e565464a7d39d1090ca12 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:03:45 +0600 Subject: [PATCH 04/76] clean up --- basis/gir/common/common.factor | 1 + basis/gir/ffi/ffi.factor | 23 +++++++++++++---------- basis/gir/gir.factor | 3 +-- basis/gir/loader/loader.factor | 19 ++++++++++++++++++- basis/gir/repository/repository.factor | 5 +++-- basis/gir/types/types.factor | 1 + 6 files changed, 37 insertions(+), 15 deletions(-) diff --git a/basis/gir/common/common.factor b/basis/gir/common/common.factor index e8b7569b73..f5513d9424 100644 --- a/basis/gir/common/common.factor +++ b/basis/gir/common/common.factor @@ -20,3 +20,4 @@ SYMBOL: implement-structs : get-lib-alias ( lib -- alias ) lib-aliases get-global at ; + diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index 2f82345739..81373842a2 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -1,10 +1,10 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.enums alien.parser arrays assocs classes.parser -classes.struct combinators combinators.short-circuit compiler.units effects definitions fry generalizations -gir.common gir.types kernel locals math math.parser namespaces -parser prettyprint quotations sequences vocabs.parser words -words.constant ; +USING: accessors alien alien.c-types alien.enums alien.parser arrays +assocs classes.parser classes.struct combinators +combinators.short-circuit definitions effects fry gir.common gir.types +kernel locals math.parser namespaces parser quotations sequences +sequences.generalizations vocabs.parser words words.constant ; IN: gir.ffi : string>c-type ( str -- c-type ) @@ -47,7 +47,7 @@ IN: gir.ffi : signal-ffi-invoker ( signal -- quot ) [ return>> signal-param-c-type string>c-type ] [ parameters>> [ signal-param-c-type string>c-type ] map ] bi - "cdecl" [ [ ] 3curry dip alien-callback ] 3curry ; + cdecl [ [ ] 3curry dip alien-callback ] 3curry ; : signal-ffi-effect ( signal -- effect ) [ parameters>> [ name>> ] map ] @@ -91,7 +91,11 @@ IN: gir.ffi : fields>struct-slots ( fields -- slots ) [ - [ name>> ] [ c-type>> string>c-type ] + [ name>> ] + [ + [ c-type>> string>c-type ] [ array-info>> ] bi + [ fixed-size>> [ 2array ] when* ] when* + ] [ drop { } ] tri ] map ; @@ -109,7 +113,6 @@ IN: gir.ffi [ c-type>> implement-structs get-global member? ] } 1&& [ - dup . [ c-type>> create-class-in dup ] [ fields>> fields>struct-slots ] bi define-struct-class ] [ @@ -196,7 +199,8 @@ IN: gir.ffi } cleave ; : define-ffi-const ( const -- word ) - [ name>> create-in dup ] [ const-value ] bi define-constant ; + [ c-identifier>> create-in dup ] [ const-value ] bi + define-constant ; : define-ffi-consts ( consts -- ) [ define-ffi-const ] define-each ; @@ -210,7 +214,6 @@ IN: gir.ffi : prepare-vocab ( repository -- ) includes>> lib-aliases get '[ _ at ] map sift [ ffi-vocab "." glue ] map - ! { "alien.c-types" } append [ dup using-vocab? [ drop ] [ use-vocab ] if ] each ; : define-ffi-namespace ( namespace -- ) diff --git a/basis/gir/gir.factor b/basis/gir/gir.factor index 283fb2caf9..1da49badb9 100755 --- a/basis/gir/gir.factor +++ b/basis/gir/gir.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors assocs combinators gir.common gir.ffi gir.loader -kernel lexer locals namespaces prettyprint sequences vocabs.parser xml ; +kernel lexer locals namespaces sequences vocabs.parser xml ; IN: gir : with-child-vocab ( name quot -- ) @@ -12,7 +12,6 @@ IN: gir :: define-gir-vocab ( vocab-name file-name -- ) file-name file>xml xml>repository - implement-structs get-global . vocab-name [ set-current-vocab ] [ current-lib set ] bi { [ diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor index 5902b90b26..a6fc482c89 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gir/loader/loader.factor @@ -1,14 +1,26 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors ascii combinators fry gir.common gir.repository -gir.types kernel math math.parser sequences splitting xml.data +gir.types kernel math.parser sequences splitting xml.data xml.traversal ; FROM: namespaces => set get ; IN: gir.loader +SYMBOL: namespace-prefix +SYMBOL: namespace-PREFIX + : word-started? ( word letter -- ? ) [ last letter? ] [ LETTER? ] bi* and ; +: camel>PREFIX ( name -- name' ) + dup 1 head + [ 2dup word-started? [ [ CHAR: _ suffix ] dip ] when suffix ] + reduce rest >upper ; + +: set-prefix ( prefix -- ) + [ namespace-prefix set ] + [ camel>PREFIX namespace-PREFIX set ] bi ; + : camel>factor ( name -- name' ) dup 1 head [ 2dup word-started? [ [ CHAR: - suffix ] dip ] when suffix ] @@ -231,6 +243,10 @@ IN: gir.loader : xml>const ( xml -- const ) [ const new ] dip { [ "name" attr >>name ] + [ + "name" attr namespace-PREFIX get swap "_" glue + >>c-identifier + ] [ "value" attr >>value ] [ first-child-tag "type" attr >>c-type ] [ first-child-tag xml>type nip >>type ] @@ -239,6 +255,7 @@ IN: gir.loader : xml>namespace ( xml -- namespace ) [ namespace new ] dip { [ "name" attr camel>factor dup current-lib set >>name ] + [ "prefix" attr [ set-prefix ] keep >>prefix ] [ "alias" tags-named [ xml>alias ] map >>aliases ] [ "record" tags-named [ xml>record ] map >>records ] [ "union" tags-named [ xml>union ] map >>unions ] diff --git a/basis/gir/repository/repository.factor b/basis/gir/repository/repository.factor index 4fb43c44e3..1ff5b2c5b4 100644 --- a/basis/gir/repository/repository.factor +++ b/basis/gir/repository/repository.factor @@ -8,14 +8,15 @@ TUPLE: node name ; TUPLE: repository includes namespace ; TUPLE: namespace < node - aliases consts classes interfaces records unions callbacks + prefix aliases consts classes interfaces records unions callbacks enums bitfields functions ; TUPLE: alias < node target ; TUPLE: typed < node type c-type ; -TUPLE: const < typed value ffi ; +TUPLE: const < typed + value c-identifier ffi ; TUPLE: type-node < node type c-type type-name get-type ffi ; diff --git a/basis/gir/types/types.factor b/basis/gir/types/types.factor index 2cf0006c9d..b0dc5f7df5 100644 --- a/basis/gir/types/types.factor +++ b/basis/gir/types/types.factor @@ -133,3 +133,4 @@ PREDICATE: interface-type < type get-type-info interface-info? ; [ namespace>> ] [ simple-type? ] [ utf8-type? ] [ none-type? ] } 1|| [ current-lib get >>namespace ] unless ; + From a2ffbdefa94a7e10f8f1f8fc35146d287b728ee2 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:05:34 +0600 Subject: [PATCH 05/76] clean up; add add-library for unix environments (and partially for windows) --- basis/atk/atk.factor | 11 ++- basis/gdk/gdk.factor | 10 +- basis/gdk/gl/gl.factor | 7 +- basis/gdk/pixbuf/pixbuf.factor | 11 ++- basis/gio/gio.factor | 11 ++- basis/glib/glib.factor | 10 +- basis/gmodule/gmodule.factor | 11 ++- basis/gobject/gobject.factor | 55 ++++++----- basis/gst/gst.factor | 8 +- basis/gtk/gl/gl.factor | 6 +- basis/gtk/gtk.factor | 8 +- basis/pango/cairo/cairo.factor | 163 +-------------------------------- basis/pango/pango.factor | 48 +--------- 13 files changed, 109 insertions(+), 250 deletions(-) diff --git a/basis/atk/atk.factor b/basis/atk/atk.factor index c03b6397d6..66f091ab19 100644 --- a/basis/atk/atk.factor +++ b/basis/atk/atk.factor @@ -1,8 +1,17 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax +USING: alien alien.libraries alien.syntax combinators kernel +system gir glib gobject glib.ffi ; +<< +"atk" { + { [ os winnt? ] [ "libatk-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libatk-1.0.so" cdecl add-library ] } +} cond +>> + IN: atk.ffi TYPEDEF: guint64 AtkState diff --git a/basis/gdk/gdk.factor b/basis/gdk/gdk.factor index a91962a23c..bf6accd57b 100644 --- a/basis/gdk/gdk.factor +++ b/basis/gdk/gdk.factor @@ -1,15 +1,15 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.libraries cairo.ffi +USING: alien alien.destructors alien.syntax alien.libraries cairo.ffi combinators kernel system gir glib gobject gio gmodule gdk.pixbuf glib.ffi ; EXCLUDE: alien.c-types => pointer ; << "gdk" { - { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" "cdecl" add-library ] } + { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" cdecl add-library ] } { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdk-x11-2.0.so" "cdecl" add-library ] } + { [ os unix? ] [ "libgdk-x11-2.0.so" cdecl add-library ] } } cond >> @@ -27,3 +27,7 @@ GdkEventOwnerChange GdkEventGrabBroken ; IN-GIR: gdk vocab:gdk/Gdk-2.0.gir +IN: gdk.ffi + +DESTRUCTOR: gdk_cursor_unref + diff --git a/basis/gdk/gl/gl.factor b/basis/gdk/gl/gl.factor index 09d86d2e57..f8c3bd26ee 100644 --- a/basis/gdk/gl/gl.factor +++ b/basis/gdk/gl/gl.factor @@ -1,13 +1,14 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.c-types alien.libraries alien.syntax combinators kernel system vocabs.parser words +USING: alien alien.c-types alien.libraries combinators kernel +system vocabs.parser words gir glib gobject gio gmodule gdk gdk.ffi gdk.pixbuf ; << "gdk.gl" { - { [ os winnt? ] [ "" "cdecl" add-library ] } + { [ os winnt? ] [ drop ] } { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdkglext-x11-1.0.so" "cdecl" add-library ] } + { [ os unix? ] [ "libgdkglext-x11-1.0.so" cdecl add-library ] } } cond >> diff --git a/basis/gdk/pixbuf/pixbuf.factor b/basis/gdk/pixbuf/pixbuf.factor index 7f6dcf1600..02fdccc3bb 100644 --- a/basis/gdk/pixbuf/pixbuf.factor +++ b/basis/gdk/pixbuf/pixbuf.factor @@ -1,7 +1,16 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: gir glib gobject gio gmodule ; +USING: alien alien.libraries combinators kernel system +gir glib gobject gio gmodule ; EXCLUDE: alien.c-types => pointer ; +<< +"gdk.pixbuf" { + { [ os winnt? ] [ "libgdk_pixbuf-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdk_pixbuf-2.0.so" cdecl add-library ] } +} cond +>> + IN-GIR: gdk.pixbuf vocab:gdk/pixbuf/GdkPixbuf-2.0.gir diff --git a/basis/gio/gio.factor b/basis/gio/gio.factor index 341997fb50..451bbeeded 100644 --- a/basis/gio/gio.factor +++ b/basis/gio/gio.factor @@ -1,7 +1,16 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: gir glib gobject ; +USING: alien alien.libraries combinators kernel system +gir glib gobject ; EXCLUDE: alien.c-types => pointer ; +<< +"gio" { + { [ os winnt? ] [ "libgio-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgio-2.0.so" cdecl add-library ] } +} cond +>> + IN-GIR: gio vocab:gio/Gio-2.0.gir diff --git a/basis/glib/glib.factor b/basis/glib/glib.factor index ec8aedaa96..903915be99 100644 --- a/basis/glib/glib.factor +++ b/basis/glib/glib.factor @@ -1,13 +1,13 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.c-types alien.libraries alien.syntax combinators gir +USING: alien alien.c-types alien.libraries alien.syntax combinators gir kernel system vocabs.parser words ; << "glib" { - { [ os winnt? ] [ "libglib-2.0-0.dll" "cdecl" add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" "cdecl" add-library ] } - { [ os unix? ] [ drop ] } + { [ os winnt? ] [ "libglib-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libglib-2.0.so" cdecl add-library ] } } cond >> @@ -23,7 +23,7 @@ TYPEDEF: long glong TYPEDEF: ulong gulong TYPEDEF: int gint TYPEDEF: uint guint -TYPEDEF: gint gboolean +TYPEDEF: bool gboolean TYPEDEF: char gint8 TYPEDEF: uchar guint8 diff --git a/basis/gmodule/gmodule.factor b/basis/gmodule/gmodule.factor index a33150cc2f..ed60c7e9b8 100644 --- a/basis/gmodule/gmodule.factor +++ b/basis/gmodule/gmodule.factor @@ -1,6 +1,15 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: gir glib ; +USING: alien alien.libraries combinators kernel system +gir glib ; + +<< +"gmodule" { + { [ os winnt? ] [ "libgmodule-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgmodule-2.0.so" cdecl add-library ] } +} cond +>> IN-GIR: gmodule vocab:gmodule/GModule-2.0.gir diff --git a/basis/gobject/gobject.factor b/basis/gobject/gobject.factor index d2274d74a7..541a77c287 100644 --- a/basis/gobject/gobject.factor +++ b/basis/gobject/gobject.factor @@ -1,10 +1,18 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.destructors +USING: alien alien.syntax alien.destructors alien.libraries combinators kernel literals math system gir glib glib.ffi ; EXCLUDE: alien.c-types => pointer ; +<< +"gobject" { + { [ os winnt? ] [ "libobject-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libgobject-2.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libgobject-2.0.so" cdecl add-library ] } +} cond +>> + IN: gobject.ffi TYPEDEF: void* GSignalCMarshaller @@ -12,6 +20,8 @@ TYPEDEF: void GStrv ! есть alias TYPEDEF: gchar* gchararray +IMPLEMENT-STRUCTS: GValue ; + IN-GIR: gobject vocab:gobject/GObject-2.0.gir IN: gobject.ffi @@ -26,26 +36,25 @@ DESTRUCTOR: g_object_unref ! (разобраться) TYPEDEF: GParamSpec GParam -<< CONSTANT: G_TYPE_FUNDAMENTAL_SHIFT 2 >> -CONSTANT: G_TYPE_INVALID $[ 0 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_NONE $[ 1 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_INTERFACE $[ 2 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_CHAR $[ 3 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_UCHAR $[ 4 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_BOOLEAN $[ 5 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_INT $[ 6 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_UINT $[ 7 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_LONG $[ 8 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_ULONG $[ 9 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_INT64 $[ 10 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_UINT64 $[ 11 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_ENUM $[ 12 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_FLAGS $[ 13 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_FLOAT $[ 14 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_DOUBLE $[ 15 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_STRING $[ 16 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_POINTER $[ 17 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_BOXED $[ 18 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_PARAM $[ 19 G_TYPE_FUNDAMENTAL_SHIFT shift ] -CONSTANT: G_TYPE_OBJECT $[ 20 G_TYPE_FUNDAMENTAL_SHIFT shift ] +CONSTANT: G_TYPE_INVALID $[ 0 2 shift ] +CONSTANT: G_TYPE_NONE $[ 1 2 shift ] +CONSTANT: G_TYPE_INTERFACE $[ 2 2 shift ] +CONSTANT: G_TYPE_CHAR $[ 3 2 shift ] +CONSTANT: G_TYPE_UCHAR $[ 4 2 shift ] +CONSTANT: G_TYPE_BOOLEAN $[ 5 2 shift ] +CONSTANT: G_TYPE_INT $[ 6 2 shift ] +CONSTANT: G_TYPE_UINT $[ 7 2 shift ] +CONSTANT: G_TYPE_LONG $[ 8 2 shift ] +CONSTANT: G_TYPE_ULONG $[ 9 2 shift ] +CONSTANT: G_TYPE_INT64 $[ 10 2 shift ] +CONSTANT: G_TYPE_UINT64 $[ 11 2 shift ] +CONSTANT: G_TYPE_ENUM $[ 12 2 shift ] +CONSTANT: G_TYPE_FLAGS $[ 13 2 shift ] +CONSTANT: G_TYPE_FLOAT $[ 14 2 shift ] +CONSTANT: G_TYPE_DOUBLE $[ 15 2 shift ] +CONSTANT: G_TYPE_STRING $[ 16 2 shift ] +CONSTANT: G_TYPE_POINTER $[ 17 2 shift ] +CONSTANT: G_TYPE_BOXED $[ 18 2 shift ] +CONSTANT: G_TYPE_PARAM $[ 19 2 shift ] +CONSTANT: G_TYPE_OBJECT $[ 20 2 shift ] diff --git a/basis/gst/gst.factor b/basis/gst/gst.factor index 41723b78ae..b97b929f5c 100644 --- a/basis/gst/gst.factor +++ b/basis/gst/gst.factor @@ -1,15 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.libraries combinators +USING: alien alien.syntax alien.libraries combinators kernel system gir glib glib.ffi gobject gmodule ; EXCLUDE: alien.c-types => pointer ; << "gst" { - { [ os winnt? ] [ "" "cdecl" add-library ] } - { [ os macosx? ] [ "" "cdecl" add-library ] } - { [ os unix? ] [ "libgstreamer-0.10.so" "cdecl" add-library ] } + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstreamer-0.10.so" cdecl add-library ] } } cond >> diff --git a/basis/gtk/gl/gl.factor b/basis/gtk/gl/gl.factor index 01b3180509..cc4bc8d581 100644 --- a/basis/gtk/gl/gl.factor +++ b/basis/gtk/gl/gl.factor @@ -1,14 +1,14 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.libraries combinators kernel system +USING: alien alien.libraries combinators kernel system gir glib gobject gio gmodule gdk.pixbuf gdk gdk.gl gtk gtk.ffi ; EXCLUDE: alien.c-types => pointer ; << "gtk.gl" { - { [ os winnt? ] [ "" "cdecl" add-library ] } + { [ os winnt? ] [ drop ] } { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgtkglext-x11-1.0.so" "cdecl" add-library ] } + { [ os unix? ] [ "libgtkglext-x11-1.0.so" cdecl add-library ] } } cond >> diff --git a/basis/gtk/gtk.factor b/basis/gtk/gtk.factor index 7aede500e0..8dc000ffdc 100644 --- a/basis/gtk/gtk.factor +++ b/basis/gtk/gtk.factor @@ -1,15 +1,15 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.syntax alien.libraries cairo.ffi combinators +USING: alien alien.syntax alien.libraries cairo.ffi combinators kernel system gir glib glib.ffi gobject gio gmodule gdk.pixbuf gdk atk ; EXCLUDE: alien.c-types => pointer ; << "gtk" { - { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" "cdecl" add-library ] } + { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" cdecl add-library ] } { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgtk-x11-2.0.so" "cdecl" add-library ] } + { [ os unix? ] [ "libgtk-x11-2.0.so" cdecl add-library ] } } cond >> @@ -20,5 +20,7 @@ TYPEDEF: void GtkEnumValue TYPEDEF: void GtkFlagValue TYPEDEF: GType GtkType +IMPLEMENT-STRUCTS: GtkTreeIter ; + IN-GIR: gtk vocab:gtk/Gtk-2.0.gir diff --git a/basis/pango/cairo/cairo.factor b/basis/pango/cairo/cairo.factor index db86f6504c..57896dd5b5 100644 --- a/basis/pango/cairo/cairo.factor +++ b/basis/pango/cairo/cairo.factor @@ -1,25 +1,19 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.destructors -alien.libraries alien.syntax alien.strings arrays math math.functions -math.vectors destructors combinators colors fonts accessors assocs -namespaces kernel unicode.data images sequences -cache init system math.rectangles fry memoize io.encodings.utf8 -classes.struct cairo cairo.ffi -gir pango pango.ffi gobject gobject.ffi ; +USING: alien alien.c-types alien.libraries alien.syntax cairo.ffi +combinators kernel system +gir pango pango.ffi ; << "pango.cairo" { { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } { [ os macosx? ] [ "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ drop ] } + { [ os unix? ] [ "libpangocairo-1.0.so" cdecl add-library ] } } cond >> IN-GIR: pango.cairo vocab:pango/cairo/PangoCairo-1.0.gir - - IN: pango.cairo.ffi FUNCTION: void @@ -31,152 +25,3 @@ pango_cairo_show_layout ( cairo_t* cr, PangoLayout* layout ) ; FUNCTION: PangoLayout* pango_cairo_create_layout ( cairo_t* cr ) ; -IN: pango.cairo - -TUPLE: layout < disposable font string selection layout metrics ink-rect logical-rect image ; - -SYMBOL: dpi - -72 dpi set-global - -: set-layout-font ( font layout -- ) - swap cache-font-description pango_layout_set_font_description ; - -: set-layout-text ( str layout -- ) - #! Replace nulls with something else since Pango uses null-terminated - #! strings - swap utf8 string>alien -1 pango_layout_set_text ; - -: layout-extents ( layout -- ink-rect logical-rect ) - PangoRectangle - PangoRectangle - [ pango_layout_get_extents ] 2keep - [ PangoRectangle>rect ] bi@ ; - -: layout-baseline ( layout -- baseline ) - pango_layout_get_iter &pango_layout_iter_free - pango_layout_iter_get_baseline - pango>float ; - -: set-foreground ( cr font -- ) - foreground>> set-source-color ; - -: fill-background ( cr font dim -- ) - [ background>> set-source-color ] - [ [ { 0 0 } ] dip fill-rect ] bi-curry* bi ; - -: rect-translate-x ( rect x -- rect' ) - '[ _ 0 2array v- ] change-loc ; - -: first-line ( layout -- line ) - layout>> 0 pango_layout_get_line_readonly ; - -: line-offset>x ( layout n -- x ) - #! n is an index into the UTF8 encoding of the text - [ drop first-line ] [ swap string>> >utf8-index ] 2bi - 0 0 [ pango_layout_line_index_to_x ] keep - *int pango>float ; - -: x>line-offset ( layout x -- n ) - #! n is an index into the UTF8 encoding of the text - [ - [ first-line ] dip - float>pango 0 0 - [ pango_layout_line_x_to_index drop ] 2keep - [ *int ] bi@ swap - ] [ drop string>> ] 2bi utf8-index> + ; - -: selection-start/end ( selection -- start end ) - selection>> [ start>> ] [ end>> ] bi ; - -: selection-rect ( layout -- rect ) - [ ink-rect>> dim>> ] [ ] [ selection-start/end ] tri [ line-offset>x ] bi-curry@ bi - [ drop nip 0 2array ] [ swap - swap second 2array ] 3bi ; - -: fill-selection-background ( cr layout -- ) - dup selection>> [ - [ selection>> color>> set-source-color ] - [ - [ selection-rect ] [ ink-rect>> loc>> first ] bi - rect-translate-x - fill-rect - ] 2bi - ] [ 2drop ] if ; - -: text-position ( layout -- loc ) - [ logical-rect>> ] [ ink-rect>> ] bi [ loc>> ] bi@ v- ; - -: set-text-position ( cr loc -- ) - first2 cairo_move_to ; - -: draw-layout ( layout -- image ) - dup ink-rect>> dim>> [ >fixnum ] map [ - swap { - [ layout>> pango_cairo_update_layout ] - [ [ font>> ] [ ink-rect>> dim>> ] bi fill-background ] - [ fill-selection-background ] - [ text-position set-text-position ] - [ font>> set-foreground ] - [ layout>> pango_cairo_show_layout ] - } 2cleave - ] make-bitmap-image ; - -: escape-nulls ( str -- str' ) - { { 0 CHAR: zero-width-no-break-space } } substitute ; - -: unpack-selection ( layout string/selection -- layout ) - dup selection? [ - [ string>> escape-nulls >>string ] [ >>selection ] bi - ] [ escape-nulls >>string ] if ; inline - -: set-layout-resolution ( layout -- ) - pango_layout_get_context dpi get pango_cairo_context_set_resolution ; - -: ( text font -- layout ) - dummy-cairo pango_cairo_create_layout |g_object_unref - [ set-layout-resolution ] keep - [ set-layout-font ] keep - [ set-layout-text ] keep ; - -: glyph-height ( font string -- y ) - swap &g_object_unref layout-extents drop dim>> second ; - -MEMO: missing-font-metrics ( font -- metrics ) - #! Pango doesn't provide x-height and cap-height but Core Text does, so we - #! simulate them on Pango. - [ - [ metrics new ] dip - [ "x" glyph-height >>x-height ] - [ "Y" glyph-height >>cap-height ] bi - ] with-destructors ; - -: layout-metrics ( layout -- metrics ) - dup font>> missing-font-metrics clone - swap - [ layout>> layout-baseline >>ascent ] - [ logical-rect>> dim>> [ first >>width ] [ second >>height ] bi ] bi - dup [ height>> ] [ ascent>> ] bi - >>descent ; - -: ( font string -- line ) - [ - layout new-disposable - swap unpack-selection - swap >>font - dup [ string>> ] [ font>> ] bi >>layout - dup layout>> layout-extents [ >>ink-rect ] [ >>logical-rect ] bi* - dup layout-metrics >>metrics - dup draw-layout >>image - ] with-destructors ; - -M: layout dispose* layout>> g_object_unref ; - -SYMBOL: cached-layouts - -: cached-layout ( font string -- layout ) - cached-layouts get [ ] 2cache ; - -: cached-line ( font string -- line ) - cached-layout layout>> first-line ; - -[ cached-layouts set-global ] "pango.cairo" add-startup-hook - diff --git a/basis/pango/pango.factor b/basis/pango/pango.factor index a460919d24..6d1e8aed94 100644 --- a/basis/pango/pango.factor +++ b/basis/pango/pango.factor @@ -1,16 +1,14 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.syntax alien.c-types alien.destructors -alien.strings alien.libraries arrays classes.struct combinators -destructors fonts init kernel math math.rectangles memoize -io.encodings.utf8 system +USING: alien alien.c-types alien.destructors alien.libraries +alien.syntax combinators kernel system gir glib glib.ffi ; << "pango" { { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } { [ os macosx? ] [ "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ drop ] } + { [ os unix? ] [ "libpango-1.0.so" cdecl add-library ] } } cond >> @@ -19,48 +17,12 @@ IN: pango.ffi TYPEDEF: void PangoLayoutRun ! не совсем верно TYPEDEF: guint32 PangoGlyph +IMPLEMENT-STRUCTS: PangoRectangle ; + IN-GIR: pango vocab:pango/Pango-1.0.gir IN: pango.ffi -FORGET: PangoRectangle - -STRUCT: PangoRectangle - { x int } - { y int } - { width int } - { height int } ; - -IN: pango - -CONSTANT: PANGO_SCALE 1024 - -: pango>float ( n -- x ) PANGO_SCALE /f ; inline -: float>pango ( x -- n ) PANGO_SCALE * >integer ; inline - -: PangoRectangle>rect ( PangoRectangle -- rect ) - [ [ x>> pango>float ] [ y>> pango>float ] bi 2array ] - [ [ width>> pango>float ] [ height>> pango>float ] bi 2array ] bi - ; - DESTRUCTOR: pango_font_description_free - DESTRUCTOR: pango_layout_iter_free -! перенести в ui.*? -MEMO: (cache-font-description) ( font -- description ) - [ - [ pango_font_description_new |pango_font_description_free ] dip { - [ name>> utf8 string>alien pango_font_description_set_family ] - [ size>> float>pango pango_font_description_set_size ] - [ bold?>> PANGO_WEIGHT_BOLD PANGO_WEIGHT_NORMAL ? pango_font_description_set_weight ] - [ italic?>> PANGO_STYLE_ITALIC PANGO_STYLE_NORMAL ? pango_font_description_set_style ] - [ drop ] - } 2cleave - ] with-destructors ; - -: cache-font-description ( font -- description ) - strip-font-colors (cache-font-description) ; - -[ \ (cache-font-description) reset-memoized ] "pango" add-startup-hook - From 1981fb81861e492b91c911a05d46b54d2491b697 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:08:14 +0600 Subject: [PATCH 06/76] clean up --- .../lowlevel/gstreamer/gstreamer.factor | 4 ++-- .../lowlevel/hello-world/hello-world.factor | 2 +- extra/gir/samples/lowlevel/lowlevel.factor | 17 ++++++-------- .../gir/samples/lowlevel/opengl/opengl.factor | 22 +++++++------------ 4 files changed, 18 insertions(+), 27 deletions(-) diff --git a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor index c8a2c4e620..0127f48e6b 100644 --- a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor +++ b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.c-types alien.strings fry byte-arrays +USING: alien.c-types alien.strings fry byte-arrays classes.struct io.encodings.utf8 kernel locals math prettyprint gst gst.ffi glib.ffi gobject.ffi gtk gtk.ffi ; IN: gir.samples.lowlevel.gstreamer @@ -12,7 +12,7 @@ CONSTANT: uri "http://tinyvid.tv/file/3gocxnjott7wr.ogg" f f gst_init "playbin" "player" [ utf8 string>alien ] bi@ gst_element_factory_make :> pipeline - GType gint64 [ heap-size ] bi@ 2 * + :> value + GValue :> value value G_TYPE_STRING g_value_init drop value uri utf8 string>alien g_value_set_string diff --git a/extra/gir/samples/lowlevel/hello-world/hello-world.factor b/extra/gir/samples/lowlevel/hello-world/hello-world.factor index 6f832167fe..a7068937d6 100644 --- a/extra/gir/samples/lowlevel/hello-world/hello-world.factor +++ b/extra/gir/samples/lowlevel/hello-world/hello-world.factor @@ -23,7 +23,7 @@ IN: gir.samples.lowlevel.hello-world frame label 120 110 gtk_fixed_put button "clicked" utf8 string>alien - [ nip "Hello! :)" utf8 string>alien gtk_label_set_text 1 ] GtkButton:clicked + [ nip "Hello! :)" utf8 string>alien gtk_label_set_text t ] GtkButton:clicked label f 0 g_signal_connect_data drop window ; diff --git a/extra/gir/samples/lowlevel/lowlevel.factor b/extra/gir/samples/lowlevel/lowlevel.factor index 98b8a1ceb6..a3b8201787 100644 --- a/extra/gir/samples/lowlevel/lowlevel.factor +++ b/extra/gir/samples/lowlevel/lowlevel.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.c-types alien.strings byte-arrays +USING: alien.c-types alien.strings byte-arrays classes.struct gtk glib.ffi gobject.ffi gtk.ffi io.encodings.utf8 kernel literals locals make math prettyprint sequences specialized-arrays gir.samples.lowlevel.hello-world @@ -31,12 +31,12 @@ CONSTANT: samples { [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri gtk_tree_view_new :> list - list 0 gtk_tree_view_set_headers_visible + list f gtk_tree_view_set_headers_visible gtk_cell_renderer_text_new :> renderer gtk_tree_view_column_new :> column column "Sample" utf8 string>alien gtk_tree_view_column_set_title - column renderer 1 gtk_tree_view_column_pack_start + column renderer t gtk_tree_view_column_pack_start column renderer "markup" utf8 string>alien 0 gtk_tree_view_column_add_attribute list column gtk_tree_view_append_column drop @@ -47,11 +47,8 @@ CONSTANT: samples { store g_object_unref - ! Временный фикс, нужно придумать что-то другое, так как нет - ! конструктора для создания GtkTreeIter - gint gpointer [ heap-size ] bi@ 3 * + :> iter - - GType gint64 [ heap-size ] bi@ 2 * + :> value + GtkTreeIter :> iter + GValue :> value value G_TYPE_STRING g_value_init drop samples [ first2 swap [ "" % % "\n" % % ] "" make @@ -66,8 +63,8 @@ CONSTANT: samples { list "row-activated" utf8 string>alien - [ list-on-row-activited ] GtkTreeView:row-activated dup . - f f 0 g_signal_connect_data . + [ list-on-row-activited ] GtkTreeView:row-activated + f f 0 g_signal_connect_data drop window "destroy" utf8 string>alien [ 2drop gtk_main_quit ] GtkObject:destroy diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gir/samples/lowlevel/opengl/opengl.factor index bf3dd06edf..284a8c342f 100644 --- a/extra/gir/samples/lowlevel/opengl/opengl.factor +++ b/extra/gir/samples/lowlevel/opengl/opengl.factor @@ -1,29 +1,27 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.strings gtk gobject.ffi gtk.ffi gdk.gl gtk.gl gdk.gl.ffi +USING: alien.enums alien.strings gtk gobject.ffi gtk.ffi gdk.gl gtk.gl gdk.gl.ffi gtk.gl.ffi io.encodings.utf8 kernel locals math opengl.gl prettyprint ; IN: gir.samples.lowlevel.opengl -! Sample based on +! This sample based on ! http://code.valaide.org/content/simple-opengl-sample-using-gtkglext :: on-configure ( sender event user-data -- result ) sender gtk_widget_get_gl_context :> gl-context sender gtk_widget_get_gl_window :> gl-drawable - gl-drawable gl-context gdk_gl_drawable_gl_begin 1 = + gl-drawable gl-context gdk_gl_drawable_gl_begin dup [ 0 0 200 200 glViewport gl-drawable gdk_gl_drawable_gl_end - 1 - ] - [ 0 ] if ; + ] when ; :: on-expose ( sender event user-data -- result ) sender gtk_widget_get_gl_context :> gl-context sender gtk_widget_get_gl_window :> gl-drawable - gl-drawable gl-context gdk_gl_drawable_gl_begin 1 = + gl-drawable gl-context gdk_gl_drawable_gl_begin dup [ GL_COLOR_BUFFER_BIT glClear @@ -41,9 +39,7 @@ IN: gir.samples.lowlevel.opengl [ glFlush ] if gl-drawable gdk_gl_drawable_gl_end - 1 - ] - [ 0 ] if ; + ] when ; :: opengl-win ( -- window ) GTK_WINDOW_TOPLEVEL gtk_window_new :> window @@ -53,12 +49,10 @@ IN: gir.samples.lowlevel.opengl [ 200 200 gtk_window_set_default_size ] [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri - ! window 1 gtk_container_set_reallocate_redraws - - GDK_GL_MODE_RGBA GDK_GL_MODE_DOUBLE bitor + GDK_GL_MODE_RGBA enum>number gdk_gl_config_new_by_mode :> gl-config - window gl-config f 1 GDK_GL_RGBA_TYPE + window gl-config f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability drop window "configure-event" utf8 string>alien From d94cb7543d9a00a0ee7b4ead3aef5b918ccfc20c Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:09:26 +0600 Subject: [PATCH 07/76] Gtk-based ui backend --- basis/ui/backend/gtk/authors.txt | 1 + basis/ui/backend/gtk/gtk.factor | 315 +++++++++++++++++++++++++++++++ 2 files changed, 316 insertions(+) create mode 100644 basis/ui/backend/gtk/authors.txt create mode 100644 basis/ui/backend/gtk/gtk.factor diff --git a/basis/ui/backend/gtk/authors.txt b/basis/ui/backend/gtk/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/ui/backend/gtk/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor new file mode 100644 index 0000000000..4f2bf1e2b7 --- /dev/null +++ b/basis/ui/backend/gtk/gtk.factor @@ -0,0 +1,315 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien.enums alien.strings arrays ascii assocs +classes.struct combinators.short-circuit command-line destructors +io.encodings.utf8 kernel literals locals math namespaces +sequences strings ui ui.backend ui.clipboards ui.event-loop +ui.gadgets ui.gadgets.private ui.gestures ui.private +glib glib.ffi gobject gobject.ffi gtk gtk.ffi gdk gdk.ffi +gdk.gl gtk.gl gdk.gl.ffi gtk.gl.ffi ; +IN: ui.backend.gtk + +SINGLETON: gtk-ui-backend + +TUPLE: handle ; +TUPLE: window-handle < handle window fullscreen? ; + +: ( window -- window-handle ) + [ window-handle new ] dip >>window ; + +TUPLE: gtk-clipboard handle ; + +C: gtk-clipboard + +CONSTANT: events-mask + { + GDK_POINTER_MOTION_MASK + GDK_POINTER_MOTION_HINT_MASK + GDK_ENTER_NOTIFY_MASK + GDK_LEAVE_NOTIFY_MASK + GDK_BUTTON_PRESS_MASK + GDK_BUTTON_RELEASE_MASK + GDK_KEY_PRESS_MASK + GDK_KEY_RELEASE_MASK + GDK_FOCUS_CHANGE_MASK + } + +CONSTANT: modifiers + { + { S+ $[ GDK_SHIFT_MASK enum>number ] } + { C+ $[ GDK_CONTROL_MASK enum>number ] } + { A+ $[ GDK_META_MASK enum>number ] } + } + +CONSTANT: action-key-codes + H{ + ${ GDK_BackSpace "BACKSPACE" } + ${ GDK_Tab "TAB" } + ${ GDK_Return "RET" } + ${ GDK_KP_Enter "ENTER" } + ${ GDK_Escape "ESC" } + ${ GDK_Delete "DELETE" } + ${ GDK_Home "HOME" } + ${ GDK_Left "LEFT" } + ${ GDK_Up "UP" } + ${ GDK_Right "RIGHT" } + ${ GDK_Down "DOWN" } + ${ GDK_Page_Up "PAGE_UP" } + ${ GDK_Page_Down "PAGE_DOWN" } + ${ GDK_End "END" } + ${ GDK_Begin "BEGIN" } + ${ GDK_F1 "F1" } + ${ GDK_F2 "F2" } + ${ GDK_F3 "F3" } + ${ GDK_F4 "F4" } + ${ GDK_F5 "F5" } + ${ GDK_F6 "F6" } + ${ GDK_F7 "F7" } + ${ GDK_F8 "F8" } + ${ GDK_F9 "F9" } + ${ GDK_F10 "F10" } + ${ GDK_F11 "F11" } + ${ GDK_F12 "F12" } + } + +: event-modifiers ( event -- seq ) + state>> modifiers modifier ; + +: event-loc ( event -- loc ) + [ x>> ] [ y>> ] bi [ >fixnum ] bi@ 2array ; + +: event-dim ( event -- dim ) + [ width>> ] [ height>> ] bi 2array ; + +: scroll-direction ( event -- pair ) + direction>> { + ${ GDK_SCROLL_UP { 0 -1 } } + ${ GDK_SCROLL_DOWN { 0 1 } } + ${ GDK_SCROLL_LEFT { -1 0 } } + ${ GDK_SCROLL_RIGHT { 1 0 } } + } at ; + +: mouse-event>gesture ( event -- modifiers button loc ) + [ event-modifiers ] [ button>> ] [ event-loc ] tri ; + +: on-motion ( sender event user-data -- result ) + drop swap + [ GdkEventMotion memory>struct event-loc ] dip window + move-hand fire-motion t ; + +: on-enter ( sender event user-data -- result ) + on-motion ; + +: on-leave ( sender event user-data -- result ) + 3drop forget-rollover t ; + +: on-button-press ( sender event user-data -- result ) + drop swap [ + GdkEventButton memory>struct + mouse-event>gesture [ ] dip + ] dip window send-button-down t ; + +: on-button-release ( sender event user-data -- result ) + drop swap [ + GdkEventButton memory>struct + mouse-event>gesture [ ] dip + ] dip window send-button-up t ; + +: on-scroll ( sender event user-data -- result ) + drop swap [ + GdkEventScroll memory>struct + [ scroll-direction ] [ event-loc ] bi + ] dip window send-scroll t ; + +: key-sym ( event -- sym action? ) + keyval>> dup action-key-codes at + [ t ] [ gdk_keyval_to_unicode 1string f ] ?if ; + +: key-event>gesture ( event -- modifiers sym action? ) + [ event-modifiers ] [ key-sym ] bi ; + +: valid-input? ( string gesture -- ? ) + over empty? [ 2drop f ] [ + mods>> { f { S+ } } member? [ + [ { [ 127 = not ] [ CHAR: \s >= ] } 1&& ] all? + ] [ + [ { [ 127 = not ] [ CHAR: \s >= ] [ alpha? not ] } 1&& ] all? + ] if + ] if ; + +:: on-key-press ( sender event user-data -- result ) + sender window :> world + event GdkEventKey memory>struct :> ev + ev key-event>gesture :> gesture + gesture world propagate-key-gesture + ev keyval>> gdk_keyval_to_unicode 1string dup + gesture valid-input? + [ world user-input ] [ drop ] if + t ; + +: on-key-release ( sender event user-data -- result ) + drop swap [ + GdkEventKey memory>struct + key-event>gesture + ] dip window propagate-key-gesture t ; + +: on-focus-in ( sender event user-data -- result ) + 2drop window focus-world t ; + +: on-focus-out ( sender event user-data -- result ) + 2drop window unfocus-world t ; + +: on-expose ( sender event user-data -- result ) + 2drop window relayout t ; + +: on-configure ( sender event user-data -- result ) + drop [ window ] dip GdkEventConfigure memory>struct + [ event-loc >>window-loc ] [ event-dim >>dim ] bi + relayout-1 t ; + +: on-delete ( sender event user-data -- result ) + 2drop window ungraft t ; + +: init-clipboard ( -- ) + selection "PRIMARY" + clipboard "CLIPBOARD" + [ + utf8 string>alien gdk_atom_intern_static_string + gtk_clipboard_get swap set-global + ] 2bi@ ; + +M: gtk-ui-backend do-events + f gtk_main_iteration_do drop ui-wait ; + +M: gtk-ui-backend (with-ui) + [ + f f gtk_init + f f gtk_gl_init + init-clipboard + start-ui + event-loop + ] ui-running ; + +: connect-signal ( object signal-name callback -- ) + [ utf8 string>alien ] dip f f 0 g_signal_connect_data drop ; + +:: connect-signals ( win -- ) + win events-mask [ enum>number ] [ bitor ] map-reduce + gtk_widget_add_events + + win "expose-event" [ on-expose ] + GtkWidget:expose-event connect-signal + win "configure-event" [ on-configure ] + GtkWidget:configure-event connect-signal + win "motion-notify-event" [ on-motion ] + GtkWidget:motion-notify-event connect-signal + win "leave-notify-event" [ on-leave ] + GtkWidget:leave-notify-event connect-signal + win "enter-notify-event" [ on-enter ] + GtkWidget:enter-notify-event connect-signal + win "button-press-event" [ on-button-press ] + GtkWidget:button-press-event connect-signal + win "button-release-event" [ on-button-release ] + GtkWidget:button-release-event connect-signal + win "scroll-event" [ on-scroll ] + GtkWidget:scroll-event connect-signal + win "key-press-event" [ on-key-press ] + GtkWidget:key-press-event connect-signal + win "key-release-event" [ on-key-release ] + GtkWidget:key-release-event connect-signal + win "focus-in-event" [ on-focus-in ] + GtkWidget:focus-in-event connect-signal + win "focus-out-event" [ on-focus-out ] + GtkWidget:focus-out-event connect-signal + win "delete-event" [ on-delete ] + GtkWidget:delete-event connect-signal ; + +: enable-gl ( win -- ? ) + ${ + GDK_GL_MODE_RGBA + GDK_GL_MODE_DOUBLE + GDK_GL_MODE_DEPTH + GDK_GL_MODE_STENCIL + GDK_GL_MODE_ALPHA + } [ enum>number ] [ bitor ] map-reduce + gdk_gl_config_new_by_mode + f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability ; + +M:: gtk-ui-backend (open-window) ( world -- ) + GTK_WINDOW_TOPLEVEL gtk_window_new :> win + world [ window-loc>> win swap first2 gtk_window_move ] + [ dim>> win swap first2 gtk_window_set_default_size ] bi + + win enable-gl drop ! сделать проверку на доступность OpenGL + + win connect-signals + + win world handle<< + world win register-window + + win gtk_widget_show_all ; + +M: gtk-ui-backend (close-window) ( handle -- ) + window>> [ unregister-window ] [ gtk_widget_destroy ] bi ; + +M: gtk-ui-backend set-title + swap [ handle>> window>> ] [ utf8 string>alien ] bi* + gtk_window_set_title ; + +M: gtk-ui-backend (set-fullscreen) + [ handle>> ] dip [ >>fullscreen? ] keep + [ window>> ] dip + [ gtk_window_fullscreen ] + [ gtk_window_unfullscreen ] if ; + +M: gtk-ui-backend (fullscreen?) + handle>> fullscreen?>> ; + +M: gtk-ui-backend raise-window* + handle>> window>> gtk_window_present ; + +: set-cursor ( win cursor -- ) + [ + [ gtk_widget_get_window ] dip + gdk_cursor_new &gdk_cursor_unref + gdk_window_set_cursor + ] with-destructors ; + +M: gtk-ui-backend (grab-input) + handle>> window>> + [ gtk_grab_add ] [ GDK_BLANK_CURSOR set-cursor ] bi ; + +M: gtk-ui-backend (ungrab-input) + handle>> window>> + [ gtk_grab_remove ] [ GDK_ARROW set-cursor ] bi ; + +M: window-handle select-gl-context ( handle -- ) + window>> + [ gtk_widget_get_gl_window ] [ gtk_widget_get_gl_context ] bi + gdk_gl_drawable_make_current drop ; + +M: window-handle flush-gl-context ( handle -- ) + window>> gtk_widget_get_gl_window + gdk_gl_drawable_swap_buffers ; + +M: gtk-ui-backend beep + gdk_beep ; + +M:: gtk-ui-backend system-alert ( caption text -- ) + f GTK_DIALOG_MODAL GTK_MESSAGE_WARNING GTK_BUTTONS_OK + caption utf8 string>alien f gtk_message_dialog_new + [ text utf8 string>alien f gtk_message_dialog_format_secondary_text ] + [ gtk_dialog_run drop ] + [ gtk_widget_destroy ] tri ; + +M: gtk-clipboard clipboard-contents + handle>> gtk_clipboard_wait_for_text utf8 alien>string ; + +M: gtk-clipboard set-clipboard-contents + swap [ handle>> ] [ utf8 string>alien ] bi* + -1 gtk_clipboard_set_text ; + +gtk-ui-backend ui-backend set-global + +[ "ui.tools" ] main-vocab-hook set-global + From be272a0bde65f2184f0215529cdcf6a9a46a7fe1 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:10:41 +0600 Subject: [PATCH 08/76] change Pango-based ui.text backend (move all util words from pango and pango.cairo vocabularies to ui.text.pango) --- basis/ui/text/pango/pango.factor | 182 ++++++++++++++++++++++++++++++- 1 file changed, 179 insertions(+), 3 deletions(-) diff --git a/basis/ui/text/pango/pango.factor b/basis/ui/text/pango/pango.factor index 9cea94bec4..b3aa858507 100644 --- a/basis/ui/text/pango/pango.factor +++ b/basis/ui/text/pango/pango.factor @@ -1,10 +1,180 @@ ! Copyright (C) 2009, 2010 Slava Pestov. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors assocs cache kernel math math.vectors -namespaces pango pango.cairo ui.text ui.text.private -sequences ; +USING: accessors alien.c-types alien.strings arrays assocs cache cairo +cairo.ffi classes.struct combinators destructors fonts fry +init io.encodings.utf8 kernel math math.rectangles math.vectors +memoize namespaces sequences ui.text ui.text.private +gobject gobject.ffi pango pango.ffi pango.cairo pango.cairo.ffi ; IN: ui.text.pango +: pango>float ( n -- x ) PANGO_SCALE /f ; inline +: float>pango ( x -- n ) PANGO_SCALE * >integer ; inline + +MEMO: (cache-font-description) ( font -- description ) + [ + [ pango_font_description_new |pango_font_description_free ] dip { + [ name>> utf8 string>alien pango_font_description_set_family ] + [ size>> float>pango pango_font_description_set_size ] + [ bold?>> PANGO_WEIGHT_BOLD PANGO_WEIGHT_NORMAL ? pango_font_description_set_weight ] + [ italic?>> PANGO_STYLE_ITALIC PANGO_STYLE_NORMAL ? pango_font_description_set_style ] + [ drop ] + } 2cleave + ] with-destructors ; + +: cache-font-description ( font -- description ) + strip-font-colors (cache-font-description) ; + + +TUPLE: layout < disposable font string selection layout metrics ink-rect logical-rect image ; + +SYMBOL: dpi + +72 dpi set-global + +: set-layout-font ( font layout -- ) + swap cache-font-description pango_layout_set_font_description ; + +: set-layout-text ( str layout -- ) + swap utf8 string>alien -1 pango_layout_set_text ; + +: PangoRectangle>rect ( PangoRectangle -- rect ) + [ [ x>> pango>float ] [ y>> pango>float ] bi 2array ] + [ [ width>> pango>float ] [ height>> pango>float ] bi 2array ] bi + ; + +: layout-extents ( layout -- ink-rect logical-rect ) + PangoRectangle + PangoRectangle + [ pango_layout_get_extents ] 2keep + [ PangoRectangle>rect ] bi@ ; + +: layout-baseline ( layout -- baseline ) + pango_layout_get_iter &pango_layout_iter_free + pango_layout_iter_get_baseline + pango>float ; + +: set-foreground ( cr font -- ) + foreground>> set-source-color ; + +: fill-background ( cr font dim -- ) + [ background>> set-source-color ] + [ [ { 0 0 } ] dip fill-rect ] bi-curry* bi ; + +: rect-translate-x ( rect x -- rect' ) + '[ _ 0 2array v- ] change-loc ; + +: first-line ( layout -- line ) + layout>> 0 pango_layout_get_line_readonly ; + +: line-offset>x ( layout n -- x ) + #! n is an index into the UTF8 encoding of the text + [ drop first-line ] [ swap string>> >utf8-index ] 2bi + 0 0 [ pango_layout_line_index_to_x ] keep + *int pango>float ; + +: x>line-offset ( layout x -- n ) + #! n is an index into the UTF8 encoding of the text + [ + [ first-line ] dip + float>pango 0 0 + [ pango_layout_line_x_to_index drop ] 2keep + [ *int ] bi@ swap + ] [ drop string>> ] 2bi utf8-index> + ; + +: selection-start/end ( selection -- start end ) + selection>> [ start>> ] [ end>> ] bi ; + +: selection-rect ( layout -- rect ) + [ ink-rect>> dim>> ] [ ] [ selection-start/end ] tri [ line-offset>x ] bi-curry@ bi + [ drop nip 0 2array ] [ swap - swap second 2array ] 3bi ; + +: fill-selection-background ( cr layout -- ) + dup selection>> [ + [ selection>> color>> set-source-color ] + [ + [ selection-rect ] [ ink-rect>> loc>> first ] bi + rect-translate-x + fill-rect + ] 2bi + ] [ 2drop ] if ; + +: text-position ( layout -- loc ) + [ logical-rect>> ] [ ink-rect>> ] bi [ loc>> ] bi@ v- ; + +: set-text-position ( cr loc -- ) + first2 cairo_move_to ; + +: draw-layout ( layout -- image ) + dup ink-rect>> dim>> [ >fixnum ] map [ + swap { + [ layout>> pango_cairo_update_layout ] + [ [ font>> ] [ ink-rect>> dim>> ] bi fill-background ] + [ fill-selection-background ] + [ text-position set-text-position ] + [ font>> set-foreground ] + [ layout>> pango_cairo_show_layout ] + } 2cleave + ] make-bitmap-image ; + +: escape-nulls ( str -- str' ) + #! Replace nulls with something else since Pango uses null-terminated + #! strings + { { 0 CHAR: zero-width-no-break-space } } substitute ; + +: unpack-selection ( layout string/selection -- layout ) + dup selection? [ + [ string>> escape-nulls >>string ] [ >>selection ] bi + ] [ escape-nulls >>string ] if ; inline + +: set-layout-resolution ( layout -- ) + pango_layout_get_context dpi get pango_cairo_context_set_resolution ; + +: ( text font -- layout ) + dummy-cairo pango_cairo_create_layout |g_object_unref + [ set-layout-resolution ] keep + [ set-layout-font ] keep + [ set-layout-text ] keep ; + +: glyph-height ( font string -- y ) + swap &g_object_unref layout-extents drop dim>> second ; + +MEMO: missing-font-metrics ( font -- metrics ) + #! Pango doesn't provide x-height and cap-height but Core Text does, so we + #! simulate them on Pango. + [ + [ metrics new ] dip + [ "x" glyph-height >>x-height ] + [ "Y" glyph-height >>cap-height ] bi + ] with-destructors ; + +: layout-metrics ( layout -- metrics ) + dup font>> missing-font-metrics clone + swap + [ layout>> layout-baseline >>ascent ] + [ logical-rect>> dim>> [ first >>width ] [ second >>height ] bi ] bi + dup [ height>> ] [ ascent>> ] bi - >>descent ; + +: ( font string -- line ) + [ + layout new-disposable + swap unpack-selection + swap >>font + dup [ string>> ] [ font>> ] bi >>layout + dup layout>> layout-extents [ >>ink-rect ] [ >>logical-rect ] bi* + dup layout-metrics >>metrics + dup draw-layout >>image + ] with-destructors ; + +M: layout dispose* layout>> g_object_unref ; + +SYMBOL: cached-layouts + +: cached-layout ( font string -- layout ) + cached-layouts get [ ] 2cache ; + +: cached-line ( font string -- line ) + cached-layout layout>> first-line ; + SINGLETON: pango-renderer M: pango-renderer string-dim @@ -31,4 +201,10 @@ M: pango-renderer line-metrics ( font string -- metrics ) [ cached-layout metrics>> ] if-empty ; +[ + \ (cache-font-description) reset-memoized + cached-layouts set-global +] "ui.text.pango" add-startup-hook + pango-renderer font-renderer set-global + From bfe6cba08dc012450c741190cff2b9599fe5c274 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 16:14:21 +0600 Subject: [PATCH 09/76] set Gtk-based ui backend as default on unix --- basis/bootstrap/ui/ui.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/bootstrap/ui/ui.factor b/basis/bootstrap/ui/ui.factor index 271a99c223..7c1c2674e5 100644 --- a/basis/bootstrap/ui/ui.factor +++ b/basis/bootstrap/ui/ui.factor @@ -7,7 +7,7 @@ IN: bootstrap.ui { { [ os macosx? ] [ "cocoa" ] } { [ os windows? ] [ "windows" ] } - { [ os unix? ] [ "x11" ] } + { [ os unix? ] [ "gtk" ] } } cond ] unless* "ui.backend." prepend require ] when From 19634c8757dad99abb47d9b574bfe9d525f46f14 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 20:28:44 +0600 Subject: [PATCH 10/76] fix a bug with incorrect cursor position --- basis/ui/text/pango/pango.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/ui/text/pango/pango.factor b/basis/ui/text/pango/pango.factor index b3aa858507..634242b692 100644 --- a/basis/ui/text/pango/pango.factor +++ b/basis/ui/text/pango/pango.factor @@ -69,7 +69,7 @@ SYMBOL: dpi : line-offset>x ( layout n -- x ) #! n is an index into the UTF8 encoding of the text [ drop first-line ] [ swap string>> >utf8-index ] 2bi - 0 0 [ pango_layout_line_index_to_x ] keep + f 0 [ pango_layout_line_index_to_x ] keep *int pango>float ; : x>line-offset ( layout x -- n ) From 79e4297245013d880a6b7653f5d409da550ab148 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 23 May 2010 21:26:11 +0600 Subject: [PATCH 11/76] fix Alt-combos bug --- basis/ui/backend/gtk/gtk.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 4f2bf1e2b7..3b45a47427 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -38,7 +38,7 @@ CONSTANT: modifiers { { S+ $[ GDK_SHIFT_MASK enum>number ] } { C+ $[ GDK_CONTROL_MASK enum>number ] } - { A+ $[ GDK_META_MASK enum>number ] } + { A+ $[ GDK_MOD1_MASK enum>number ] } } CONSTANT: action-key-codes From 67df0a783f1a08dac3fbea79d732bda5806fd938 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 24 May 2010 16:08:26 +0600 Subject: [PATCH 12/76] add window-controls implementation (without 'textured-background') --- basis/ui/backend/gtk/gtk.factor | 48 ++++++++++++++++++++++++++++++--- 1 file changed, 44 insertions(+), 4 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 3b45a47427..b984c46563 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -2,9 +2,9 @@ ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.enums alien.strings arrays ascii assocs classes.struct combinators.short-circuit command-line destructors -io.encodings.utf8 kernel literals locals math namespaces -sequences strings ui ui.backend ui.clipboards ui.event-loop -ui.gadgets ui.gadgets.private ui.gestures ui.private +io.encodings.utf8 kernel literals locals math math.bitwise +namespaces sequences strings ui ui.backend ui.clipboards ui.event-loop +ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures ui.private glib glib.ffi gobject gobject.ffi gtk gtk.ffi gdk gdk.ffi gdk.gl gtk.gl gdk.gl.ffi gtk.gl.ffi ; IN: ui.backend.gtk @@ -235,14 +235,54 @@ M: gtk-ui-backend (with-ui) gdk_gl_config_new_by_mode f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability ; +CONSTANT: window-controls>decor-flags + H{ + { close-button 0 } + { minimize-button $[ GDK_DECOR_MINIMIZE enum>number ] } + { maximize-button $[ GDK_DECOR_MAXIMIZE enum>number ] } + { resize-handles $[ GDK_DECOR_RESIZEH enum>number ] } + { small-title-bar $[ GDK_DECOR_TITLE enum>number ] } + { normal-title-bar $[ GDK_DECOR_TITLE enum>number ] } + { textured-background 0 } + } + +CONSTANT: window-controls>func-flags + H{ + { close-button $[ GDK_FUNC_CLOSE enum>number ] } + { minimize-button $[ GDK_FUNC_MINIMIZE enum>number ] } + { maximize-button $[ GDK_FUNC_MAXIMIZE enum>number ] } + { resize-handles $[ GDK_FUNC_RESIZE enum>number ] } + { small-title-bar 0 } + { normal-title-bar 0 } + { textured-background 0 } + } + +: configure-window-controls ( win controls -- ) + [ + small-title-bar swap member-eq? + GDK_WINDOW_TYPE_HINT_UTILITY GDK_WINDOW_TYPE_HINT_NORMAL ? + gtk_window_set_type_hint + ] [ + [ gtk_widget_get_window ] dip + window-controls>decor-flags symbols>flags + GDK_DECOR_BORDER enum>number bitor gdk_window_set_decorations + ] [ + [ gtk_widget_get_window ] dip + window-controls>func-flags symbols>flags + GDK_FUNC_MOVE enum>number bitor gdk_window_set_functions + ] 2tri ; + M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win world [ window-loc>> win swap first2 gtk_window_move ] [ dim>> win swap first2 gtk_window_set_default_size ] bi win enable-gl drop ! сделать проверку на доступность OpenGL - + win connect-signals + + win gtk_widget_realize + win world window-controls>> configure-window-controls win world handle<< world win register-window From c6d2f4956a5ef58da7299905ea620c251e1e0106 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 24 May 2010 19:22:29 +0600 Subject: [PATCH 13/76] add opengl.gl.gtk backend --- basis/opengl/gl/extensions/extensions.factor | 2 +- basis/opengl/gl/gtk/authors.txt | 1 + basis/opengl/gl/gtk/gtk.factor | 14 ++++++++++++++ 3 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 basis/opengl/gl/gtk/authors.txt create mode 100644 basis/opengl/gl/gtk/gtk.factor diff --git a/basis/opengl/gl/extensions/extensions.factor b/basis/opengl/gl/extensions/extensions.factor index 530f3ada6c..327b552fa2 100644 --- a/basis/opengl/gl/extensions/extensions.factor +++ b/basis/opengl/gl/extensions/extensions.factor @@ -7,7 +7,7 @@ ERROR: unknown-gl-platform ; << { { [ os windows? ] [ "opengl.gl.windows" ] } { [ os macosx? ] [ "opengl.gl.macosx" ] } - { [ os unix? ] [ "opengl.gl.unix" ] } + { [ os unix? ] [ "opengl.gl.gtk" ] } [ unknown-gl-platform ] } cond use-vocab >> diff --git a/basis/opengl/gl/gtk/authors.txt b/basis/opengl/gl/gtk/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/opengl/gl/gtk/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/opengl/gl/gtk/gtk.factor b/basis/opengl/gl/gtk/gtk.factor new file mode 100644 index 0000000000..fef80313f2 --- /dev/null +++ b/basis/opengl/gl/gtk/gtk.factor @@ -0,0 +1,14 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.strings io.encodings.ascii +gdk.gl gdk.gl.ffi ; +IN: opengl.gl.gtk + +: gl-function-context ( -- context ) + gdk_gl_context_get_current ; inline + +: gl-function-address ( name -- address ) + ascii string>alien gdk_gl_get_proc_address ; inline + +: gl-function-calling-convention ( -- str ) cdecl ; inline + From 2677b7b562c22b7b8b4c4e1be61f6216c222d71b Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 24 May 2010 19:47:16 +0600 Subject: [PATCH 14/76] change typedef of gboolean (gint with automatic boxing/unboxing to/from factor's t and f) --- basis/glib/glib.factor | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/basis/glib/glib.factor b/basis/glib/glib.factor index 903915be99..454484c6a1 100644 --- a/basis/glib/glib.factor +++ b/basis/glib/glib.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries alien.syntax combinators gir -kernel system vocabs.parser words ; +USING: accessors alien alien.c-types alien.libraries alien.syntax +combinators compiler.units gir kernel system vocabs.parser words ; << "glib" { @@ -23,7 +23,15 @@ TYPEDEF: long glong TYPEDEF: ulong gulong TYPEDEF: int gint TYPEDEF: uint guint -TYPEDEF: bool gboolean + +SYMBOL: gboolean +<< +gint c-type clone + [ >c-bool ] >>unboxer-quot + [ c-bool> ] >>boxer-quot + object >>boxed-class +gboolean typedef +>> TYPEDEF: char gint8 TYPEDEF: uchar guint8 From 17192dee7cb64ce37b136a48e29cc12536c33c6a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Thu, 27 May 2010 00:17:14 +0600 Subject: [PATCH 15/76] change directories structure (add */ffi/ffi.factor files) --- basis/atk/atk.factor | 20 +----- basis/atk/ffi/ffi.factor | 20 ++++++ basis/gdk/ffi/ffi.factor | 30 ++++++++ basis/gdk/gdk.factor | 32 +-------- basis/gdk/gl/ffi/ffi.factor | 20 ++++++ basis/gdk/gl/gl.factor | 19 +---- basis/gdk/pixbuf/ffi/ffi.factor | 17 +++++ basis/gdk/pixbuf/pixbuf.factor | 15 +--- basis/gio/ffi/ffi.factor | 17 +++++ basis/gio/gio.factor | 15 +--- basis/gir/common/common.factor | 6 -- basis/gir/ffi/ffi.factor | 14 ++-- basis/gir/gir.factor | 16 ++--- basis/gir/loader/loader.factor | 7 +- basis/gir/types/types.factor | 2 +- basis/glib/ffi/ffi.factor | 70 ++++++++++++++++++ basis/glib/glib.factor | 72 +------------------ basis/gmodule/ffi/ffi.factor | 16 +++++ basis/gmodule/gmodule.factor | 14 +--- basis/gobject/ffi/ffi.factor | 56 +++++++++++++++ basis/gobject/gobject.factor | 59 +-------------- basis/gst/ffi/ffi.factor | 27 +++++++ basis/gst/gst.factor | 27 +------ basis/gtk/ffi/ffi.factor | 26 +++++++ basis/gtk/gl/ffi/ffi.factor | 18 +++++ basis/gtk/gl/gl.factor | 15 +--- basis/gtk/gtk.factor | 25 +------ basis/opengl/gl/gtk/gtk.factor | 2 +- basis/pango/cairo/cairo.factor | 26 +------ basis/pango/cairo/ffi/ffi.factor | 26 +++++++ basis/pango/ffi/ffi.factor | 25 +++++++ basis/pango/pango.factor | 27 +------ basis/ui/backend/gtk/gtk.factor | 9 ++- basis/ui/text/pango/pango.factor | 2 +- .../lowlevel/gstreamer/gstreamer.factor | 2 +- .../lowlevel/hello-world/hello-world.factor | 2 +- extra/gir/samples/lowlevel/lowlevel.factor | 2 +- .../gir/samples/lowlevel/opengl/opengl.factor | 2 +- 38 files changed, 419 insertions(+), 381 deletions(-) create mode 100644 basis/atk/ffi/ffi.factor create mode 100644 basis/gdk/ffi/ffi.factor create mode 100644 basis/gdk/gl/ffi/ffi.factor create mode 100644 basis/gdk/pixbuf/ffi/ffi.factor create mode 100644 basis/gio/ffi/ffi.factor create mode 100644 basis/glib/ffi/ffi.factor create mode 100644 basis/gmodule/ffi/ffi.factor create mode 100644 basis/gobject/ffi/ffi.factor create mode 100644 basis/gst/ffi/ffi.factor create mode 100644 basis/gtk/ffi/ffi.factor create mode 100644 basis/gtk/gl/ffi/ffi.factor create mode 100644 basis/pango/cairo/ffi/ffi.factor create mode 100644 basis/pango/ffi/ffi.factor diff --git a/basis/atk/atk.factor b/basis/atk/atk.factor index 66f091ab19..a27f470902 100644 --- a/basis/atk/atk.factor +++ b/basis/atk/atk.factor @@ -1,21 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries alien.syntax combinators kernel -system -gir glib gobject glib.ffi ; - -<< -"atk" { - { [ os winnt? ] [ "libatk-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libatk-1.0.so" cdecl add-library ] } -} cond ->> - -IN: atk.ffi - -TYPEDEF: guint64 AtkState -TYPEDEF: GSList AtkAttributeSet - -IN-GIR: atk vocab:atk/Atk-1.0.gir +USING: atk.ffi ; +IN: atk diff --git a/basis/atk/ffi/ffi.factor b/basis/atk/ffi/ffi.factor new file mode 100644 index 0000000000..e78948b378 --- /dev/null +++ b/basis/atk/ffi/ffi.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries alien.syntax combinators kernel +system +gir glib.ffi gobject.ffi ; +IN: atk.ffi + +<< +"atk" { + { [ os winnt? ] [ "libatk-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libatk-1.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: guint64 AtkState +TYPEDEF: GSList AtkAttributeSet + +GIR: vocab:atk/Atk-1.0.gir + diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor new file mode 100644 index 0000000000..7458234205 --- /dev/null +++ b/basis/gdk/ffi/ffi.factor @@ -0,0 +1,30 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.destructors alien.syntax +alien.libraries cairo.ffi combinators kernel system +gir gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi gobject.ffi +pango.ffi ; +IN: gdk.ffi + +<< +"gdk" { + { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdk-x11-2.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: guint32 GdkNativeWindow +TYPEDEF: guint32 GdkWChar + +IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton +GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility +GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty +GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient +GdkEventNoExpose GdkEventWindowState GdkEventSetting +GdkEventOwnerChange GdkEventGrabBroken ; + +GIR: vocab:gdk/Gdk-2.0.gir + +DESTRUCTOR: gdk_cursor_unref + diff --git a/basis/gdk/gdk.factor b/basis/gdk/gdk.factor index bf6accd57b..fa7c4d1c95 100644 --- a/basis/gdk/gdk.factor +++ b/basis/gdk/gdk.factor @@ -1,33 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.destructors alien.syntax alien.libraries cairo.ffi -combinators kernel system -gir glib gobject gio gmodule gdk.pixbuf glib.ffi ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gdk" { - { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdk-x11-2.0.so" cdecl add-library ] } -} cond ->> - -IN: gdk.ffi - -TYPEDEF: guint32 GdkNativeWindow -TYPEDEF: guint32 GdkWChar - -IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton -GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility -GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty -GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient -GdkEventNoExpose GdkEventWindowState GdkEventSetting -GdkEventOwnerChange GdkEventGrabBroken ; - -IN-GIR: gdk vocab:gdk/Gdk-2.0.gir - -IN: gdk.ffi - -DESTRUCTOR: gdk_cursor_unref +USING: gdk.ffi ; +IN: gdk diff --git a/basis/gdk/gl/ffi/ffi.factor b/basis/gdk/gl/ffi/ffi.factor new file mode 100644 index 0000000000..5c57fe0013 --- /dev/null +++ b/basis/gdk/gl/ffi/ffi.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system vocabs.parser words +gir gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi +gobject.ffi pango.ffi ; +IN: gdk.gl.ffi + +<< +"gdk.gl" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdkglext-x11-1.0.so" cdecl add-library ] } +} cond +>> + +<< ulong "unsigned long" current-vocab create typedef >> + +GIR: vocab:gdk/gl/GdkGL-1.0.gir + diff --git a/basis/gdk/gl/gl.factor b/basis/gdk/gl/gl.factor index f8c3bd26ee..ab64b5f8fa 100644 --- a/basis/gdk/gl/gl.factor +++ b/basis/gdk/gl/gl.factor @@ -1,20 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system vocabs.parser words -gir glib gobject gio gmodule gdk gdk.ffi gdk.pixbuf ; - -<< -"gdk.gl" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdkglext-x11-1.0.so" cdecl add-library ] } -} cond ->> - -IN: gdk.gl.ffi - -<< ulong "unsigned long" current-vocab create typedef >> - -IN-GIR: gdk.gl vocab:gdk/gl/GdkGL-1.0.gir +USING: gdk.gl.ffi ; +IN: gdk.gl diff --git a/basis/gdk/pixbuf/ffi/ffi.factor b/basis/gdk/pixbuf/ffi/ffi.factor new file mode 100644 index 0000000000..12e56753e1 --- /dev/null +++ b/basis/gdk/pixbuf/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gir gio.ffi glib.ffi gmodule.ffi gobject.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gdk.pixbuf.ffi + +<< +"gdk.pixbuf" { + { [ os winnt? ] [ "libgdk_pixbuf-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgdk_pixbuf-2.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gdk/pixbuf/GdkPixbuf-2.0.gir + diff --git a/basis/gdk/pixbuf/pixbuf.factor b/basis/gdk/pixbuf/pixbuf.factor index 02fdccc3bb..35bbe9ae2c 100644 --- a/basis/gdk/pixbuf/pixbuf.factor +++ b/basis/gdk/pixbuf/pixbuf.factor @@ -1,16 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gir glib gobject gio gmodule ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gdk.pixbuf" { - { [ os winnt? ] [ "libgdk_pixbuf-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdk_pixbuf-2.0.so" cdecl add-library ] } -} cond ->> - -IN-GIR: gdk.pixbuf vocab:gdk/pixbuf/GdkPixbuf-2.0.gir +USING: gdk.pixbuf.ffi ; +IN: gdk.pixbuf diff --git a/basis/gio/ffi/ffi.factor b/basis/gio/ffi/ffi.factor new file mode 100644 index 0000000000..16056f1fb5 --- /dev/null +++ b/basis/gio/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gir glib.ffi gobject.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gio.ffi + +<< +"gio" { + { [ os winnt? ] [ "libgio-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgio-2.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gio/Gio-2.0.gir + diff --git a/basis/gio/gio.factor b/basis/gio/gio.factor index 451bbeeded..6ab6d1ff14 100644 --- a/basis/gio/gio.factor +++ b/basis/gio/gio.factor @@ -1,16 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gir glib gobject ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gio" { - { [ os winnt? ] [ "libgio-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgio-2.0.so" cdecl add-library ] } -} cond ->> - -IN-GIR: gio vocab:gio/Gio-2.0.gir +USING: gio.ffi ; +IN: gio diff --git a/basis/gir/common/common.factor b/basis/gir/common/common.factor index f5513d9424..d4984607b4 100644 --- a/basis/gir/common/common.factor +++ b/basis/gir/common/common.factor @@ -7,9 +7,6 @@ CONSTANT: ffi-vocab "ffi" SYMBOL: current-lib -SYMBOL: lib-aliases -lib-aliases [ H{ } ] initialize - SYMBOL: type-infos type-infos [ H{ } ] initialize @@ -18,6 +15,3 @@ aliases [ H{ } ] initialize SYMBOL: implement-structs -: get-lib-alias ( lib -- alias ) - lib-aliases get-global at ; - diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index 81373842a2..88c2ceb40e 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -16,7 +16,7 @@ IN: gir.ffi : ffi-invoker ( func -- quot ) { [ return>> c-type>> string>c-type ] - [ drop current-lib get ] + [ drop current-lib get-global ] [ identifier>> ] [ parameters>> [ c-type>> string>c-type ] map ] [ varargs?>> [ void* suffix ] when ] @@ -61,7 +61,7 @@ IN: gir.ffi [ void* swap typedef ] keep dup ] keep [ signal-ffi-effect "callback-effect" set-word-prop ] - [ drop current-lib get "callback-library" set-word-prop ] + [ drop current-lib get-global "callback-library" set-word-prop ] [ signal-ffi-invoker (( quot -- alien )) define-inline ] 2tri ; : define-ffi-signals ( signals class -- ) @@ -161,7 +161,7 @@ IN: gir.ffi [ define-ffi-interface-content ] each ; : get-type-invoker ( name -- quot ) - [ "GType" current-lib get ] dip + [ "GType" current-lib get-global ] dip { } \ alien-invoke 5 narray >quotation ; : define-ffi-class ( class -- word ) @@ -211,11 +211,6 @@ IN: gir.ffi : define-ffi-aliases ( aliases -- ) [ define-ffi-alias ] each ; -: prepare-vocab ( repository -- ) - includes>> lib-aliases get '[ _ at ] map sift - [ ffi-vocab "." glue ] map - [ dup using-vocab? [ drop ] [ use-vocab ] if ] each ; - : define-ffi-namespace ( namespace -- ) { [ aliases>> define-ffi-aliases ] @@ -238,6 +233,5 @@ IN: gir.ffi } cleave ; : define-ffi-repository ( repository -- ) - [ prepare-vocab ] - [ namespace>> define-ffi-namespace ] bi ; + namespace>> define-ffi-namespace ; diff --git a/basis/gir/gir.factor b/basis/gir/gir.factor index 1da49badb9..3c39d8d838 100755 --- a/basis/gir/gir.factor +++ b/basis/gir/gir.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors assocs combinators gir.common gir.ffi gir.loader -kernel lexer locals namespaces sequences vocabs.parser xml ; +kernel lexer locals math namespaces sequences vocabs.parser xml ; IN: gir : with-child-vocab ( name quot -- ) @@ -9,20 +9,18 @@ IN: gir [ swap "." glue set-current-vocab call ] keep set-current-vocab ; inline -:: define-gir-vocab ( vocab-name file-name -- ) +:: define-gir-vocab ( file-name -- ) file-name file>xml xml>repository - vocab-name [ set-current-vocab ] [ current-lib set ] bi + current-vocab name>> dup ffi-vocab tail? + [ ffi-vocab length 1 + head* current-lib set-global ] + [ drop ] if ! throw the error { - [ - namespace>> name>> vocab-name swap - lib-aliases get set-at - ] - [ ffi-vocab [ define-ffi-repository ] with-child-vocab ] + [ define-ffi-repository ] } cleave f implement-structs set-global ; -SYNTAX: IN-GIR: scan scan define-gir-vocab ; +SYNTAX: GIR: scan define-gir-vocab ; SYNTAX: IMPLEMENT-STRUCTS: ";" parse-tokens implement-structs set-global ; diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor index a6fc482c89..3d444bd500 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gir/loader/loader.factor @@ -32,7 +32,7 @@ SYMBOL: namespace-PREFIX : full-type-name>type ( name -- type ) [ type new ] dip camel>factor "." split1 dup [ swap ] unless - [ get-lib-alias >>namespace ] [ >>name ] bi* absolute-type ; + [ >>namespace ] [ >>name ] bi* absolute-type ; : node>type ( xml -- type ) "name" attr full-type-name>type ; @@ -254,7 +254,7 @@ SYMBOL: namespace-PREFIX : xml>namespace ( xml -- namespace ) [ namespace new ] dip { - [ "name" attr camel>factor dup current-lib set >>name ] + [ "name" attr camel>factor >>name ] [ "prefix" attr [ set-prefix ] keep >>prefix ] [ "alias" tags-named [ xml>alias ] map >>aliases ] [ "record" tags-named [ xml>record ] map >>records ] @@ -265,8 +265,7 @@ SYMBOL: namespace-PREFIX [ "constant" tags-named [ xml>const ] map >>consts ] [ "enumeration" tags-named [ xml>enum ] map >>enums ] [ "bitfield" tags-named [ xml>enum ] map >>bitfields ] - [ "function" load-functions >>functions - ] + [ "function" load-functions >>functions ] } cleave ; : xml>repository ( xml -- repository ) diff --git a/basis/gir/types/types.factor b/basis/gir/types/types.factor index b0dc5f7df5..219eb3afff 100644 --- a/basis/gir/types/types.factor +++ b/basis/gir/types/types.factor @@ -132,5 +132,5 @@ PREDICATE: interface-type < type get-type-info interface-info? ; dup { [ namespace>> ] [ simple-type? ] [ utf8-type? ] [ none-type? ] - } 1|| [ current-lib get >>namespace ] unless ; + } 1|| [ current-lib get-global >>namespace ] unless ; diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor new file mode 100644 index 0000000000..3a8229da52 --- /dev/null +++ b/basis/glib/ffi/ffi.factor @@ -0,0 +1,70 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien alien.c-types alien.libraries alien.syntax +combinators compiler.units gir kernel system vocabs.parser words ; +IN: glib.ffi + +<< +"glib" { + { [ os winnt? ] [ "libglib-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libglib-2.0.so" cdecl add-library ] } +} cond +>> + +<< double "long double" current-vocab create typedef >> + +TYPEDEF: char gchar +TYPEDEF: uchar guchar +TYPEDEF: short gshort +TYPEDEF: ushort gushort +TYPEDEF: long glong +TYPEDEF: ulong gulong +TYPEDEF: int gint +TYPEDEF: uint guint + +<< +int c-type clone + [ >c-bool ] >>unboxer-quot + [ c-bool> ] >>boxer-quot + object >>boxed-class +"gboolean" current-vocab create typedef +>> + +TYPEDEF: char gint8 +TYPEDEF: uchar guint8 +TYPEDEF: short gint16 +TYPEDEF: ushort guint16 +TYPEDEF: int gint32 +TYPEDEF: uint guint32 +TYPEDEF: longlong gint64 +TYPEDEF: ulonglong guint64 + +TYPEDEF: float gfloat +TYPEDEF: double gdouble + +TYPEDEF: long ssize_t +TYPEDEF: long time_t +TYPEDEF: size_t gsize +TYPEDEF: ssize_t gssize +TYPEDEF: size_t GType + +TYPEDEF: void* gpointer +TYPEDEF: void* gconstpointer + +TYPEDEF: guint8 GDateDay +TYPEDEF: guint16 GDateYear +TYPEDEF: gint GPid +TYPEDEF: guint32 GQuark +TYPEDEF: gint32 GTime +TYPEDEF: glong gintptr +TYPEDEF: gint64 goffset +TYPEDEF: gulong guintptr +TYPEDEF: guint32 gunichar +TYPEDEF: guint16 gunichar2 + +TYPEDEF: gpointer pointer +TYPEDEF: gpointer any + +GIR: vocab:glib/GLib-2.0.gir + diff --git a/basis/glib/glib.factor b/basis/glib/glib.factor index 454484c6a1..46fa035951 100644 --- a/basis/glib/glib.factor +++ b/basis/glib/glib.factor @@ -1,73 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.libraries alien.syntax -combinators compiler.units gir kernel system vocabs.parser words ; - -<< -"glib" { - { [ os winnt? ] [ "libglib-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libglib-2.0.so" cdecl add-library ] } -} cond ->> - -IN: glib.ffi - -<< double "long double" current-vocab create typedef >> - -TYPEDEF: char gchar -TYPEDEF: uchar guchar -TYPEDEF: short gshort -TYPEDEF: ushort gushort -TYPEDEF: long glong -TYPEDEF: ulong gulong -TYPEDEF: int gint -TYPEDEF: uint guint - -SYMBOL: gboolean -<< -gint c-type clone - [ >c-bool ] >>unboxer-quot - [ c-bool> ] >>boxer-quot - object >>boxed-class -gboolean typedef ->> - -TYPEDEF: char gint8 -TYPEDEF: uchar guint8 -TYPEDEF: short gint16 -TYPEDEF: ushort guint16 -TYPEDEF: int gint32 -TYPEDEF: uint guint32 -TYPEDEF: longlong gint64 -TYPEDEF: ulonglong guint64 - -TYPEDEF: float gfloat -TYPEDEF: double gdouble - -TYPEDEF: long ssize_t -TYPEDEF: long time_t -TYPEDEF: size_t gsize -TYPEDEF: ssize_t gssize -TYPEDEF: size_t GType - -TYPEDEF: void* gpointer -TYPEDEF: void* gconstpointer - -TYPEDEF: guint8 GDateDay -TYPEDEF: guint16 GDateYear -TYPEDEF: gint GPid -TYPEDEF: guint32 GQuark -TYPEDEF: gint32 GTime -TYPEDEF: glong gintptr -TYPEDEF: gint64 goffset -TYPEDEF: gulong guintptr -TYPEDEF: guint32 gunichar -TYPEDEF: guint16 gunichar2 - -! Разобраться, почему в .gir есть такие типы -TYPEDEF: gpointer pointer -TYPEDEF: gpointer any - -IN-GIR: glib vocab:glib/GLib-2.0.gir +USING: glib.ffi ; +IN: glib diff --git a/basis/gmodule/ffi/ffi.factor b/basis/gmodule/ffi/ffi.factor new file mode 100644 index 0000000000..449ef69249 --- /dev/null +++ b/basis/gmodule/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gir glib.ffi ; +IN: gmodule.ffi + +<< +"gmodule" { + { [ os winnt? ] [ "libgmodule-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgmodule-2.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gmodule/GModule-2.0.gir + diff --git a/basis/gmodule/gmodule.factor b/basis/gmodule/gmodule.factor index ed60c7e9b8..88bae336a5 100644 --- a/basis/gmodule/gmodule.factor +++ b/basis/gmodule/gmodule.factor @@ -1,15 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gir glib ; - -<< -"gmodule" { - { [ os winnt? ] [ "libgmodule-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgmodule-2.0.so" cdecl add-library ] } -} cond ->> - -IN-GIR: gmodule vocab:gmodule/GModule-2.0.gir +USING: gmodule.ffi ; +IN: gmodule diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor new file mode 100644 index 0000000000..404e2f7fba --- /dev/null +++ b/basis/gobject/ffi/ffi.factor @@ -0,0 +1,56 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.syntax alien.destructors alien.libraries +combinators kernel literals math system +gir glib.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gobject.ffi + +<< +"gobject" { + { [ os winnt? ] [ "libobject-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libgobject-2.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libgobject-2.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: void* GSignalCMarshaller +TYPEDEF: void GStrv +TYPEDEF: gchar* gchararray + +IMPLEMENT-STRUCTS: GValue ; + +GIR: vocab:gobject/GObject-2.0.gir + +IN: gobject.ffi + +FORGET: GIOCondition + +FUNCTION: void g_object_unref ( GObject* self ) ; + +DESTRUCTOR: g_object_unref + +TYPEDEF: GParamSpec GParam + +CONSTANT: G_TYPE_INVALID $[ 0 2 shift ] +CONSTANT: G_TYPE_NONE $[ 1 2 shift ] +CONSTANT: G_TYPE_INTERFACE $[ 2 2 shift ] +CONSTANT: G_TYPE_CHAR $[ 3 2 shift ] +CONSTANT: G_TYPE_UCHAR $[ 4 2 shift ] +CONSTANT: G_TYPE_BOOLEAN $[ 5 2 shift ] +CONSTANT: G_TYPE_INT $[ 6 2 shift ] +CONSTANT: G_TYPE_UINT $[ 7 2 shift ] +CONSTANT: G_TYPE_LONG $[ 8 2 shift ] +CONSTANT: G_TYPE_ULONG $[ 9 2 shift ] +CONSTANT: G_TYPE_INT64 $[ 10 2 shift ] +CONSTANT: G_TYPE_UINT64 $[ 11 2 shift ] +CONSTANT: G_TYPE_ENUM $[ 12 2 shift ] +CONSTANT: G_TYPE_FLAGS $[ 13 2 shift ] +CONSTANT: G_TYPE_FLOAT $[ 14 2 shift ] +CONSTANT: G_TYPE_DOUBLE $[ 15 2 shift ] +CONSTANT: G_TYPE_STRING $[ 16 2 shift ] +CONSTANT: G_TYPE_POINTER $[ 17 2 shift ] +CONSTANT: G_TYPE_BOXED $[ 18 2 shift ] +CONSTANT: G_TYPE_PARAM $[ 19 2 shift ] +CONSTANT: G_TYPE_OBJECT $[ 20 2 shift ] + diff --git a/basis/gobject/gobject.factor b/basis/gobject/gobject.factor index 541a77c287..5dc903a605 100644 --- a/basis/gobject/gobject.factor +++ b/basis/gobject/gobject.factor @@ -1,60 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.destructors -alien.libraries combinators kernel literals math system -gir glib glib.ffi ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gobject" { - { [ os winnt? ] [ "libobject-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libgobject-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libgobject-2.0.so" cdecl add-library ] } -} cond ->> - -IN: gobject.ffi - -TYPEDEF: void* GSignalCMarshaller -TYPEDEF: void GStrv -! есть alias -TYPEDEF: gchar* gchararray - -IMPLEMENT-STRUCTS: GValue ; - -IN-GIR: gobject vocab:gobject/GObject-2.0.gir - -IN: gobject.ffi - -FORGET: GIOCondition - -FUNCTION: void g_object_unref ( GObject* self ) ; - -DESTRUCTOR: g_object_unref - -! Исправление неправильного типа параметра для GtkWidget-child-notify -! (разобраться) -TYPEDEF: GParamSpec GParam - -CONSTANT: G_TYPE_INVALID $[ 0 2 shift ] -CONSTANT: G_TYPE_NONE $[ 1 2 shift ] -CONSTANT: G_TYPE_INTERFACE $[ 2 2 shift ] -CONSTANT: G_TYPE_CHAR $[ 3 2 shift ] -CONSTANT: G_TYPE_UCHAR $[ 4 2 shift ] -CONSTANT: G_TYPE_BOOLEAN $[ 5 2 shift ] -CONSTANT: G_TYPE_INT $[ 6 2 shift ] -CONSTANT: G_TYPE_UINT $[ 7 2 shift ] -CONSTANT: G_TYPE_LONG $[ 8 2 shift ] -CONSTANT: G_TYPE_ULONG $[ 9 2 shift ] -CONSTANT: G_TYPE_INT64 $[ 10 2 shift ] -CONSTANT: G_TYPE_UINT64 $[ 11 2 shift ] -CONSTANT: G_TYPE_ENUM $[ 12 2 shift ] -CONSTANT: G_TYPE_FLAGS $[ 13 2 shift ] -CONSTANT: G_TYPE_FLOAT $[ 14 2 shift ] -CONSTANT: G_TYPE_DOUBLE $[ 15 2 shift ] -CONSTANT: G_TYPE_STRING $[ 16 2 shift ] -CONSTANT: G_TYPE_POINTER $[ 17 2 shift ] -CONSTANT: G_TYPE_BOXED $[ 18 2 shift ] -CONSTANT: G_TYPE_PARAM $[ 19 2 shift ] -CONSTANT: G_TYPE_OBJECT $[ 20 2 shift ] +USING: gobject.ffi ; +IN: gobject diff --git a/basis/gst/ffi/ffi.factor b/basis/gst/ffi/ffi.factor new file mode 100644 index 0000000000..fa110b3a5d --- /dev/null +++ b/basis/gst/ffi/ffi.factor @@ -0,0 +1,27 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.syntax alien.libraries combinators kernel +system +gir glib.ffi gmodule.ffi gobject.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gst.ffi + +<< +"gst" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstreamer-0.10.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: gpointer GstClockID +TYPEDEF: guint64 GstClockTime +TYPEDEF: gint64 GstClockTimeDiff + +! Временное исправление отсутвующих типов libxml2 +TYPEDEF: void* xmlNodePtr +TYPEDEF: void* xmlDocPtr +TYPEDEF: void* xmlNsPtr + +GIR: vocab:gst/Gst-0.10.gir + diff --git a/basis/gst/gst.factor b/basis/gst/gst.factor index b97b929f5c..073b022b95 100644 --- a/basis/gst/gst.factor +++ b/basis/gst/gst.factor @@ -1,28 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.libraries combinators -kernel system -gir glib glib.ffi gobject gmodule ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gst" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgstreamer-0.10.so" cdecl add-library ] } -} cond ->> - -IN: gst.ffi - -TYPEDEF: gpointer GstClockID -TYPEDEF: guint64 GstClockTime -TYPEDEF: gint64 GstClockTimeDiff - -! Временное исправление отсутвующих типов libxml2 -TYPEDEF: void* xmlNodePtr -TYPEDEF: void* xmlDocPtr -TYPEDEF: void* xmlNsPtr - -IN-GIR: gst vocab:gst/Gst-0.10.gir +USING: gst.ffi ; +IN: gst diff --git a/basis/gtk/ffi/ffi.factor b/basis/gtk/ffi/ffi.factor new file mode 100644 index 0000000000..64d0b7f2ea --- /dev/null +++ b/basis/gtk/ffi/ffi.factor @@ -0,0 +1,26 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.syntax alien.libraries cairo.ffi combinators +kernel system +gir atk.ffi gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi +gobject.ffi pango.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gtk.ffi + +<< +"gtk" { + { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgtk-x11-2.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: void GtkAllocation +TYPEDEF: void GtkEnumValue +TYPEDEF: void GtkFlagValue +TYPEDEF: GType GtkType + +IMPLEMENT-STRUCTS: GtkTreeIter ; + +GIR: vocab:gtk/Gtk-2.0.gir + diff --git a/basis/gtk/gl/ffi/ffi.factor b/basis/gtk/gl/ffi/ffi.factor new file mode 100644 index 0000000000..9997ce81ad --- /dev/null +++ b/basis/gtk/gl/ffi/ffi.factor @@ -0,0 +1,18 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gir gdk.ffi gdk.pixbuf.ffi gdk.gl.ffi gio.ffi glib.ffi +gmodule.ffi gobject.ffi gtk.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gtk.gl.ffi + +<< +"gtk.gl" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgtkglext-x11-1.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gtk/gl/GtkGL-1.0.gir + diff --git a/basis/gtk/gl/gl.factor b/basis/gtk/gl/gl.factor index cc4bc8d581..3a9a104665 100644 --- a/basis/gtk/gl/gl.factor +++ b/basis/gtk/gl/gl.factor @@ -1,16 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gir glib gobject gio gmodule gdk.pixbuf gdk gdk.gl gtk gtk.ffi ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gtk.gl" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgtkglext-x11-1.0.so" cdecl add-library ] } -} cond ->> - -IN-GIR: gtk.gl vocab:gtk/gl/GtkGL-1.0.gir +USING: gtk.gl.ffi ; +IN: gtk.gl diff --git a/basis/gtk/gtk.factor b/basis/gtk/gtk.factor index 8dc000ffdc..d91e1f3bdf 100644 --- a/basis/gtk/gtk.factor +++ b/basis/gtk/gtk.factor @@ -1,26 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.libraries cairo.ffi combinators -kernel system -gir glib glib.ffi gobject gio gmodule gdk.pixbuf gdk atk ; -EXCLUDE: alien.c-types => pointer ; - -<< -"gtk" { - { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgtk-x11-2.0.so" cdecl add-library ] } -} cond ->> - -IN: gtk.ffi - -TYPEDEF: void GtkAllocation -TYPEDEF: void GtkEnumValue -TYPEDEF: void GtkFlagValue -TYPEDEF: GType GtkType - -IMPLEMENT-STRUCTS: GtkTreeIter ; - -IN-GIR: gtk vocab:gtk/Gtk-2.0.gir +USING: gtk.ffi ; +IN: gtk diff --git a/basis/opengl/gl/gtk/gtk.factor b/basis/opengl/gl/gtk/gtk.factor index fef80313f2..0521d2fa07 100644 --- a/basis/opengl/gl/gtk/gtk.factor +++ b/basis/opengl/gl/gtk/gtk.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.strings io.encodings.ascii -gdk.gl gdk.gl.ffi ; +gdk.gl.ffi ; IN: opengl.gl.gtk : gl-function-context ( -- context ) diff --git a/basis/pango/cairo/cairo.factor b/basis/pango/cairo/cairo.factor index b800fe7f49..67ae9969fe 100644 --- a/basis/pango/cairo/cairo.factor +++ b/basis/pango/cairo/cairo.factor @@ -1,27 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.data alien.libraries -alien.syntax cairo.ffi combinators kernel system -gir pango pango.ffi ; - -<< -"pango.cairo" { - { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libpangocairo-1.0.so" cdecl add-library ] } -} cond ->> - -IN-GIR: pango.cairo vocab:pango/cairo/PangoCairo-1.0.gir - -IN: pango.cairo.ffi - -FUNCTION: void -pango_cairo_update_layout ( cairo_t* cr, PangoLayout* layout ) ; - -FUNCTION: void -pango_cairo_show_layout ( cairo_t* cr, PangoLayout* layout ) ; - -FUNCTION: PangoLayout* -pango_cairo_create_layout ( cairo_t* cr ) ; +USING: cairo.pango.ffi ; +IN: pango.cairo diff --git a/basis/pango/cairo/ffi/ffi.factor b/basis/pango/cairo/ffi/ffi.factor new file mode 100644 index 0000000000..2361fe5de4 --- /dev/null +++ b/basis/pango/cairo/ffi/ffi.factor @@ -0,0 +1,26 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries alien.syntax cairo.ffi +combinators kernel system +gir pango.ffi ; +IN: pango.cairo.ffi + +<< +"pango.cairo" { + { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libpangocairo-1.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:pango/cairo/PangoCairo-1.0.gir + +FUNCTION: void +pango_cairo_update_layout ( cairo_t* cr, PangoLayout* layout ) ; + +FUNCTION: void +pango_cairo_show_layout ( cairo_t* cr, PangoLayout* layout ) ; + +FUNCTION: PangoLayout* +pango_cairo_create_layout ( cairo_t* cr ) ; + diff --git a/basis/pango/ffi/ffi.factor b/basis/pango/ffi/ffi.factor new file mode 100644 index 0000000000..d174ac4488 --- /dev/null +++ b/basis/pango/ffi/ffi.factor @@ -0,0 +1,25 @@ +! Copyright (C) 2009 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.destructors alien.libraries +alien.syntax combinators kernel system +gir glib.ffi ; +IN: pango.ffi + +<< +"pango" { + { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } + { [ os macosx? ] [ "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } + { [ os unix? ] [ "libpango-1.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: void PangoLayoutRun ! не совсем верно +TYPEDEF: guint32 PangoGlyph + +IMPLEMENT-STRUCTS: PangoRectangle ; + +GIR: vocab:pango/Pango-1.0.gir + +DESTRUCTOR: pango_font_description_free +DESTRUCTOR: pango_layout_iter_free + diff --git a/basis/pango/pango.factor b/basis/pango/pango.factor index 6d1e8aed94..221308f257 100644 --- a/basis/pango/pango.factor +++ b/basis/pango/pango.factor @@ -1,28 +1,5 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.destructors alien.libraries -alien.syntax combinators kernel system -gir glib glib.ffi ; - -<< -"pango" { - { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libpango-1.0.so" cdecl add-library ] } -} cond ->> - -IN: pango.ffi - -TYPEDEF: void PangoLayoutRun ! не совсем верно -TYPEDEF: guint32 PangoGlyph - -IMPLEMENT-STRUCTS: PangoRectangle ; - -IN-GIR: pango vocab:pango/Pango-1.0.gir - -IN: pango.ffi - -DESTRUCTOR: pango_font_description_free -DESTRUCTOR: pango_layout_iter_free +USING: pango.ffi ; +IN: pango diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index b984c46563..9503e31129 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -5,8 +5,7 @@ classes.struct combinators.short-circuit command-line destructors io.encodings.utf8 kernel literals locals math math.bitwise namespaces sequences strings ui ui.backend ui.clipboards ui.event-loop ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures ui.private -glib glib.ffi gobject gobject.ffi gtk gtk.ffi gdk gdk.ffi -gdk.gl gtk.gl gdk.gl.ffi gtk.gl.ffi ; +glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; IN: ui.backend.gtk SINGLETON: gtk-ui-backend @@ -276,14 +275,14 @@ M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win world [ window-loc>> win swap first2 gtk_window_move ] [ dim>> win swap first2 gtk_window_set_default_size ] bi - + win enable-gl drop ! сделать проверку на доступность OpenGL - + win connect-signals win gtk_widget_realize win world window-controls>> configure-window-controls - + win world handle<< world win register-window diff --git a/basis/ui/text/pango/pango.factor b/basis/ui/text/pango/pango.factor index 634242b692..ede8135e95 100644 --- a/basis/ui/text/pango/pango.factor +++ b/basis/ui/text/pango/pango.factor @@ -4,7 +4,7 @@ USING: accessors alien.c-types alien.strings arrays assocs cache cairo cairo.ffi classes.struct combinators destructors fonts fry init io.encodings.utf8 kernel math math.rectangles math.vectors memoize namespaces sequences ui.text ui.text.private -gobject gobject.ffi pango pango.ffi pango.cairo pango.cairo.ffi ; +gobject.ffi pango.ffi pango.cairo.ffi ; IN: ui.text.pango : pango>float ( n -- x ) PANGO_SCALE /f ; inline diff --git a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor index 0127f48e6b..c772fd11da 100644 --- a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor +++ b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien.c-types alien.strings fry byte-arrays classes.struct io.encodings.utf8 kernel locals math prettyprint -gst gst.ffi glib.ffi gobject.ffi gtk gtk.ffi ; +gst.ffi glib.ffi gobject.ffi gtk.ffi ; IN: gir.samples.lowlevel.gstreamer ! CONSTANT: uri "http://www.xiph.org/vorbis/listen/compilation-ogg-q4.ogg" diff --git a/extra/gir/samples/lowlevel/hello-world/hello-world.factor b/extra/gir/samples/lowlevel/hello-world/hello-world.factor index a7068937d6..b1bcf029d5 100644 --- a/extra/gir/samples/lowlevel/hello-world/hello-world.factor +++ b/extra/gir/samples/lowlevel/hello-world/hello-world.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.strings gtk gobject.ffi gtk.ffi io.encodings.utf8 +USING: alien.strings gobject.ffi gtk.ffi io.encodings.utf8 kernel locals ; IN: gir.samples.lowlevel.hello-world diff --git a/extra/gir/samples/lowlevel/lowlevel.factor b/extra/gir/samples/lowlevel/lowlevel.factor index a3b8201787..795d3cfba4 100644 --- a/extra/gir/samples/lowlevel/lowlevel.factor +++ b/extra/gir/samples/lowlevel/lowlevel.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien.c-types alien.strings byte-arrays classes.struct -gtk glib.ffi gobject.ffi gtk.ffi io.encodings.utf8 kernel +glib.ffi gobject.ffi gtk.ffi io.encodings.utf8 kernel literals locals make math prettyprint sequences specialized-arrays gir.samples.lowlevel.hello-world gir.samples.lowlevel.opengl diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gir/samples/lowlevel/opengl/opengl.factor index 284a8c342f..304549d321 100644 --- a/extra/gir/samples/lowlevel/opengl/opengl.factor +++ b/extra/gir/samples/lowlevel/opengl/opengl.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.enums alien.strings gtk gobject.ffi gtk.ffi gdk.gl gtk.gl gdk.gl.ffi +USING: alien.enums alien.strings gobject.ffi gtk.ffi gdk.gl.ffi gtk.gl.ffi io.encodings.utf8 kernel locals math opengl.gl prettyprint ; IN: gir.samples.lowlevel.opengl From 2d8e44bde4064a0c161fd7b8ed858587002e848c Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 30 May 2010 22:45:37 +0600 Subject: [PATCH 16/76] add callbacks definitions; clean up --- basis/gir/ffi/ffi.factor | 64 +++++++++++++++++----------------- basis/gir/loader/loader.factor | 2 ++ 2 files changed, 34 insertions(+), 32 deletions(-) diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index 88c2ceb40e..b9e8ecb9fa 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -13,16 +13,16 @@ IN: gir.ffi : define-each ( nodes quot -- ) '[ dup @ >>ffi drop ] each ; inline -: ffi-invoker ( func -- quot ) +: function-ffi-invoker ( func -- quot ) { [ return>> c-type>> string>c-type ] [ drop current-lib get-global ] [ identifier>> ] [ parameters>> [ c-type>> string>c-type ] map ] [ varargs?>> [ void* suffix ] when ] - } cleave \ alien-invoke 5 narray >quotation ; + } cleave function-quot ; -: ffi-effect ( func -- effect ) +: function-ffi-effect ( func -- effect ) [ parameters>> [ name>> ] map ] [ varargs?>> [ "varargs" suffix ] when ] [ return>> type>> none-type? { } { "result" } ? ] tri @@ -30,42 +30,45 @@ IN: gir.ffi : define-ffi-function ( func -- word ) [ identifier>> create-in dup ] - [ ffi-invoker ] [ ffi-effect ] tri define-declared ; + [ function-ffi-invoker ] [ function-ffi-effect ] tri + define-declared ; : define-ffi-functions ( functions -- ) [ define-ffi-function ] define-each ; -: signal-param-c-type ( param -- c-type ) - [ c-type>> ] [ type>> ] bi +: callback-ffi-invoker ( callback -- quot ) + [ return>> c-type>> string>c-type ] + [ parameters>> [ c-type>> string>c-type ] map ] bi + cdecl callback-quot ; + +: callback-ffi-effect ( callback -- effect ) + [ parameters>> [ name>> ] map ] + [ return>> type>> none-type? { } { "result" } ? ] bi + ; + +: define-ffi-callback ( callback -- word ) + [ c-type>> create-in [ void* swap typedef ] keep dup ] keep + [ callback-ffi-effect "callback-effect" set-word-prop ] + [ drop current-lib get-global "callback-library" set-word-prop ] + [ callback-ffi-invoker (( quot -- alien )) define-inline ] 2tri ; + +: fix-signal-param-c-type ( param -- ) + dup [ c-type>> ] [ type>> ] bi { [ none-type? ] [ simple-type? ] [ enum-type? ] [ bitfield-type? ] - } 1|| [ dup "*" tail? [ CHAR: * suffix ] unless ] unless ; + } 1|| [ dup "*" tail? [ CHAR: * suffix ] unless ] unless + >>c-type drop ; -: signal-ffi-invoker ( signal -- quot ) - [ return>> signal-param-c-type string>c-type ] - [ parameters>> [ signal-param-c-type string>c-type ] map ] bi - cdecl [ [ ] 3curry dip alien-callback ] 3curry ; - -: signal-ffi-effect ( signal -- effect ) - [ parameters>> [ name>> ] map ] - [ return>> type>> none-type? { } { "result" } ? ] bi - ; - -:: define-ffi-signal ( signal class -- word ) ! сделать попонятнее - signal - [ - name>> class c-type>> swap ":" glue create-in - [ void* swap typedef ] keep dup - ] keep - [ signal-ffi-effect "callback-effect" set-word-prop ] - [ drop current-lib get-global "callback-library" set-word-prop ] - [ signal-ffi-invoker (( quot -- alien )) define-inline ] 2tri ; - -: define-ffi-signals ( signals class -- ) - '[ _ define-ffi-signal ] define-each ; +: define-ffi-signal ( signal -- word ) + [ return>> fix-signal-param-c-type ] + [ parameters>> [ fix-signal-param-c-type ] each ] + [ define-ffi-callback ] tri ; + +: define-ffi-signals ( signals -- ) + [ define-ffi-signal ] define-each ; : const-value ( const -- value ) [ value>> ] [ type>> name>> ] bi { @@ -139,9 +142,6 @@ IN: gir.ffi : define-ffi-unions ( unions -- ) [ define-ffi-union ] define-each ; -: define-ffi-callback ( callback -- word ) - c-type>> create-in [ void* swap typedef ] keep ; - : define-ffi-callbacks ( callbacks -- ) [ define-ffi-callback ] define-each ; diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor index 3d444bd500..fc3de0103b 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gir/loader/loader.factor @@ -174,6 +174,8 @@ SYMBOL: namespace-PREFIX "signal" tags-named [ xml>signal ] map over type>sender-param '[ [ _ prefix ] change-parameters ] map + over c-type>> CHAR: : suffix + '[ dup name>> _ prepend >>c-type ] map >>signals ] } cleave ; From 0b7be5142bf4f5bbb26275a010700ceea976b134 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 31 May 2010 00:18:08 +0600 Subject: [PATCH 17/76] ui.backend.gtk: add rough implementation of non-blocking IO --- basis/glib/ffi/ffi.factor | 13 ++++++- basis/gobject/ffi/ffi.factor | 6 +++ basis/ui/backend/gtk/gtk.factor | 67 ++++++++++++++++++++++++++++----- 3 files changed, 75 insertions(+), 11 deletions(-) diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index 3a8229da52..51fa3af04c 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -1,7 +1,8 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.libraries alien.syntax -combinators compiler.units gir kernel system vocabs.parser words ; +USING: accessors alien alien.c-types alien.destructors +alien.libraries alien.syntax combinators compiler.units gir +kernel system vocabs.parser words ; IN: glib.ffi << @@ -66,5 +67,13 @@ TYPEDEF: guint16 gunichar2 TYPEDEF: gpointer pointer TYPEDEF: gpointer any +IMPLEMENT-STRUCTS: GPollFD GSource GSourceFuncs ; + GIR: vocab:glib/GLib-2.0.gir +DESTRUCTOR: g_source_unref + +CALLBACK: gboolean GSourceFuncsPrepareFunc ( GSource* source, gint* timeout_ ) ; +CALLBACK: gboolean GSourceFuncsCheckFunc ( GSource* source ) ; +CALLBACK: gboolean GSourceFuncsDispatchFunc ( GSource* source, GSourceFunc callback, gpointer user_data ) ; + diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index 404e2f7fba..a5b74e3aeb 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -25,6 +25,12 @@ GIR: vocab:gobject/GObject-2.0.gir IN: gobject.ffi FORGET: GIOCondition +FORGET: G_IO_IN +FORGET: G_IO_OUT +FORGET: G_IO_PRI +FORGET: G_IO_ERR +FORGET: G_IO_HUP +FORGET: G_IO_NVAL FUNCTION: void g_object_unref ( GObject* self ) ; diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 9503e31129..77e170073c 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,10 +1,12 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.enums alien.strings arrays ascii assocs -classes.struct combinators.short-circuit command-line destructors -io.encodings.utf8 kernel literals locals math math.bitwise -namespaces sequences strings ui ui.backend ui.clipboards ui.event-loop -ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures ui.private +USING: accessors alien.c-types alien.enums alien.strings arrays +ascii assocs classes.struct combinators.short-circuit +command-line destructors io.backend.unix.multiplexers +io.encodings.utf8 io.thread kernel libc literals locals math +math.bitwise namespaces sequences strings threads ui ui.backend +ui.clipboards ui.event-loop ui.gadgets ui.gadgets.private +ui.gadgets.worlds ui.gestures ui.private glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; IN: ui.backend.gtk @@ -177,8 +179,48 @@ CONSTANT: action-key-codes gtk_clipboard_get swap set-global ] 2bi@ ; -M: gtk-ui-backend do-events - f gtk_main_iteration_do drop ui-wait ; +: io-source-prepare ( source timeout -- result ) + 2drop f ; + +: io-source-check ( source -- result ) + poll_fds>> 0 g_slist_nth_data GPollFD memory>struct + revents>> 0 = not ; + +: io-source-dispatch ( source callback user_data -- result ) + 3drop + 0 mx get wait-for-events + yield t ; + +: timeout-func ( -- func ) + [ drop yield t ] GSourceFunc ; + +: init-timeout ( interval -- ) + G_PRIORITY_DEFAULT swap timeout-func f f + g_timeout_add_full drop ; + +CONSTANT: poll-fd-events + { + G_IO_IN + G_IO_OUT + G_IO_PRI + G_IO_ERR + G_IO_HUP + G_IO_NVAL + } + +: create-poll-fd ( -- poll-fd ) + GPollFD malloc-struct &free + mx get fd>> >>fd + poll-fd-events [ enum>number ] [ bitor ] map-reduce >>events ; + +: init-io-event-source ( -- ) + GSourceFuncs malloc-struct &free + [ io-source-prepare ] GSourceFuncsPrepareFunc >>prepare + [ io-source-check ] GSourceFuncsCheckFunc >>check + [ io-source-dispatch ] GSourceFuncsDispatchFunc >>dispatch + GSource heap-size g_source_new &g_source_unref + [ create-poll-fd g_source_add_poll ] + [ f g_source_attach drop ] bi ; M: gtk-ui-backend (with-ui) [ @@ -186,7 +228,13 @@ M: gtk-ui-backend (with-ui) f f gtk_gl_init init-clipboard start-ui - event-loop + f io-thread-running? set-global + [ + init-io-event-source + ! is it correct to use timeouts with 'yield'? + 10 init-timeout + gtk_main + ] with-destructors ] ui-running ; : connect-signal ( object signal-name callback -- ) @@ -289,7 +337,8 @@ M:: gtk-ui-backend (open-window) ( world -- ) win gtk_widget_show_all ; M: gtk-ui-backend (close-window) ( handle -- ) - window>> [ unregister-window ] [ gtk_widget_destroy ] bi ; + window>> [ unregister-window ] [ gtk_widget_destroy ] bi + event-loop? [ gtk_main_quit ] unless ; M: gtk-ui-backend set-title swap [ handle>> window>> ] [ utf8 string>alien ] bi* From 52848bc838e15b2bac3d9823597292f6edbc1800 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 31 May 2010 12:12:16 +0600 Subject: [PATCH 18/76] gdk.gl: update GdkGL-1.0.gir (regenerate it without extensions) --- basis/gdk/gl/GdkGL-1.0.gir | 28815 ----------------------------------- 1 file changed, 28815 deletions(-) diff --git a/basis/gdk/gl/GdkGL-1.0.gir b/basis/gdk/gl/GdkGL-1.0.gir index e86bb7963a..32e7b324bc 100644 --- a/basis/gdk/gl/GdkGL-1.0.gir +++ b/basis/gdk/gl/GdkGL-1.0.gir @@ -1168,4411 +1168,6 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -5582,17393 +1177,6 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -23133,7029 +1341,6 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - From c094c46721d50f14541970cd39e9bdeae435f57e Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 31 May 2010 12:42:05 +0600 Subject: [PATCH 19/76] fix broken commit --- basis/atk/ffi/ffi.factor | 3 +++ basis/gdk/ffi/ffi.factor | 1 + basis/gir/ffi/ffi.factor | 2 +- 3 files changed, 5 insertions(+), 1 deletion(-) diff --git a/basis/atk/ffi/ffi.factor b/basis/atk/ffi/ffi.factor index e78948b378..fa3dd6910f 100644 --- a/basis/atk/ffi/ffi.factor +++ b/basis/atk/ffi/ffi.factor @@ -16,5 +16,8 @@ IN: atk.ffi TYPEDEF: guint64 AtkState TYPEDEF: GSList AtkAttributeSet +! gir: error +C-TYPE: AtkPropertyValues + GIR: vocab:atk/Atk-1.0.gir diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 7458234205..5be53b7544 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -16,6 +16,7 @@ IN: gdk.ffi TYPEDEF: guint32 GdkNativeWindow TYPEDEF: guint32 GdkWChar +C-TYPE: GdkXEvent IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index b9e8ecb9fa..ce33ce7c4b 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -175,7 +175,7 @@ IN: gir.ffi [ constructors>> define-ffi-functions ] [ functions>> define-ffi-functions ] [ methods>> define-ffi-functions ] - [ [ signals>> ] keep define-ffi-signals ] + [ signals>> define-ffi-signals ] } cleave ; : define-ffi-classes-content ( class -- ) From 400289699d11b1542639cb0c6599e00535dbb089 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 2 Jun 2010 13:30:05 +0600 Subject: [PATCH 20/76] ui.backend.gtk: add pixel-format support --- basis/ui/backend/gtk/gtk.factor | 71 +++++++++++++++++++++++---------- 1 file changed, 50 insertions(+), 21 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 77e170073c..b2b703b523 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,12 +1,13 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.c-types alien.enums alien.strings arrays -ascii assocs classes.struct combinators.short-circuit -command-line destructors io.backend.unix.multiplexers -io.encodings.utf8 io.thread kernel libc literals locals math -math.bitwise namespaces sequences strings threads ui ui.backend -ui.clipboards ui.event-loop ui.gadgets ui.gadgets.private -ui.gadgets.worlds ui.gestures ui.private +USING: accessors alien.c-types alien.data alien.enums +alien.strings arrays ascii assocs classes.struct +combinators.short-circuit command-line destructors +io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel +libc literals locals math math.bitwise namespaces sequences +strings threads ui ui.backend ui.clipboards ui.event-loop +ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures +ui.pixel-formats ui.pixel-formats.private ui.private glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; IN: ui.backend.gtk @@ -22,6 +23,39 @@ TUPLE: gtk-clipboard handle ; C: gtk-clipboard +PIXEL-FORMAT-ATTRIBUTE-TABLE: gl-config-attribs { $[ GDK_GL_USE_GL enum>number GDK_GL_RGBA enum>number ] } H{ + { double-buffered { $[ GDK_GL_DOUBLEBUFFER enum>number ] } } + { stereo { $[ GDK_GL_STEREO enum>number ] } } + ! { offscreen { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 2 } } + ! { fullscreen { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 1 } } + ! { windowed { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 1 } } + { color-bits { $[ GDK_GL_BUFFER_SIZE enum>number ] } } + { red-bits { $[ GDK_GL_RED_SIZE enum>number ] } } + { green-bits { $[ GDK_GL_GREEN_SIZE enum>number ] } } + { blue-bits { $[ GDK_GL_BLUE_SIZE enum>number ] } } + { alpha-bits { $[ GDK_GL_ALPHA_SIZE enum>number ] } } + { accum-red-bits { $[ GDK_GL_ACCUM_RED_SIZE enum>number ] } } + { accum-green-bits { $[ GDK_GL_ACCUM_GREEN_SIZE enum>number ] } } + { accum-blue-bits { $[ GDK_GL_ACCUM_BLUE_SIZE enum>number ] } } + { accum-alpha-bits { $[ GDK_GL_ACCUM_ALPHA_SIZE enum>number ] } } + { depth-bits { $[ GDK_GL_DEPTH_SIZE enum>number ] } } + { stencil-bits { $[ GDK_GL_STENCIL_SIZE enum>number ] } } + { aux-buffers { $[ GDK_GL_AUX_BUFFERS enum>number ] } } + { sample-buffers { $[ GDK_GL_SAMPLE_BUFFERS enum>number ] } } + { samples { $[ GDK_GL_SAMPLES enum>number ] } } +} + +M: gtk-ui-backend (make-pixel-format) + nip >gl-config-attribs-int-array gdk_gl_config_new ; + +M: gtk-ui-backend (free-pixel-format) + handle>> g_object_unref ; + +M: gtk-ui-backend (pixel-format-attribute) + [ handle>> ] [ >gl-config-attribs ] bi* + { int } [ gdk_gl_config_get_attrib drop ] [ ] + with-out-parameters ; + CONSTANT: events-mask { GDK_POINTER_MOTION_MASK @@ -271,17 +305,6 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete ] GtkWidget:delete-event connect-signal ; -: enable-gl ( win -- ? ) - ${ - GDK_GL_MODE_RGBA - GDK_GL_MODE_DOUBLE - GDK_GL_MODE_DEPTH - GDK_GL_MODE_STENCIL - GDK_GL_MODE_ALPHA - } [ enum>number ] [ bitor ] map-reduce - gdk_gl_config_new_by_mode - f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability ; - CONSTANT: window-controls>decor-flags H{ { close-button 0 } @@ -319,19 +342,25 @@ CONSTANT: window-controls>func-flags GDK_FUNC_MOVE enum>number bitor gdk_window_set_functions ] 2tri ; +: setup-gl ( world -- ? ) + [ + [ handle>> window>> ] [ handle>> ] bi* + f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability + ] with-world-pixel-format ; + M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win + win world handle<< world [ window-loc>> win swap first2 gtk_window_move ] [ dim>> win swap first2 gtk_window_set_default_size ] bi - - win enable-gl drop ! сделать проверку на доступность OpenGL + world setup-gl drop + win connect-signals win gtk_widget_realize win world window-controls>> configure-window-controls - win world handle<< world win register-window win gtk_widget_show_all ; From e5b07f5f297bf730d796c1ecc6a3b8a7b828c155 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 6 Jun 2010 14:19:46 +0600 Subject: [PATCH 21/76] ui.backend.gtk: add more advanced timer for event loop --- basis/ui/backend/gtk/gtk.factor | 74 ++++++++++++++++++++------------- 1 file changed, 46 insertions(+), 28 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index b2b703b523..1966564377 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,13 +1,13 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.c-types alien.data alien.enums -alien.strings arrays ascii assocs classes.struct +USING: accessors alien.accessors alien.c-types alien.data +alien.enums alien.strings arrays ascii assocs classes.struct combinators.short-circuit command-line destructors io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel -libc literals locals math math.bitwise namespaces sequences -strings threads ui ui.backend ui.clipboards ui.event-loop -ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures -ui.pixel-formats ui.pixel-formats.private ui.private +libc literals locals math math.bitwise math.order namespaces +sequences strings system threads ui ui.backend ui.clipboards +ui.event-loop ui.gadgets ui.gadgets.private ui.gadgets.worlds +ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; IN: ui.backend.gtk @@ -225,13 +225,6 @@ CONSTANT: action-key-codes 0 mx get wait-for-events yield t ; -: timeout-func ( -- func ) - [ drop yield t ] GSourceFunc ; - -: init-timeout ( interval -- ) - G_PRIORITY_DEFAULT swap timeout-func f f - g_timeout_add_full drop ; - CONSTANT: poll-fd-events { G_IO_IN @@ -256,6 +249,32 @@ CONSTANT: poll-fd-events [ create-poll-fd g_source_add_poll ] [ f g_source_attach drop ] bi ; +SYMBOL: next-timeout + +: set-timeout*-value ( alien value -- ) + swap 0 set-alien-signed-4 ; inline + +: timeout-prepare ( source timeout* -- result ) + nip next-timeout get-global nano-count [-] + [ 1,000,000 /i set-timeout*-value ] keep 0 = ; + +: timeout-check ( source -- result ) + drop next-timeout get-global nano-count [-] 0 = ; + +: timeout-dispatch ( source callback user_data -- result ) + 3drop sleep-time [ 1,000,000,000 ] unless* nano-count + + next-timeout set-global + yield t ; + +: init-timeout ( -- ) + GSourceFuncs malloc-struct &free + [ timeout-prepare ] GSourceFuncsPrepareFunc >>prepare + [ timeout-check ] GSourceFuncsCheckFunc >>check + [ timeout-dispatch ] GSourceFuncsDispatchFunc >>dispatch + GSource heap-size g_source_new &g_source_unref + f g_source_attach drop + nano-count next-timeout set-global ; + M: gtk-ui-backend (with-ui) [ f f gtk_init @@ -265,8 +284,7 @@ M: gtk-ui-backend (with-ui) f io-thread-running? set-global [ init-io-event-source - ! is it correct to use timeouts with 'yield'? - 10 init-timeout + init-timeout gtk_main ] with-destructors ] ui-running ; @@ -278,31 +296,31 @@ M: gtk-ui-backend (with-ui) win events-mask [ enum>number ] [ bitor ] map-reduce gtk_widget_add_events - win "expose-event" [ on-expose ] + win "expose-event" [ on-expose yield ] GtkWidget:expose-event connect-signal - win "configure-event" [ on-configure ] + win "configure-event" [ on-configure yield ] GtkWidget:configure-event connect-signal - win "motion-notify-event" [ on-motion ] + win "motion-notify-event" [ on-motion yield ] GtkWidget:motion-notify-event connect-signal - win "leave-notify-event" [ on-leave ] + win "leave-notify-event" [ on-leave yield ] GtkWidget:leave-notify-event connect-signal - win "enter-notify-event" [ on-enter ] + win "enter-notify-event" [ on-enter yield ] GtkWidget:enter-notify-event connect-signal - win "button-press-event" [ on-button-press ] + win "button-press-event" [ on-button-press yield ] GtkWidget:button-press-event connect-signal - win "button-release-event" [ on-button-release ] + win "button-release-event" [ on-button-release yield ] GtkWidget:button-release-event connect-signal - win "scroll-event" [ on-scroll ] + win "scroll-event" [ on-scroll yield ] GtkWidget:scroll-event connect-signal - win "key-press-event" [ on-key-press ] + win "key-press-event" [ on-key-press yield ] GtkWidget:key-press-event connect-signal - win "key-release-event" [ on-key-release ] + win "key-release-event" [ on-key-release yield ] GtkWidget:key-release-event connect-signal - win "focus-in-event" [ on-focus-in ] + win "focus-in-event" [ on-focus-in yield ] GtkWidget:focus-in-event connect-signal - win "focus-out-event" [ on-focus-out ] + win "focus-out-event" [ on-focus-out yield ] GtkWidget:focus-out-event connect-signal - win "delete-event" [ on-delete ] + win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; CONSTANT: window-controls>decor-flags From 33996ca1d693bb1aa16ce72ef686d4325858b805 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 7 Jun 2010 22:46:10 +0600 Subject: [PATCH 22/76] ui.backend.gtk: fix incorrect resizing of windows --- basis/ui/backend/gtk/gtk.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 1966564377..1b4c44de9e 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -200,7 +200,7 @@ CONSTANT: action-key-codes : on-configure ( sender event user-data -- result ) drop [ window ] dip GdkEventConfigure memory>struct [ event-loc >>window-loc ] [ event-dim >>dim ] bi - relayout-1 t ; + relayout-1 f ; : on-delete ( sender event user-data -- result ) 2drop window ungraft t ; From 66f5c2695f1ff37b06a2b176f0cfffd21133e8c4 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Tue, 8 Jun 2010 13:21:45 +0600 Subject: [PATCH 23/76] ui.backend.gtk: fix (grab-input) and (ungrab-input) --- basis/ui/backend/gtk/gtk.factor | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 1b4c44de9e..4c53324570 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -411,12 +411,12 @@ M: gtk-ui-backend raise-window* ] with-destructors ; M: gtk-ui-backend (grab-input) - handle>> window>> + window>> [ gtk_grab_add ] [ GDK_BLANK_CURSOR set-cursor ] bi ; M: gtk-ui-backend (ungrab-input) - handle>> window>> - [ gtk_grab_remove ] [ GDK_ARROW set-cursor ] bi ; + window>> + [ gtk_grab_remove ] [ GDK_LEFT_PTR set-cursor ] bi ; M: window-handle select-gl-context ( handle -- ) window>> From 59857ad2c16240fac10e6d92d454bf40fc286233 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Tue, 8 Jun 2010 17:41:10 +0600 Subject: [PATCH 24/76] ui.backend.gtk: add auto-position for worlds with { 0 0 } in window-loc --- basis/ui/backend/gtk/gtk.factor | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 4c53324570..9acae5e7a5 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -366,12 +366,22 @@ CONSTANT: window-controls>func-flags f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability ] with-world-pixel-format ; +: auto-position ( window loc -- ) + dup { 0 0 } = [ + drop dup window topmost-window = + GTK_WIN_POS_CENTER GTK_WIN_POS_NONE ? + gtk_window_set_position + ] [ first2 gtk_window_move ] if ; + M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win - win world handle<< - world [ window-loc>> win swap first2 gtk_window_move ] - [ dim>> win swap first2 gtk_window_set_default_size ] bi - + + world win [ >>handle drop ] + [ register-window ] 2bi + + win world [ window-loc>> auto-position ] + [ dim>> first2 gtk_window_set_default_size ] 2bi + world setup-gl drop win connect-signals @@ -379,8 +389,6 @@ M:: gtk-ui-backend (open-window) ( world -- ) win gtk_widget_realize win world window-controls>> configure-window-controls - world win register-window - win gtk_widget_show_all ; M: gtk-ui-backend (close-window) ( handle -- ) From 17d0874360b084dfcec3c27cdbfdf3459c6e864f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Thu, 10 Jun 2010 00:16:31 +0200 Subject: [PATCH 25/76] ui.backend.gtk: preliminary input methods support --- basis/ui/backend/gtk/gtk.factor | 67 ++++++++++++++++++++++++--------- 1 file changed, 50 insertions(+), 17 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 9acae5e7a5..d9caec5699 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -9,12 +9,13 @@ sequences strings system threads ui ui.backend ui.clipboards ui.event-loop ui.gadgets ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; +RENAME: windows ui.private => ui:windows IN: ui.backend.gtk SINGLETON: gtk-ui-backend TUPLE: handle ; -TUPLE: window-handle < handle window fullscreen? ; +TUPLE: window-handle < handle window fullscreen? im-context ; : ( window -- window-handle ) [ window-handle new ] dip >>window ; @@ -174,25 +175,36 @@ CONSTANT: action-key-codes :: on-key-press ( sender event user-data -- result ) sender window :> world - event GdkEventKey memory>struct :> ev - ev key-event>gesture :> gesture - gesture world propagate-key-gesture - ev keyval>> gdk_keyval_to_unicode 1string dup - gesture valid-input? - [ world user-input ] [ drop ] if + world handle>> im-context>> :> im-context + im-context event gtk_im_context_filter_keypress + [ + event GdkEventKey memory>struct :> ev + ev key-event>gesture :> gesture + gesture world propagate-key-gesture + ev keyval>> gdk_keyval_to_unicode 1string dup + gesture valid-input? + [ world user-input ] [ drop ] if + ] unless t ; -: on-key-release ( sender event user-data -- result ) - drop swap [ - GdkEventKey memory>struct +:: on-key-release ( sender event user-data -- result ) + sender window :> world + world handle>> im-context>> event gtk_im_context_filter_keypress + [ + event GdkEventKey memory>struct key-event>gesture - ] dip window propagate-key-gesture t ; + world propagate-key-gesture + ] unless t ; : on-focus-in ( sender event user-data -- result ) - 2drop window focus-world t ; + 2drop window [ focus-world ] + [ handle>> im-context>> gtk_im_context_focus_in ] bi + f ; : on-focus-out ( sender event user-data -- result ) - 2drop window unfocus-world t ; + 2drop window [ unfocus-world ] + [ handle>> im-context>> gtk_im_context_focus_out ] bi + f ; : on-expose ( sender event user-data -- result ) 2drop window relayout t ; @@ -289,6 +301,17 @@ M: gtk-ui-backend (with-ui) ] with-destructors ] ui-running ; +: im-context>window ( im-context -- world ) + ui:windows get-global + [ second handle>> im-context>> = ] with find nip second ; + +:: on-commit ( im-context string' user-data -- ) + im-context im-context>window :> world + string' utf8 alien>string :> string + f string f :> gesture + gesture world propagate-key-gesture + string world user-input ; + : connect-signal ( object signal-name callback -- ) [ utf8 string>alien ] dip f f 0 g_signal_connect_data drop ; @@ -323,6 +346,10 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; +:: connect-im-signals ( im-context -- ) + im-context "commit" [ on-commit yield ] + GtkIMContext:commit connect-signal ; + CONSTANT: window-controls>decor-flags H{ { close-button 0 } @@ -375,9 +402,14 @@ CONSTANT: window-controls>func-flags M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win + gtk_im_multicontext_new :> im-context + + im-context f gtk_im_context_set_use_preedit - world win [ >>handle drop ] - [ register-window ] 2bi + win im-context >>im-context + world handle<< + + world win register-window win world [ window-loc>> auto-position ] [ dim>> first2 gtk_window_set_default_size ] 2bi @@ -385,14 +417,15 @@ M:: gtk-ui-backend (open-window) ( world -- ) world setup-gl drop win connect-signals + im-context connect-im-signals win gtk_widget_realize win world window-controls>> configure-window-controls - + win gtk_widget_show_all ; M: gtk-ui-backend (close-window) ( handle -- ) - window>> [ unregister-window ] [ gtk_widget_destroy ] bi + window>> [ gtk_widget_destroy ] [ unregister-window ] bi event-loop? [ gtk_main_quit ] unless ; M: gtk-ui-backend set-title From 5f9929c97f29f6987212f27fecc99e8682cdb785 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Thu, 10 Jun 2010 22:35:08 +0200 Subject: [PATCH 26/76] ui.backend.gtk: notify input methods of cursor locations --- basis/gdk/ffi/ffi.factor | 2 +- basis/ui/backend/gtk/gtk.factor | 82 +++++++++++++++++++++++---------- 2 files changed, 58 insertions(+), 26 deletions(-) diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 5be53b7544..d67f61f585 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -23,7 +23,7 @@ GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient GdkEventNoExpose GdkEventWindowState GdkEventSetting -GdkEventOwnerChange GdkEventGrabBroken ; +GdkEventOwnerChange GdkEventGrabBroken GdkRectangle ; GIR: vocab:gdk/Gdk-2.0.gir diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index d9caec5699..9146732e55 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -2,13 +2,15 @@ ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data alien.enums alien.strings arrays ascii assocs classes.struct -combinators.short-circuit command-line destructors +combinators.short-circuit command-line destructors gdk.ffi +gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel -libc literals locals math math.bitwise math.order namespaces -sequences strings system threads ui ui.backend ui.clipboards -ui.event-loop ui.gadgets ui.gadgets.private ui.gadgets.worlds -ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private -glib.ffi gobject.ffi gtk.ffi gdk.ffi gdk.gl.ffi gtk.gl.ffi ; +libc literals locals math math.bitwise math.order math.vectors +namespaces sequences strings system threads ui ui.backend +ui.clipboards ui.event-loop ui.gadgets ui.gadgets.editors +ui.gadgets.line-support ui.gadgets.private ui.gadgets.worlds +ui.gestures ui.pixel-formats ui.pixel-formats.private +ui.private ; RENAME: windows ui.private => ui:windows IN: ui.backend.gtk @@ -17,8 +19,10 @@ SINGLETON: gtk-ui-backend TUPLE: handle ; TUPLE: window-handle < handle window fullscreen? im-context ; -: ( window -- window-handle ) - [ window-handle new ] dip >>window ; +: ( window im-context -- window-handle ) + window-handle new + swap >>im-context + swap >>window ; TUPLE: gtk-clipboard handle ; @@ -128,10 +132,29 @@ CONSTANT: action-key-codes : mouse-event>gesture ( event -- modifiers button loc ) [ event-modifiers ] [ button>> ] [ event-loc ] tri ; +: gadget-location ( gadget -- loc ) + [ loc>> ] [ + parent>> [ gadget-location ] [ { 0 0 } ] if* + ] bi v+ ; + +: focusable-editor ( world -- editor/f ) + focusable-child dup editor? [ drop f ] unless ; + +: get-cursor-location ( editor -- GdkRectangle ) + [ [ gadget-location ] [ caret-loc ] bi v+ first2 ] + [ line-height ] bi 0 swap GdkRectangle ; + +: update-im-cursor-location ( world -- ) + dup focusable-editor [ + [ handle>> im-context>> ] [ get-cursor-location ] bi* + gtk_im_context_set_cursor_location + ] [ drop ] if* ; + : on-motion ( sender event user-data -- result ) - drop swap - [ GdkEventMotion memory>struct event-loc ] dip window - move-hand fire-motion t ; + drop swap [ + [ GdkEventMotion memory>struct event-loc ] dip window + move-hand fire-motion + ] [ window update-im-cursor-location ] bi t ; : on-enter ( sender event user-data -- result ) on-motion ; @@ -155,7 +178,8 @@ CONSTANT: action-key-codes drop swap [ GdkEventScroll memory>struct [ scroll-direction ] [ event-loc ] bi - ] dip window send-scroll t ; + ] dip window + [ send-scroll ] [ update-im-cursor-location ] bi t ; : key-sym ( event -- sym action? ) keyval>> dup action-key-codes at @@ -185,7 +209,7 @@ CONSTANT: action-key-codes gesture valid-input? [ world user-input ] [ drop ] if ] unless - t ; + world update-im-cursor-location t ; :: on-key-release ( sender event user-data -- result ) sender window :> world @@ -194,16 +218,19 @@ CONSTANT: action-key-codes event GdkEventKey memory>struct key-event>gesture world propagate-key-gesture - ] unless t ; + ] unless + world update-im-cursor-location t ; : on-focus-in ( sender event user-data -- result ) 2drop window [ focus-world ] - [ handle>> im-context>> gtk_im_context_focus_in ] bi + [ handle>> im-context>> gtk_im_context_focus_in ] + [ update-im-cursor-location ] tri f ; : on-focus-out ( sender event user-data -- result ) 2drop window [ unfocus-world ] - [ handle>> im-context>> gtk_im_context_focus_out ] bi + [ handle>> im-context>> gtk_im_context_focus_out ] + [ update-im-cursor-location ] tri f ; : on-expose ( sender event user-data -- result ) @@ -310,7 +337,8 @@ M: gtk-ui-backend (with-ui) string' utf8 alien>string :> string f string f :> gesture gesture world propagate-key-gesture - string world user-input ; + string world user-input + world update-im-cursor-location ; : connect-signal ( object signal-name callback -- ) [ utf8 string>alien ] dip f f 0 g_signal_connect_data drop ; @@ -406,8 +434,7 @@ M:: gtk-ui-backend (open-window) ( world -- ) im-context f gtk_im_context_set_use_preedit - win im-context >>im-context - world handle<< + win im-context world handle<< world win register-window @@ -422,10 +449,14 @@ M:: gtk-ui-backend (open-window) ( world -- ) win gtk_widget_realize win world window-controls>> configure-window-controls + im-context win gtk_widget_get_window + gtk_im_context_set_client_window + win gtk_widget_show_all ; M: gtk-ui-backend (close-window) ( handle -- ) - window>> [ gtk_widget_destroy ] [ unregister-window ] bi + [ im-context>> f gtk_im_context_set_client_window ] + [ window>> [ gtk_widget_destroy ] [ unregister-window ] bi ] bi event-loop? [ gtk_main_quit ] unless ; M: gtk-ui-backend set-title @@ -433,10 +464,12 @@ M: gtk-ui-backend set-title gtk_window_set_title ; M: gtk-ui-backend (set-fullscreen) - [ handle>> ] dip [ >>fullscreen? ] keep - [ window>> ] dip - [ gtk_window_fullscreen ] - [ gtk_window_unfullscreen ] if ; + [ + [ handle>> ] dip [ >>fullscreen? ] keep + [ window>> ] dip + [ gtk_window_fullscreen ] + [ gtk_window_unfullscreen ] if + ] [ drop update-im-cursor-location ] 2bi ; M: gtk-ui-backend (fullscreen?) handle>> fullscreen?>> ; @@ -488,4 +521,3 @@ M: gtk-clipboard set-clipboard-contents gtk-ui-backend ui-backend set-global [ "ui.tools" ] main-vocab-hook set-global - From b9a5b0c16e6c9ac4eb032bee81364d3957ab2e5e Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Fri, 11 Jun 2010 19:43:11 +0600 Subject: [PATCH 27/76] ui.backend.gtk: add simple input method support (GtkIMContextSimple) --- basis/ui/backend/gtk/gtk.factor | 76 +++++++++++++++++++++------------ 1 file changed, 48 insertions(+), 28 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 9acae5e7a5..3a2835c1b1 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -156,37 +156,24 @@ CONSTANT: action-key-codes [ scroll-direction ] [ event-loc ] bi ] dip window send-scroll t ; -: key-sym ( event -- sym action? ) - keyval>> dup action-key-codes at - [ t ] [ gdk_keyval_to_unicode 1string f ] ?if ; +: key-sym ( event -- sym/f action? ) + keyval>> dup action-key-codes at [ t ] + [ gdk_keyval_to_unicode [ f ] [ 1string ] if-zero f ] ?if ; -: key-event>gesture ( event -- modifiers sym action? ) +: key-event>gesture ( event -- mods sym/f action? ) + GdkEventKey memory>struct [ event-modifiers ] [ key-sym ] bi ; -: valid-input? ( string gesture -- ? ) - over empty? [ 2drop f ] [ - mods>> { f { S+ } } member? [ - [ { [ 127 = not ] [ CHAR: \s >= ] } 1&& ] all? - ] [ - [ { [ 127 = not ] [ CHAR: \s >= ] [ alpha? not ] } 1&& ] all? - ] if - ] if ; - -:: on-key-press ( sender event user-data -- result ) - sender window :> world - event GdkEventKey memory>struct :> ev - ev key-event>gesture :> gesture - gesture world propagate-key-gesture - ev keyval>> gdk_keyval_to_unicode 1string dup - gesture valid-input? - [ world user-input ] [ drop ] if - t ; +: send-key-gesture ( win gesture -- ) + swap window propagate-key-gesture ; + +: on-key-press ( sender event user-data -- result ) + drop key-event>gesture over + [ send-key-gesture ] [ 3drop drop ] if t ; : on-key-release ( sender event user-data -- result ) - drop swap [ - GdkEventKey memory>struct - key-event>gesture - ] dip window propagate-key-gesture t ; + drop key-event>gesture over + [ send-key-gesture ] [ 3drop drop ] if t ; : on-focus-in ( sender event user-data -- result ) 2drop window focus-world t ; @@ -289,8 +276,11 @@ M: gtk-ui-backend (with-ui) ] with-destructors ] ui-running ; +: connect-signal-with-data ( object signal-name callback data -- ) + [ utf8 string>alien ] 2dip f 0 g_signal_connect_data drop ; + : connect-signal ( object signal-name callback -- ) - [ utf8 string>alien ] dip f f 0 g_signal_connect_data drop ; + f connect-signal-with-data ; :: connect-signals ( win -- ) win events-mask [ enum>number ] [ bitor ] map-reduce @@ -323,6 +313,34 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; +: on-key-event-for-im ( sender event user-data -- result ) + swap gtk_im_context_filter_keypress 2drop f ; + +: on-focus-out-for-im ( sender event user-data -- result ) + 2nip gtk_im_context_reset f ; + +: on-destroy-for-im ( sender user-data -- result ) + nip g_object_unref f ; + +: on-im-commit ( sender str user_data -- ) + [ drop ] [ utf8 alien>string ] [ window ] tri* user-input ; + +:: configure-im ( win -- ) + gtk_im_context_simple_new :> im + im win gtk_im_context_set_client_window + + im "commit" [ on-im-commit yield ] + GtkIMContext:commit win connect-signal-with-data + + win "key-press-event" [ on-key-event-for-im ] + GtkWidget:key-press-event im connect-signal-with-data + win "key-release-event" [ on-key-event-for-im ] + GtkWidget:key-release-event im connect-signal-with-data + win "focus-out-event" [ on-focus-out-for-im ] + GtkWidget:focus-out-event im connect-signal-with-data + win "destroy" [ on-destroy-for-im ] + GtkObject:destroy im connect-signal-with-data ; + CONSTANT: window-controls>decor-flags H{ { close-button 0 } @@ -366,7 +384,7 @@ CONSTANT: window-controls>func-flags f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability ] with-world-pixel-format ; -: auto-position ( window loc -- ) +: auto-position ( win loc -- ) dup { 0 0 } = [ drop dup window topmost-window = GTK_WIN_POS_CENTER GTK_WIN_POS_NONE ? @@ -383,6 +401,8 @@ M:: gtk-ui-backend (open-window) ( world -- ) [ dim>> first2 gtk_window_set_default_size ] 2bi world setup-gl drop + + win configure-im win connect-signals From 4ce4b2c257a5a9dc5362f5109f68bee0e2fc1785 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Fri, 11 Jun 2010 19:33:28 +0200 Subject: [PATCH 28/76] ui.backend.gtk: add surrounding signal handler for input methods untested, as i don't think my IM is using this feature --- basis/ui/backend/gtk/gtk.factor | 58 +++++++++++++++++++++++++-------- 1 file changed, 44 insertions(+), 14 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 9146732e55..1b417633f3 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -2,15 +2,15 @@ ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data alien.enums alien.strings arrays ascii assocs classes.struct -combinators.short-circuit command-line destructors gdk.ffi -gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi -io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel -libc literals locals math math.bitwise math.order math.vectors -namespaces sequences strings system threads ui ui.backend -ui.clipboards ui.event-loop ui.gadgets ui.gadgets.editors -ui.gadgets.line-support ui.gadgets.private ui.gadgets.worlds -ui.gestures ui.pixel-formats ui.pixel-formats.private -ui.private ; +combinators combinators.short-circuit command-line destructors +documents gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi +gtk.gl.ffi io.backend.unix.multiplexers io.encodings.utf8 +io.thread kernel libc literals locals math math.bitwise +math.order math.vectors namespaces sequences strings system +threads ui ui.backend ui.clipboards ui.event-loop ui.gadgets +ui.gadgets.editors ui.gadgets.line-support ui.gadgets.private +ui.gadgets.worlds ui.gestures ui.pixel-formats +ui.pixel-formats.private ui.private ; RENAME: windows ui.private => ui:windows IN: ui.backend.gtk @@ -328,18 +328,38 @@ M: gtk-ui-backend (with-ui) ] with-destructors ] ui-running ; -: im-context>window ( im-context -- world ) +: im-context>world ( im-context -- world ) ui:windows get-global [ second handle>> im-context>> = ] with find nip second ; :: on-commit ( im-context string' user-data -- ) - im-context im-context>window :> world + im-context im-context>world :> world string' utf8 alien>string :> string f string f :> gesture gesture world propagate-key-gesture string world user-input world update-im-cursor-location ; +:: on-retrieve-surrounding ( im-context user-data -- ? ) + im-context im-context>world focusable-editor + [| editor | + editor editor-caret first2 :> ( x y ) + im-context + y editor editor-line utf8 string>alien + -1 x + gtk_im_context_set_surrounding t + ] [ f ] if* ; + +:: on-delete-surrounding ( im-context offset n user-data -- ? ) + im-context im-context>world :> world + world focusable-editor [| editor | + editor editor-caret first2 :> ( x y ) + x offset + y [ 2array ] [ [ n + ] dip 2array ] 2bi + editor remove-doc-range + world update-im-cursor-location + t + ] [ f ] if* ; + : connect-signal ( object signal-name callback -- ) [ utf8 string>alien ] dip f f 0 g_signal_connect_data drop ; @@ -374,9 +394,19 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; -:: connect-im-signals ( im-context -- ) - im-context "commit" [ on-commit yield ] - GtkIMContext:commit connect-signal ; +: connect-im-signals ( im-context -- ) + { + [ + "commit" [ on-commit yield ] + GtkIMContext:commit connect-signal + ] [ + "retrieve-surrounding" [ on-retrieve-surrounding yield ] + GtkIMContext:retrieve-surrounding connect-signal + ] [ + "delete-surrounding" [ on-delete-surrounding yield ] + GtkIMContext:delete-surrounding connect-signal + ] + } cleave ; CONSTANT: window-controls>decor-flags H{ From a11d2b06c6f3d2beb02ec1d74db7dcf5c06c5473 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 13 Jun 2010 16:18:51 +0600 Subject: [PATCH 29/76] ui.backend.gtk: add destructor in clipboard-contents --- basis/glib/ffi/ffi.factor | 1 + basis/ui/backend/gtk/gtk.factor | 5 ++++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index 51fa3af04c..99183a88dc 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -72,6 +72,7 @@ IMPLEMENT-STRUCTS: GPollFD GSource GSourceFuncs ; GIR: vocab:glib/GLib-2.0.gir DESTRUCTOR: g_source_unref +DESTRUCTOR: g_free CALLBACK: gboolean GSourceFuncsPrepareFunc ( GSource* source, gint* timeout_ ) ; CALLBACK: gboolean GSourceFuncsCheckFunc ( GSource* source ) ; diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 3a2835c1b1..045a75d075 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -466,7 +466,10 @@ M:: gtk-ui-backend system-alert ( caption text -- ) [ gtk_widget_destroy ] tri ; M: gtk-clipboard clipboard-contents - handle>> gtk_clipboard_wait_for_text utf8 alien>string ; + [ + handle>> gtk_clipboard_wait_for_text + [ &g_free utf8 alien>string ] [ f ] if* + ] with-destructors ; M: gtk-clipboard set-clipboard-contents swap [ handle>> ] [ utf8 string>alien ] bi* From 375ebd40ef0426f9f1a94b2601be979c7661a57d Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 13 Jun 2010 16:53:24 +0600 Subject: [PATCH 30/76] ui.backend.gtk: change authors list --- basis/ui/backend/gtk/authors.txt | 1 + basis/ui/backend/gtk/gtk.factor | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/basis/ui/backend/gtk/authors.txt b/basis/ui/backend/gtk/authors.txt index 4af9fbeb0a..7239f42449 100644 --- a/basis/ui/backend/gtk/authors.txt +++ b/basis/ui/backend/gtk/authors.txt @@ -1 +1,2 @@ Anton Gorenko +Philipp Brüschweiler diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 99bbe11ad8..fa0e575c2d 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,4 +1,4 @@ -! Copyright (C) 2010 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data alien.enums alien.strings arrays ascii assocs classes.struct From 91dbcabbe0ced04421a97dd1cd3567cb3cfdc47e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Sun, 13 Jun 2010 20:34:53 +0200 Subject: [PATCH 31/76] cairo.ffi: remove some usings to break circular dependency --- basis/cairo/ffi/ffi.factor | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/basis/cairo/ffi/ffi.factor b/basis/cairo/ffi/ffi.factor index 026fa621f8..da7c1b4294 100644 --- a/basis/cairo/ffi/ffi.factor +++ b/basis/cairo/ffi/ffi.factor @@ -6,9 +6,8 @@ ! Adapted from cairo.h, version 1.5.14 ! License: http://factorcode.org/license.txt -USING: system combinators alien alien.syntax alien.c-types -alien.destructors kernel accessors sequences arrays ui.gadgets -alien.libraries classes.struct ; +USING: alien alien.c-types alien.destructors alien.libraries +alien.syntax classes.struct combinators kernel system ; IN: cairo.ffi << { From e85bdba0c2644066958ad57b85317e59e3fd30f7 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 16 Jun 2010 12:48:46 +0600 Subject: [PATCH 32/76] gtk.ffi: add gtk_widget_destroy destructor; gobject.ffi: add g_signal_connect... macros-like words --- basis/gobject/ffi/ffi.factor | 11 +++++++++++ basis/gtk/ffi/ffi.factor | 6 ++++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index a5b74e3aeb..c82ec75412 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -60,3 +60,14 @@ CONSTANT: G_TYPE_BOXED $[ 18 2 shift ] CONSTANT: G_TYPE_PARAM $[ 19 2 shift ] CONSTANT: G_TYPE_OBJECT $[ 20 2 shift ] +! Macros + +: g_signal_connect ( instance detailed_signal c_handler data -- result ) + f 0 g_signal_connect_data ; + +: g_signal_connect_after ( instance detailed_signal c_handler data -- result ) + f G_CONNECT_AFTER g_signal_connect_data ; + +: g_signal_connect_swapped ( instance detailed_signal c_handler data -- result ) + f G_CONNECT_SWAPPED g_signal_connect_data ; + diff --git a/basis/gtk/ffi/ffi.factor b/basis/gtk/ffi/ffi.factor index 64d0b7f2ea..98ea4a408b 100644 --- a/basis/gtk/ffi/ffi.factor +++ b/basis/gtk/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.libraries cairo.ffi combinators -kernel system +USING: alien alien.syntax alien.destructors alien.libraries +cairo.ffi combinators kernel system gir atk.ffi gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi gobject.ffi pango.ffi ; EXCLUDE: alien.c-types => pointer ; @@ -24,3 +24,5 @@ IMPLEMENT-STRUCTS: GtkTreeIter ; GIR: vocab:gtk/Gtk-2.0.gir +DESTRUCTOR: gtk_widget_destroy + From 0073f184fa9263b96920956637e84ad6fdd44127 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 16 Jun 2010 19:25:32 +0600 Subject: [PATCH 33/76] ui.backend.gtk: working on input methods... --- basis/ui/backend/gtk/gtk.factor | 187 ++++++++++++++++++-------------- 1 file changed, 108 insertions(+), 79 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index fa0e575c2d..3d9689f717 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,23 +1,23 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.accessors alien.c-types alien.data -alien.enums alien.strings arrays ascii assocs classes.struct -combinators combinators.short-circuit command-line destructors -documents gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi -gtk.gl.ffi io.backend.unix.multiplexers io.encodings.utf8 -io.thread kernel libc literals locals math math.bitwise -math.order math.vectors namespaces sequences strings system -threads ui ui.backend ui.clipboards ui.event-loop ui.gadgets -ui.gadgets.editors ui.gadgets.line-support ui.gadgets.private -ui.gadgets.worlds ui.gestures ui.pixel-formats +USING: accessors alien.accessors alien.c-types alien.data alien.enums +alien.strings arrays assocs classes.struct command-line destructors +gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi +io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel libc +literals locals math math.bitwise math.order math.vectors namespaces +sequences strings system threads ui ui.backend ui.clipboards +ui.commands ui.event-loop ui.gadgets ui.gadgets.menus +ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private ; RENAME: windows ui.private => ui:windows +EXCLUDE: ui.gadgets.editors => change-caret ; +RENAME: change-caret ui.gadgets.editors => editors:change-caret IN: ui.backend.gtk SINGLETON: gtk-ui-backend TUPLE: handle ; -TUPLE: window-handle < handle window fullscreen? im-context ; +TUPLE: window-handle < handle window fullscreen? im-context im-menu ; : ( window im-context -- window-handle ) window-handle new @@ -132,22 +132,6 @@ CONSTANT: action-key-codes : mouse-event>gesture ( event -- modifiers button loc ) [ event-modifiers ] [ button>> ] [ event-loc ] tri ; -: gadget-location ( gadget -- loc ) - [ loc>> ] [ parent>> [ gadget-location v+ ] when* ] bi ; - -: focusable-editor ( world -- editor/f ) - focusable-child dup editor? [ drop f ] unless ; - -: get-cursor-location ( editor -- GdkRectangle ) - [ [ gadget-location ] [ caret-loc ] bi v+ first2 ] - [ line-height ] bi 0 swap GdkRectangle ; - -: update-im-cursor-location ( world -- ) - dup focusable-editor [ - [ handle>> im-context>> ] [ get-cursor-location ] bi* - gtk_im_context_set_cursor_location - ] [ drop ] if* ; - : on-motion ( sender event user-data -- result ) drop swap [ GdkEventMotion memory>struct event-loc ] dip window @@ -184,18 +168,14 @@ CONSTANT: action-key-codes : key-event>gesture ( event -- mods sym/f action? ) GdkEventKey memory>struct [ event-modifiers ] [ key-sym ] bi ; - -: handle-key-gesture ( key-gesture world -- ) - [ propagate-key-gesture ] - [ update-im-cursor-location ] bi ; - + : on-key-press ( sender event user-data -- result ) drop swap [ key-event>gesture ] [ window ] bi* - handle-key-gesture t ; + propagate-key-gesture t ; : on-key-release ( sender event user-data -- result ) drop swap [ key-event>gesture ] [ window ] bi* - handle-key-gesture t ; + propagate-key-gesture t ; : on-focus-in ( sender event user-data -- result ) 2drop window focus-world t ; @@ -290,7 +270,7 @@ M: gtk-ui-backend (with-ui) f f gtk_gl_init init-clipboard start-ui - f io-thread-running? set-global + stop-io-thread [ init-io-event-source init-timeout @@ -299,7 +279,7 @@ M: gtk-ui-backend (with-ui) ] ui-running ; : connect-signal-with-data ( object signal-name callback data -- ) - [ utf8 string>alien ] 2dip f 0 g_signal_connect_data drop ; + [ utf8 string>alien ] 2dip g_signal_connect drop ; : connect-signal ( object signal-name callback -- ) f connect-signal-with-data ; @@ -335,54 +315,109 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; -: on-retrieve-surrounding ( im-context user-data -- ? ) - window focusable-editor [| im-context editor | - editor editor-caret first2 :> ( x y ) - im-context - y editor editor-line utf8 string>alien - -1 x - gtk_im_context_set_surrounding t - ] [ drop f ] if* ; +! ---------------------- -:: on-delete-surrounding ( im-context offset n user-data -- ? ) - user-data window :> world - world focusable-editor [| editor | - editor editor-caret first2 :> ( x y ) - x offset + y [ 2array ] [ [ n + ] dip 2array ] 2bi - editor remove-doc-range - world update-im-cursor-location - t - ] [ f ] if* ; +GENERIC: support-input-methods? ( gadget -- ? ) +GENERIC: get-cursor-surrounding ( gadget -- text cursor-pos ) +GENERIC: delete-cursor-surrounding ( offset count gadget -- ) +GENERIC: set-preedit-string ( str cursor-pos gadget -- ) +GENERIC: get-cursor-loc&dim ( gadget -- loc dim ) + +M: gadget support-input-methods? drop f ; + +M: editor support-input-methods? drop t ; + +M: editor get-cursor-surrounding + dup editor-caret first2 [ swap editor-line ] dip ; + +M: editor delete-cursor-surrounding + 3drop ; + +M: editor set-preedit-string + nip dup [ editor-caret ] keep + [ user-input* drop ] 2dip + set-caret ; + +M: editor get-cursor-loc&dim + [ caret-loc ] [ caret-dim ] bi ; + +! ---------------------- + +: on-retrieve-surrounding ( im-context win -- ? ) + window world-focus dup support-input-methods? [ + get-cursor-surrounding [ utf8 string>alien -1 ] dip + gtk_im_context_set_surrounding t + ] [ 2drop f ] if ; + +: on-delete-surrounding ( im-context offset n win -- ? ) + window world-focus dup support-input-methods? + [ delete-cursor-surrounding t ] [ 3drop f ] if nip ; + +: get-preedit-string ( im-context -- str cursor-pos ) + { void* int } [ f swap gtk_im_context_get_preedit_string ] + [ [ [ utf8 alien>string ] [ g_free ] bi ] dip ] + with-out-parameters ; + +: on-preedit-changed ( im-context user-data -- ) + window world-focus dup support-input-methods? [ + [ get-preedit-string ] dip set-preedit-string + ] [ 2drop ] if ; : on-commit ( sender str user_data -- ) - [ drop ] [ utf8 alien>string ] [ window ] tri* - [ user-input ] - [ [ f swap key-down boa ] dip handle-key-gesture ] 2bi ; + [ drop ] [ utf8 alien>string ] [ window ] tri* user-input ; + +: gadget-location ( gadget -- loc ) + [ loc>> ] [ parent>> [ gadget-location v+ ] when* ] bi ; + +: gadget-cursor-location ( gadget -- rectangle ) + [ gadget-location ] [ get-cursor-loc&dim ] bi [ v+ ] dip + [ first2 ] bi@ GdkRectangle ; + +: update-cursor-location ( im-context gadget -- ) + gadget-cursor-location gtk_im_context_set_cursor_location ; ! has to be called before the window signal handler -: im-on-key-event ( sender event user-data -- result ) - [ drop ] 2dip swap gtk_im_context_filter_keypress ; +:: im-on-key-event ( sender event im-context -- result ) + sender window world-focus :> gadget + gadget support-input-methods? [ + im-context gadget update-cursor-location + im-context event gtk_im_context_filter_keypress + ] [ im-context gtk_im_context_reset f ] if ; : im-on-focus-in ( sender event user-data -- result ) - 2drop window - [ handle>> im-context>> gtk_im_context_focus_in ] - [ update-im-cursor-location ] bi f ; + 2drop window handle>> im-context>> + [ gtk_im_context_focus_in ] [ gtk_im_context_reset ] bi f ; : im-on-focus-out ( sender event user-data -- result ) - 2drop window - [ handle>> im-context>> gtk_im_context_focus_out ] - [ update-im-cursor-location ] bi f ; - -: im-on-motion ( sender event user-data -- result ) - 2drop window update-im-cursor-location f ; + 2drop window handle>> im-context>> + [ gtk_im_context_focus_out ] [ gtk_im_context_reset ] bi f ; : im-on-destroy ( sender user-data -- result ) nip [ f gtk_im_context_set_client_window ] [ g_object_unref ] bi f ; +! for testing only + +: com-input-method ( world -- ) + find-world handle>> im-menu>> f f f f 0 + gtk_get_current_event_time gtk_menu_popup ; + +: im-menu ( world -- ) + { com-input-method } show-commands-menu ; + +editor "input-method" f { + { T{ button-down f { S+ C+ } 3 } im-menu } +} define-command-map + +! -------- + :: configure-im ( win im -- ) im win gtk_widget_get_window gtk_im_context_set_client_window im f gtk_im_context_set_use_preedit + + gtk_menu_new :> menu + im menu gtk_im_multicontext_append_menuitems + menu win window handle>> im-menu<< im "commit" [ on-commit yield ] GtkIMContext:commit win connect-signal-with-data @@ -390,6 +425,8 @@ M: gtk-ui-backend (with-ui) GtkIMContext:retrieve-surrounding win connect-signal-with-data im "delete-surrounding" [ on-delete-surrounding yield ] GtkIMContext:delete-surrounding win connect-signal-with-data + im "preedit-changed" [ on-preedit-changed yield ] + GtkIMContext:preedit-changed win connect-signal-with-data win "key-press-event" [ im-on-key-event yield ] GtkWidget:key-press-event im connect-signal-with-data @@ -399,12 +436,6 @@ M: gtk-ui-backend (with-ui) GtkWidget:focus-out-event im connect-signal-with-data win "focus-out-event" [ im-on-focus-out yield ] GtkWidget:focus-out-event im connect-signal-with-data - win "motion-notify-event" [ im-on-motion yield ] - GtkWidget:motion-notify-event connect-signal - win "enter-notify-event" [ im-on-motion yield ] - GtkWidget:enter-notify-event connect-signal - win "scroll-event" [ im-on-motion yield ] - GtkWidget:scroll-event connect-signal win "destroy" [ im-on-destroy yield ] GtkObject:destroy im connect-signal-with-data ; @@ -488,12 +519,10 @@ M: gtk-ui-backend set-title gtk_window_set_title ; M: gtk-ui-backend (set-fullscreen) - [ - [ handle>> ] dip [ >>fullscreen? ] keep - [ window>> ] dip - [ gtk_window_fullscreen ] - [ gtk_window_unfullscreen ] if - ] [ drop update-im-cursor-location ] 2bi ; + [ handle>> ] dip [ >>fullscreen? ] keep + [ window>> ] dip + [ gtk_window_fullscreen ] + [ gtk_window_unfullscreen ] if ; M: gtk-ui-backend (fullscreen?) handle>> fullscreen?>> ; From f39f1b22a01d4c4078a9590924d9c71182a6a71f Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Fri, 18 Jun 2010 23:33:06 +0600 Subject: [PATCH 34/76] gir.ffi, ui.backend.gtk, gir.samples: change enum and bitfield generation from ENUM: to TYPEDEF: + CONSTANT:s --- basis/gir/ffi/ffi.factor | 19 +-- basis/ui/backend/gtk/gtk.factor | 147 +++++++++--------- .../gir/samples/lowlevel/opengl/opengl.factor | 11 +- 3 files changed, 86 insertions(+), 91 deletions(-) diff --git a/basis/gir/ffi/ffi.factor b/basis/gir/ffi/ffi.factor index ce33ce7c4b..4ee7f35fd2 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gir/ffi/ffi.factor @@ -1,10 +1,10 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.enums alien.parser arrays -assocs classes.parser classes.struct combinators -combinators.short-circuit definitions effects fry gir.common gir.types -kernel locals math.parser namespaces parser quotations sequences -sequences.generalizations vocabs.parser words words.constant ; +USING: accessors alien alien.c-types alien.parser arrays +classes.parser classes.struct combinators combinators.short-circuit +definitions effects fry gir.common gir.types kernel math.parser +namespaces parser quotations sequences sequences.generalizations words +words.constant ; IN: gir.ffi : string>c-type ( str -- c-type ) @@ -78,13 +78,12 @@ IN: gir.ffi } case ; : define-ffi-enum ( enum -- word ) - [ c-type>> (CREATE-C-TYPE) dup ] [ members>> [ [ c-identifier>> create-in ] - [ value>> ] bi 2array - ] map - ] bi int swap define-enum ; + [ value>> ] bi define-constant + ] each + ] [ c-type>> (CREATE-C-TYPE) [ int swap typedef ] keep ] bi ; : define-ffi-enums ( enums -- ) [ define-ffi-enum ] define-each ; @@ -102,7 +101,6 @@ IN: gir.ffi [ drop { } ] tri ] map ; -! Сделать для всех типов создание DEFER: : define-ffi-record-defer ( record -- word ) c-type>> create-in void* swap [ typedef ] keep ; @@ -151,7 +149,6 @@ IN: gir.ffi : define-ffi-interfaces ( interfaces -- ) [ define-ffi-interface ] define-each ; -! Доделать : define-ffi-interface-content ( interface -- ) { [ methods>> define-ffi-functions ] diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 3d9689f717..285b96a7c2 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.accessors alien.c-types alien.data alien.enums +USING: accessors alien.accessors alien.c-types alien.data alien.strings arrays assocs classes.struct command-line destructors gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel libc @@ -28,26 +28,26 @@ TUPLE: gtk-clipboard handle ; C: gtk-clipboard -PIXEL-FORMAT-ATTRIBUTE-TABLE: gl-config-attribs { $[ GDK_GL_USE_GL enum>number GDK_GL_RGBA enum>number ] } H{ - { double-buffered { $[ GDK_GL_DOUBLEBUFFER enum>number ] } } - { stereo { $[ GDK_GL_STEREO enum>number ] } } - ! { offscreen { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 2 } } - ! { fullscreen { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 1 } } - ! { windowed { $[ GDK_GL_DRAWABLE_TYPE enum>number ] 1 } } - { color-bits { $[ GDK_GL_BUFFER_SIZE enum>number ] } } - { red-bits { $[ GDK_GL_RED_SIZE enum>number ] } } - { green-bits { $[ GDK_GL_GREEN_SIZE enum>number ] } } - { blue-bits { $[ GDK_GL_BLUE_SIZE enum>number ] } } - { alpha-bits { $[ GDK_GL_ALPHA_SIZE enum>number ] } } - { accum-red-bits { $[ GDK_GL_ACCUM_RED_SIZE enum>number ] } } - { accum-green-bits { $[ GDK_GL_ACCUM_GREEN_SIZE enum>number ] } } - { accum-blue-bits { $[ GDK_GL_ACCUM_BLUE_SIZE enum>number ] } } - { accum-alpha-bits { $[ GDK_GL_ACCUM_ALPHA_SIZE enum>number ] } } - { depth-bits { $[ GDK_GL_DEPTH_SIZE enum>number ] } } - { stencil-bits { $[ GDK_GL_STENCIL_SIZE enum>number ] } } - { aux-buffers { $[ GDK_GL_AUX_BUFFERS enum>number ] } } - { sample-buffers { $[ GDK_GL_SAMPLE_BUFFERS enum>number ] } } - { samples { $[ GDK_GL_SAMPLES enum>number ] } } +PIXEL-FORMAT-ATTRIBUTE-TABLE: gl-config-attribs ${ GDK_GL_USE_GL GDK_GL_RGBA } H{ + { double-buffered ${ GDK_GL_DOUBLEBUFFER } } + { stereo ${ GDK_GL_STEREO } } + ! { offscreen ${ GDK_GL_DRAWABLE_TYPE 2 } } + ! { fullscreen ${ GDK_GL_DRAWABLE_TYPE 1 } } + ! { windowed ${ GDK_GL_DRAWABLE_TYPE 1 } } + { color-bits ${ GDK_GL_BUFFER_SIZE } } + { red-bits ${ GDK_GL_RED_SIZE } } + { green-bits ${ GDK_GL_GREEN_SIZE } } + { blue-bits ${ GDK_GL_BLUE_SIZE } } + { alpha-bits ${ GDK_GL_ALPHA_SIZE } } + { accum-red-bits ${ GDK_GL_ACCUM_RED_SIZE } } + { accum-green-bits ${ GDK_GL_ACCUM_GREEN_SIZE } } + { accum-blue-bits ${ GDK_GL_ACCUM_BLUE_SIZE } } + { accum-alpha-bits ${ GDK_GL_ACCUM_ALPHA_SIZE } } + { depth-bits ${ GDK_GL_DEPTH_SIZE } } + { stencil-bits ${ GDK_GL_STENCIL_SIZE } } + { aux-buffers ${ GDK_GL_AUX_BUFFERS } } + { sample-buffers ${ GDK_GL_SAMPLE_BUFFERS } } + { samples ${ GDK_GL_SAMPLES } } } M: gtk-ui-backend (make-pixel-format) @@ -62,7 +62,7 @@ M: gtk-ui-backend (pixel-format-attribute) with-out-parameters ; CONSTANT: events-mask - { + flags{ GDK_POINTER_MOTION_MASK GDK_POINTER_MOTION_HINT_MASK GDK_ENTER_NOTIFY_MASK @@ -76,40 +76,40 @@ CONSTANT: events-mask CONSTANT: modifiers { - { S+ $[ GDK_SHIFT_MASK enum>number ] } - { C+ $[ GDK_CONTROL_MASK enum>number ] } - { A+ $[ GDK_MOD1_MASK enum>number ] } + { S+ $ GDK_SHIFT_MASK } + { C+ $ GDK_CONTROL_MASK } + { A+ $ GDK_MOD1_MASK } } CONSTANT: action-key-codes H{ - ${ GDK_BackSpace "BACKSPACE" } - ${ GDK_Tab "TAB" } - ${ GDK_Return "RET" } - ${ GDK_KP_Enter "ENTER" } - ${ GDK_Escape "ESC" } - ${ GDK_Delete "DELETE" } - ${ GDK_Home "HOME" } - ${ GDK_Left "LEFT" } - ${ GDK_Up "UP" } - ${ GDK_Right "RIGHT" } - ${ GDK_Down "DOWN" } - ${ GDK_Page_Up "PAGE_UP" } - ${ GDK_Page_Down "PAGE_DOWN" } - ${ GDK_End "END" } - ${ GDK_Begin "BEGIN" } - ${ GDK_F1 "F1" } - ${ GDK_F2 "F2" } - ${ GDK_F3 "F3" } - ${ GDK_F4 "F4" } - ${ GDK_F5 "F5" } - ${ GDK_F6 "F6" } - ${ GDK_F7 "F7" } - ${ GDK_F8 "F8" } - ${ GDK_F9 "F9" } - ${ GDK_F10 "F10" } - ${ GDK_F11 "F11" } - ${ GDK_F12 "F12" } + { $ GDK_BackSpace "BACKSPACE" } + { $ GDK_Tab "TAB" } + { $ GDK_Return "RET" } + { $ GDK_KP_Enter "ENTER" } + { $ GDK_Escape "ESC" } + { $ GDK_Delete "DELETE" } + { $ GDK_Home "HOME" } + { $ GDK_Left "LEFT" } + { $ GDK_Up "UP" } + { $ GDK_Right "RIGHT" } + { $ GDK_Down "DOWN" } + { $ GDK_Page_Up "PAGE_UP" } + { $ GDK_Page_Down "PAGE_DOWN" } + { $ GDK_End "END" } + { $ GDK_Begin "BEGIN" } + { $ GDK_F1 "F1" } + { $ GDK_F2 "F2" } + { $ GDK_F3 "F3" } + { $ GDK_F4 "F4" } + { $ GDK_F5 "F5" } + { $ GDK_F6 "F6" } + { $ GDK_F7 "F7" } + { $ GDK_F8 "F8" } + { $ GDK_F9 "F9" } + { $ GDK_F10 "F10" } + { $ GDK_F11 "F11" } + { $ GDK_F12 "F12" } } : event-modifiers ( event -- seq ) @@ -123,10 +123,10 @@ CONSTANT: action-key-codes : scroll-direction ( event -- pair ) direction>> { - ${ GDK_SCROLL_UP { 0 -1 } } - ${ GDK_SCROLL_DOWN { 0 1 } } - ${ GDK_SCROLL_LEFT { -1 0 } } - ${ GDK_SCROLL_RIGHT { 1 0 } } + { $ GDK_SCROLL_UP { 0 -1 } } + { $ GDK_SCROLL_DOWN { 0 1 } } + { $ GDK_SCROLL_LEFT { -1 0 } } + { $ GDK_SCROLL_RIGHT { 1 0 } } } at ; : mouse-event>gesture ( event -- modifiers button loc ) @@ -215,7 +215,7 @@ CONSTANT: action-key-codes yield t ; CONSTANT: poll-fd-events - { + flags{ G_IO_IN G_IO_OUT G_IO_PRI @@ -227,7 +227,7 @@ CONSTANT: poll-fd-events : create-poll-fd ( -- poll-fd ) GPollFD malloc-struct &free mx get fd>> >>fd - poll-fd-events [ enum>number ] [ bitor ] map-reduce >>events ; + poll-fd-events >>events ; : init-io-event-source ( -- ) GSourceFuncs malloc-struct &free @@ -285,8 +285,7 @@ M: gtk-ui-backend (with-ui) f connect-signal-with-data ; :: connect-signals ( win -- ) - win events-mask [ enum>number ] [ bitor ] map-reduce - gtk_widget_add_events + win events-mask gtk_widget_add_events win "expose-event" [ on-expose yield ] GtkWidget:expose-event connect-signal @@ -392,9 +391,9 @@ M: editor get-cursor-loc&dim 2drop window handle>> im-context>> [ gtk_im_context_focus_out ] [ gtk_im_context_reset ] bi f ; -: im-on-destroy ( sender user-data -- result ) +: im-on-destroy ( sender user-data -- ) nip [ f gtk_im_context_set_client_window ] - [ g_object_unref ] bi f ; + [ g_object_unref ] bi ; ! for testing only @@ -442,20 +441,20 @@ editor "input-method" f { CONSTANT: window-controls>decor-flags H{ { close-button 0 } - { minimize-button $[ GDK_DECOR_MINIMIZE enum>number ] } - { maximize-button $[ GDK_DECOR_MAXIMIZE enum>number ] } - { resize-handles $[ GDK_DECOR_RESIZEH enum>number ] } - { small-title-bar $[ GDK_DECOR_TITLE enum>number ] } - { normal-title-bar $[ GDK_DECOR_TITLE enum>number ] } + { minimize-button $ GDK_DECOR_MINIMIZE } + { maximize-button $ GDK_DECOR_MAXIMIZE } + { resize-handles $ GDK_DECOR_RESIZEH } + { small-title-bar $ GDK_DECOR_TITLE } + { normal-title-bar $ GDK_DECOR_TITLE } { textured-background 0 } } CONSTANT: window-controls>func-flags H{ - { close-button $[ GDK_FUNC_CLOSE enum>number ] } - { minimize-button $[ GDK_FUNC_MINIMIZE enum>number ] } - { maximize-button $[ GDK_FUNC_MAXIMIZE enum>number ] } - { resize-handles $[ GDK_FUNC_RESIZE enum>number ] } + { close-button $ GDK_FUNC_CLOSE } + { minimize-button $ GDK_FUNC_MINIMIZE } + { maximize-button $ GDK_FUNC_MAXIMIZE } + { resize-handles $ GDK_FUNC_RESIZE } { small-title-bar 0 } { normal-title-bar 0 } { textured-background 0 } @@ -469,17 +468,17 @@ CONSTANT: window-controls>func-flags ] [ [ gtk_widget_get_window ] dip window-controls>decor-flags symbols>flags - GDK_DECOR_BORDER enum>number bitor gdk_window_set_decorations + GDK_DECOR_BORDER bitor gdk_window_set_decorations ] [ [ gtk_widget_get_window ] dip window-controls>func-flags symbols>flags - GDK_FUNC_MOVE enum>number bitor gdk_window_set_functions + GDK_FUNC_MOVE bitor gdk_window_set_functions ] 2tri ; : setup-gl ( world -- ? ) [ [ handle>> window>> ] [ handle>> ] bi* - f t GDK_GL_RGBA_TYPE enum>number gtk_widget_set_gl_capability + f t GDK_GL_RGBA_TYPE gtk_widget_set_gl_capability ] with-world-pixel-format ; : auto-position ( win loc -- ) diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gir/samples/lowlevel/opengl/opengl.factor index 304549d321..52d658c0b8 100644 --- a/extra/gir/samples/lowlevel/opengl/opengl.factor +++ b/extra/gir/samples/lowlevel/opengl/opengl.factor @@ -1,10 +1,10 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien.enums alien.strings gobject.ffi gtk.ffi gdk.gl.ffi -gtk.gl.ffi io.encodings.utf8 kernel locals math opengl.gl prettyprint ; +USING: alien.strings gdk.gl.ffi gobject.ffi gtk.ffi gtk.gl.ffi +io.encodings.utf8 kernel locals opengl.gl ; IN: gir.samples.lowlevel.opengl -! This sample based on +! This sample is based on ! http://code.valaide.org/content/simple-opengl-sample-using-gtkglext :: on-configure ( sender event user-data -- result ) @@ -49,10 +49,9 @@ IN: gir.samples.lowlevel.opengl [ 200 200 gtk_window_set_default_size ] [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri - GDK_GL_MODE_RGBA enum>number - gdk_gl_config_new_by_mode :> gl-config + GDK_GL_MODE_RGBA gdk_gl_config_new_by_mode :> gl-config - window gl-config f t GDK_GL_RGBA_TYPE enum>number + window gl-config f t GDK_GL_RGBA_TYPE gtk_widget_set_gl_capability drop window "configure-event" utf8 string>alien From 183a8ad6d40b68df3f83be8be0f05ff965b25303 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Fri, 16 Jul 2010 15:13:45 +0200 Subject: [PATCH 35/76] gir.loader: add GError** error parameter to functions if they declare throws="1" --- basis/gir/loader/loader.factor | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/basis/gir/loader/loader.factor b/basis/gir/loader/loader.factor index fc3de0103b..0e9ed6257f 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gir/loader/loader.factor @@ -88,11 +88,25 @@ SYMBOL: namespace-PREFIX [ load-parameter ] } cleave ; -: load-parameters ( xml callable -- callable ) +: throws-parameter ( -- parameter ) + parameter new + "error" >>name + "in" >>direction + "none" >>transfer-ownership + "GError**" >>c-type + "GLib.Error" full-type-name>type >>type ; + +: extract-parameters ( xml -- parameters ) + "parameters" tag-named "parameter" tags-named + [ xml>parameter ] map ; + +: load-parameters ( callable xml -- callable ) [ - "parameters" tag-named "parameter" tags-named - [ xml>parameter ] map - dup { f } tail? [ but-last [ t >>varargs? ] dip ] when + [ + extract-parameters + dup { f } tail? [ but-last [ t >>varargs? ] dip ] when + ] + [ "throws" attr "1" = [ throws-parameter suffix ] when ] bi >>parameters ] [ "return-value" tag-named xml>return >>return ] bi ; From 32952a6071c5c5d0c5a6f288f33800237aac689f Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 17 Jul 2010 14:25:59 +0600 Subject: [PATCH 36/76] ui.backend.gtk: update to new with-out-parameters combinator --- basis/ui/backend/gtk/gtk.factor | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 285b96a7c2..4d72abdd5e 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -58,7 +58,7 @@ M: gtk-ui-backend (free-pixel-format) M: gtk-ui-backend (pixel-format-attribute) [ handle>> ] [ >gl-config-attribs ] bi* - { int } [ gdk_gl_config_get_attrib drop ] [ ] + { int } [ gdk_gl_config_get_attrib drop ] with-out-parameters ; CONSTANT: events-mask @@ -354,8 +354,8 @@ M: editor get-cursor-loc&dim : get-preedit-string ( im-context -- str cursor-pos ) { void* int } [ f swap gtk_im_context_get_preedit_string ] - [ [ [ utf8 alien>string ] [ g_free ] bi ] dip ] - with-out-parameters ; + with-out-parameters + [ [ utf8 alien>string ] [ g_free ] bi ] dip ; : on-preedit-changed ( im-context user-data -- ) window world-focus dup support-input-methods? [ From c9613cc7ceffe32f03b7ba607e6e4a151f01d03a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 17 Jul 2010 15:31:53 +0600 Subject: [PATCH 37/76] add summary.txt and tags.txt for various vocabularies --- basis/atk/summary.txt | 1 + basis/atk/tags.txt | 1 + basis/gdk/gl/summary.txt | 1 + basis/gdk/gl/tags.txt | 1 + basis/gdk/pixbuf/summary.txt | 1 + basis/gdk/pixbuf/tags.txt | 1 + basis/gdk/summary.txt | 1 + basis/gdk/tags.txt | 1 + basis/gio/summary.txt | 1 + basis/gio/tags.txt | 1 + basis/gir/summary.txt | 1 + basis/glib/summary.txt | 1 + basis/glib/tags.txt | 1 + basis/gmodule/summary.txt | 1 + basis/gmodule/tags.txt | 1 + basis/gobject/summary.txt | 1 + basis/gobject/tags.txt | 1 + basis/gst/summary.txt | 1 + basis/gst/tags.txt | 1 + basis/gtk/gl/summary.txt | 1 + basis/gtk/gl/tags.txt | 1 + basis/gtk/summary.txt | 1 + basis/gtk/tags.txt | 1 + basis/pango/cairo/summary.txt | 1 + basis/pango/cairo/tags.txt | 1 + basis/pango/summary.txt | 1 + basis/pango/tags.txt | 1 + basis/ui/backend/gtk/summary.txt | 1 + 28 files changed, 28 insertions(+) create mode 100644 basis/atk/summary.txt create mode 100755 basis/atk/tags.txt create mode 100644 basis/gdk/gl/summary.txt create mode 100755 basis/gdk/gl/tags.txt create mode 100644 basis/gdk/pixbuf/summary.txt create mode 100755 basis/gdk/pixbuf/tags.txt create mode 100644 basis/gdk/summary.txt create mode 100755 basis/gdk/tags.txt create mode 100644 basis/gio/summary.txt create mode 100755 basis/gio/tags.txt create mode 100644 basis/gir/summary.txt create mode 100644 basis/glib/summary.txt create mode 100755 basis/glib/tags.txt create mode 100644 basis/gmodule/summary.txt create mode 100755 basis/gmodule/tags.txt create mode 100644 basis/gobject/summary.txt create mode 100755 basis/gobject/tags.txt create mode 100644 basis/gst/summary.txt create mode 100755 basis/gst/tags.txt create mode 100644 basis/gtk/gl/summary.txt create mode 100755 basis/gtk/gl/tags.txt create mode 100644 basis/gtk/summary.txt create mode 100755 basis/gtk/tags.txt create mode 100644 basis/pango/cairo/summary.txt create mode 100755 basis/pango/cairo/tags.txt create mode 100644 basis/pango/summary.txt create mode 100755 basis/pango/tags.txt create mode 100644 basis/ui/backend/gtk/summary.txt diff --git a/basis/atk/summary.txt b/basis/atk/summary.txt new file mode 100644 index 0000000000..951074f75c --- /dev/null +++ b/basis/atk/summary.txt @@ -0,0 +1 @@ +Atk binding diff --git a/basis/atk/tags.txt b/basis/atk/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/atk/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gdk/gl/summary.txt b/basis/gdk/gl/summary.txt new file mode 100644 index 0000000000..bf5a1e3962 --- /dev/null +++ b/basis/gdk/gl/summary.txt @@ -0,0 +1 @@ +GdkGLExt binding diff --git a/basis/gdk/gl/tags.txt b/basis/gdk/gl/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gdk/gl/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gdk/pixbuf/summary.txt b/basis/gdk/pixbuf/summary.txt new file mode 100644 index 0000000000..6cf28e85fb --- /dev/null +++ b/basis/gdk/pixbuf/summary.txt @@ -0,0 +1 @@ +GdkPixbuf binding diff --git a/basis/gdk/pixbuf/tags.txt b/basis/gdk/pixbuf/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gdk/pixbuf/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gdk/summary.txt b/basis/gdk/summary.txt new file mode 100644 index 0000000000..c8abd2c267 --- /dev/null +++ b/basis/gdk/summary.txt @@ -0,0 +1 @@ +Gdk binding diff --git a/basis/gdk/tags.txt b/basis/gdk/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gdk/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gio/summary.txt b/basis/gio/summary.txt new file mode 100644 index 0000000000..d21533b3b7 --- /dev/null +++ b/basis/gio/summary.txt @@ -0,0 +1 @@ +GIO binding diff --git a/basis/gio/tags.txt b/basis/gio/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gio/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gir/summary.txt b/basis/gir/summary.txt new file mode 100644 index 0000000000..7be5ede755 --- /dev/null +++ b/basis/gir/summary.txt @@ -0,0 +1 @@ +GObjectIntrospection support diff --git a/basis/glib/summary.txt b/basis/glib/summary.txt new file mode 100644 index 0000000000..4bb6945388 --- /dev/null +++ b/basis/glib/summary.txt @@ -0,0 +1 @@ +GLib binding diff --git a/basis/glib/tags.txt b/basis/glib/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/glib/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gmodule/summary.txt b/basis/gmodule/summary.txt new file mode 100644 index 0000000000..d5436753a8 --- /dev/null +++ b/basis/gmodule/summary.txt @@ -0,0 +1 @@ +GModule binding diff --git a/basis/gmodule/tags.txt b/basis/gmodule/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gmodule/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gobject/summary.txt b/basis/gobject/summary.txt new file mode 100644 index 0000000000..880215cb3e --- /dev/null +++ b/basis/gobject/summary.txt @@ -0,0 +1 @@ +GObject binding diff --git a/basis/gobject/tags.txt b/basis/gobject/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gobject/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gst/summary.txt b/basis/gst/summary.txt new file mode 100644 index 0000000000..4094ff9c99 --- /dev/null +++ b/basis/gst/summary.txt @@ -0,0 +1 @@ +GStreamer binding diff --git a/basis/gst/tags.txt b/basis/gst/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gst/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gtk/gl/summary.txt b/basis/gtk/gl/summary.txt new file mode 100644 index 0000000000..91afcb623d --- /dev/null +++ b/basis/gtk/gl/summary.txt @@ -0,0 +1 @@ +GtkGLExt binding diff --git a/basis/gtk/gl/tags.txt b/basis/gtk/gl/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gtk/gl/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/gtk/summary.txt b/basis/gtk/summary.txt new file mode 100644 index 0000000000..836eaf654e --- /dev/null +++ b/basis/gtk/summary.txt @@ -0,0 +1 @@ +Gtk binding diff --git a/basis/gtk/tags.txt b/basis/gtk/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/gtk/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/pango/cairo/summary.txt b/basis/pango/cairo/summary.txt new file mode 100644 index 0000000000..8c2dacc5f0 --- /dev/null +++ b/basis/pango/cairo/summary.txt @@ -0,0 +1 @@ +PangoCairo binding diff --git a/basis/pango/cairo/tags.txt b/basis/pango/cairo/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/pango/cairo/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/pango/summary.txt b/basis/pango/summary.txt new file mode 100644 index 0000000000..256187f172 --- /dev/null +++ b/basis/pango/summary.txt @@ -0,0 +1 @@ +Pango binding diff --git a/basis/pango/tags.txt b/basis/pango/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/basis/pango/tags.txt @@ -0,0 +1 @@ +bindings diff --git a/basis/ui/backend/gtk/summary.txt b/basis/ui/backend/gtk/summary.txt new file mode 100644 index 0000000000..5aa0c63967 --- /dev/null +++ b/basis/ui/backend/gtk/summary.txt @@ -0,0 +1 @@ +Gtk-based UI backend From 659c435686edc37f4620710a8221971d4b308523 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 17 Jul 2010 17:17:03 +0600 Subject: [PATCH 38/76] rename gir to gobject-introspection --- basis/atk/ffi/ffi.factor | 2 +- basis/gdk/ffi/ffi.factor | 4 ++-- basis/gdk/gl/ffi/ffi.factor | 4 ++-- basis/gdk/pixbuf/ffi/ffi.factor | 2 +- basis/gio/ffi/ffi.factor | 2 +- basis/glib/ffi/ffi.factor | 4 ++-- basis/gmodule/ffi/ffi.factor | 2 +- basis/{gir => gobject-introspection}/authors.txt | 0 .../common/common.factor | 2 +- basis/{gir => gobject-introspection}/ffi/ffi.factor | 11 ++++++----- .../gobject-introspection.factor} | 5 +++-- .../loader/loader.factor | 10 +++++----- .../repository/repository.factor | 2 +- basis/{gir => gobject-introspection}/summary.txt | 0 .../{gir => gobject-introspection}/types/types.factor | 8 +++++--- basis/gobject/ffi/ffi.factor | 2 +- basis/gst/ffi/ffi.factor | 4 ++-- basis/gtk/ffi/ffi.factor | 4 ++-- basis/gtk/gl/ffi/ffi.factor | 4 ++-- basis/pango/cairo/ffi/ffi.factor | 2 +- basis/pango/ffi/ffi.factor | 4 ++-- 21 files changed, 41 insertions(+), 37 deletions(-) rename basis/{gir => gobject-introspection}/authors.txt (100%) rename basis/{gir => gobject-introspection}/common/common.factor (90%) rename basis/{gir => gobject-introspection}/ffi/ffi.factor (95%) rename basis/{gir/gir.factor => gobject-introspection/gobject-introspection.factor} (83%) rename basis/{gir => gobject-introspection}/loader/loader.factor (96%) rename basis/{gir => gobject-introspection}/repository/repository.factor (97%) rename basis/{gir => gobject-introspection}/summary.txt (100%) rename basis/{gir => gobject-introspection}/types/types.factor (94%) diff --git a/basis/atk/ffi/ffi.factor b/basis/atk/ffi/ffi.factor index fa3dd6910f..67c8362c73 100644 --- a/basis/atk/ffi/ffi.factor +++ b/basis/atk/ffi/ffi.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries alien.syntax combinators kernel system -gir glib.ffi gobject.ffi ; +gobject-introspection glib.ffi gobject.ffi ; IN: atk.ffi << diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index d67f61f585..11dbbc6fdb 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -2,8 +2,8 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.destructors alien.syntax alien.libraries cairo.ffi combinators kernel system -gir gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi gobject.ffi -pango.ffi ; +gobject-introspection gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi +gobject.ffi pango.ffi ; IN: gdk.ffi << diff --git a/basis/gdk/gl/ffi/ffi.factor b/basis/gdk/gl/ffi/ffi.factor index 5c57fe0013..74fa46a3b7 100644 --- a/basis/gdk/gl/ffi/ffi.factor +++ b/basis/gdk/gl/ffi/ffi.factor @@ -2,8 +2,8 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.libraries combinators kernel system vocabs.parser words -gir gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi -gobject.ffi pango.ffi ; +gobject-introspection gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi +gmodule.ffi gobject.ffi pango.ffi ; IN: gdk.gl.ffi << diff --git a/basis/gdk/pixbuf/ffi/ffi.factor b/basis/gdk/pixbuf/ffi/ffi.factor index 12e56753e1..a87ca77c3b 100644 --- a/basis/gdk/pixbuf/ffi/ffi.factor +++ b/basis/gdk/pixbuf/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries combinators kernel system -gir gio.ffi glib.ffi gmodule.ffi gobject.ffi ; +gobject-introspection gio.ffi glib.ffi gmodule.ffi gobject.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gdk.pixbuf.ffi diff --git a/basis/gio/ffi/ffi.factor b/basis/gio/ffi/ffi.factor index 16056f1fb5..e4d9b73fd0 100644 --- a/basis/gio/ffi/ffi.factor +++ b/basis/gio/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries combinators kernel system -gir glib.ffi gobject.ffi ; +gobject-introspection glib.ffi gobject.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gio.ffi diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index 99183a88dc..d7b265004e 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -1,8 +1,8 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien alien.c-types alien.destructors -alien.libraries alien.syntax combinators compiler.units gir -kernel system vocabs.parser words ; +alien.libraries alien.syntax combinators compiler.units +gobject-introspection kernel system vocabs.parser words ; IN: glib.ffi << diff --git a/basis/gmodule/ffi/ffi.factor b/basis/gmodule/ffi/ffi.factor index 449ef69249..5e3334de68 100644 --- a/basis/gmodule/ffi/ffi.factor +++ b/basis/gmodule/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries combinators kernel system -gir glib.ffi ; +gobject-introspection glib.ffi ; IN: gmodule.ffi << diff --git a/basis/gir/authors.txt b/basis/gobject-introspection/authors.txt similarity index 100% rename from basis/gir/authors.txt rename to basis/gobject-introspection/authors.txt diff --git a/basis/gir/common/common.factor b/basis/gobject-introspection/common/common.factor similarity index 90% rename from basis/gir/common/common.factor rename to basis/gobject-introspection/common/common.factor index d4984607b4..8bf2c7eb78 100644 --- a/basis/gir/common/common.factor +++ b/basis/gobject-introspection/common/common.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: assocs kernel namespaces ; -IN: gir.common +IN: gobject-introspection.common CONSTANT: ffi-vocab "ffi" diff --git a/basis/gir/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor similarity index 95% rename from basis/gir/ffi/ffi.factor rename to basis/gobject-introspection/ffi/ffi.factor index 4ee7f35fd2..9af0186553 100644 --- a/basis/gir/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -1,11 +1,12 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien alien.c-types alien.parser arrays -classes.parser classes.struct combinators combinators.short-circuit -definitions effects fry gir.common gir.types kernel math.parser -namespaces parser quotations sequences sequences.generalizations words -words.constant ; -IN: gir.ffi +classes.parser classes.struct combinators +combinators.short-circuit definitions effects fry +gobject-introspection.common gobject-introspection.types kernel +math.parser namespaces parser quotations sequences +sequences.generalizations words words.constant ; +IN: gobject-introspection.ffi : string>c-type ( str -- c-type ) parse-c-type ; diff --git a/basis/gir/gir.factor b/basis/gobject-introspection/gobject-introspection.factor similarity index 83% rename from basis/gir/gir.factor rename to basis/gobject-introspection/gobject-introspection.factor index 3c39d8d838..f0a5a982b2 100755 --- a/basis/gir/gir.factor +++ b/basis/gobject-introspection/gobject-introspection.factor @@ -1,8 +1,9 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors assocs combinators gir.common gir.ffi gir.loader +USING: accessors assocs combinators gobject-introspection.common +gobject-introspection.ffi gobject-introspection.loader kernel lexer locals math namespaces sequences vocabs.parser xml ; -IN: gir +IN: gobject-introspection : with-child-vocab ( name quot -- ) swap current-vocab name>> diff --git a/basis/gir/loader/loader.factor b/basis/gobject-introspection/loader/loader.factor similarity index 96% rename from basis/gir/loader/loader.factor rename to basis/gobject-introspection/loader/loader.factor index 0e9ed6257f..7f0b161322 100644 --- a/basis/gir/loader/loader.factor +++ b/basis/gobject-introspection/loader/loader.factor @@ -1,10 +1,11 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors ascii combinators fry gir.common gir.repository -gir.types kernel math.parser sequences splitting xml.data -xml.traversal ; +USING: accessors ascii combinators fry +gobject-introspection.common gobject-introspection.repository +gobject-introspection.types kernel math.parser sequences +splitting xml.data xml.traversal ; FROM: namespaces => set get ; -IN: gir.loader +IN: gobject-introspection.loader SYMBOL: namespace-prefix SYMBOL: namespace-PREFIX @@ -221,7 +222,6 @@ SYMBOL: namespace-PREFIX [ field new ] dip { [ "name" attr >>name ] [ "writable" attr "1" = >>writable? ] - ! Для некоторых field есть callback в качестве типа, решить, как лучше сделать [ first-child-tag dup name>> main>> "callback" = [ drop "gpointer" ] [ "type" attr ] if diff --git a/basis/gir/repository/repository.factor b/basis/gobject-introspection/repository/repository.factor similarity index 97% rename from basis/gir/repository/repository.factor rename to basis/gobject-introspection/repository/repository.factor index 1ff5b2c5b4..e6b2de7193 100644 --- a/basis/gir/repository/repository.factor +++ b/basis/gobject-introspection/repository/repository.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: ; -IN: gir.repository +IN: gobject-introspection.repository TUPLE: node name ; diff --git a/basis/gir/summary.txt b/basis/gobject-introspection/summary.txt similarity index 100% rename from basis/gir/summary.txt rename to basis/gobject-introspection/summary.txt diff --git a/basis/gir/types/types.factor b/basis/gobject-introspection/types/types.factor similarity index 94% rename from basis/gir/types/types.factor rename to basis/gobject-introspection/types/types.factor index 219eb3afff..f6d2257c79 100644 --- a/basis/gir/types/types.factor +++ b/basis/gobject-introspection/types/types.factor @@ -1,8 +1,10 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types assocs combinators.short-circuit -gir.common gir.repository kernel namespaces specialized-arrays ; -IN: gir.types +USING: accessors alien alien.c-types assocs +combinators.short-circuit gobject-introspection.common +gobject-introspection.repository kernel namespaces +specialized-arrays ; +IN: gobject-introspection.types TUPLE: gwrapper { underlying alien } ; TUPLE: grecord < gwrapper ; diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index c82ec75412..2904ceb833 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.syntax alien.destructors alien.libraries combinators kernel literals math system -gir glib.ffi ; +gobject-introspection glib.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gobject.ffi diff --git a/basis/gst/ffi/ffi.factor b/basis/gst/ffi/ffi.factor index fa110b3a5d..0bb365a755 100644 --- a/basis/gst/ffi/ffi.factor +++ b/basis/gst/ffi/ffi.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.syntax alien.libraries combinators kernel system -gir glib.ffi gmodule.ffi gobject.ffi ; +gobject-introspection glib.ffi gmodule.ffi gobject.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gst.ffi @@ -18,7 +18,7 @@ TYPEDEF: gpointer GstClockID TYPEDEF: guint64 GstClockTime TYPEDEF: gint64 GstClockTimeDiff -! Временное исправление отсутвующих типов libxml2 +! types from libxml2 TYPEDEF: void* xmlNodePtr TYPEDEF: void* xmlDocPtr TYPEDEF: void* xmlNsPtr diff --git a/basis/gtk/ffi/ffi.factor b/basis/gtk/ffi/ffi.factor index 98ea4a408b..e649025670 100644 --- a/basis/gtk/ffi/ffi.factor +++ b/basis/gtk/ffi/ffi.factor @@ -2,8 +2,8 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.syntax alien.destructors alien.libraries cairo.ffi combinators kernel system -gir atk.ffi gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi -gobject.ffi pango.ffi ; +gobject-introspection atk.ffi gdk.ffi gdk.pixbuf.ffi gio.ffi +glib.ffi gmodule.ffi gobject.ffi pango.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gtk.ffi diff --git a/basis/gtk/gl/ffi/ffi.factor b/basis/gtk/gl/ffi/ffi.factor index 9997ce81ad..775537063b 100644 --- a/basis/gtk/gl/ffi/ffi.factor +++ b/basis/gtk/gl/ffi/ffi.factor @@ -1,8 +1,8 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries combinators kernel system -gir gdk.ffi gdk.pixbuf.ffi gdk.gl.ffi gio.ffi glib.ffi -gmodule.ffi gobject.ffi gtk.ffi ; +gobject-introspection gdk.ffi gdk.pixbuf.ffi gdk.gl.ffi gio.ffi +glib.ffi gmodule.ffi gobject.ffi gtk.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gtk.gl.ffi diff --git a/basis/pango/cairo/ffi/ffi.factor b/basis/pango/cairo/ffi/ffi.factor index 2361fe5de4..c37a08b6d6 100644 --- a/basis/pango/cairo/ffi/ffi.factor +++ b/basis/pango/cairo/ffi/ffi.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.libraries alien.syntax cairo.ffi combinators kernel system -gir pango.ffi ; +gobject-introspection pango.ffi ; IN: pango.cairo.ffi << diff --git a/basis/pango/ffi/ffi.factor b/basis/pango/ffi/ffi.factor index d174ac4488..e6c794e8bf 100644 --- a/basis/pango/ffi/ffi.factor +++ b/basis/pango/ffi/ffi.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.destructors alien.libraries alien.syntax combinators kernel system -gir glib.ffi ; +gobject-introspection glib.ffi ; IN: pango.ffi << @@ -13,7 +13,7 @@ IN: pango.ffi } cond >> -TYPEDEF: void PangoLayoutRun ! не совсем верно +TYPEDEF: void PangoLayoutRun TYPEDEF: guint32 PangoGlyph IMPLEMENT-STRUCTS: PangoRectangle ; From e70e2ca073271d68e0057fb1f7241b56fb640da2 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 18 Jul 2010 11:44:49 +0600 Subject: [PATCH 39/76] rename gst -> gstreamer --- basis/{gst => gstreamer}/Gst-0.10.gir | 0 basis/{gst => gstreamer}/authors.txt | 0 basis/{gst => gstreamer}/ffi/ffi.factor | 6 +++--- basis/{gst/gst.factor => gstreamer/gstreamer.factor} | 4 ++-- basis/{gst => gstreamer}/summary.txt | 0 basis/{gst => gstreamer}/tags.txt | 0 extra/gir/samples/lowlevel/gstreamer/gstreamer.factor | 2 +- 7 files changed, 6 insertions(+), 6 deletions(-) rename basis/{gst => gstreamer}/Gst-0.10.gir (100%) rename basis/{gst => gstreamer}/authors.txt (100%) rename basis/{gst => gstreamer}/ffi/ffi.factor (89%) rename basis/{gst/gst.factor => gstreamer/gstreamer.factor} (71%) rename basis/{gst => gstreamer}/summary.txt (100%) rename basis/{gst => gstreamer}/tags.txt (100%) diff --git a/basis/gst/Gst-0.10.gir b/basis/gstreamer/Gst-0.10.gir similarity index 100% rename from basis/gst/Gst-0.10.gir rename to basis/gstreamer/Gst-0.10.gir diff --git a/basis/gst/authors.txt b/basis/gstreamer/authors.txt similarity index 100% rename from basis/gst/authors.txt rename to basis/gstreamer/authors.txt diff --git a/basis/gst/ffi/ffi.factor b/basis/gstreamer/ffi/ffi.factor similarity index 89% rename from basis/gst/ffi/ffi.factor rename to basis/gstreamer/ffi/ffi.factor index 0bb365a755..ac31e7d0c5 100644 --- a/basis/gst/ffi/ffi.factor +++ b/basis/gstreamer/ffi/ffi.factor @@ -4,10 +4,10 @@ USING: alien alien.syntax alien.libraries combinators kernel system gobject-introspection glib.ffi gmodule.ffi gobject.ffi ; EXCLUDE: alien.c-types => pointer ; -IN: gst.ffi +IN: gstreamer.ffi << -"gst" { +"gstreamer" { { [ os winnt? ] [ drop ] } { [ os macosx? ] [ drop ] } { [ os unix? ] [ "libgstreamer-0.10.so" cdecl add-library ] } @@ -23,5 +23,5 @@ TYPEDEF: void* xmlNodePtr TYPEDEF: void* xmlDocPtr TYPEDEF: void* xmlNsPtr -GIR: vocab:gst/Gst-0.10.gir +GIR: vocab:gstreamer/Gst-0.10.gir diff --git a/basis/gst/gst.factor b/basis/gstreamer/gstreamer.factor similarity index 71% rename from basis/gst/gst.factor rename to basis/gstreamer/gstreamer.factor index 073b022b95..174fbc6dca 100644 --- a/basis/gst/gst.factor +++ b/basis/gstreamer/gstreamer.factor @@ -1,5 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: gst.ffi ; -IN: gst +USING: gstreamer.ffi ; +IN: gstreamer diff --git a/basis/gst/summary.txt b/basis/gstreamer/summary.txt similarity index 100% rename from basis/gst/summary.txt rename to basis/gstreamer/summary.txt diff --git a/basis/gst/tags.txt b/basis/gstreamer/tags.txt similarity index 100% rename from basis/gst/tags.txt rename to basis/gstreamer/tags.txt diff --git a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor index c772fd11da..7508386e2c 100644 --- a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor +++ b/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien.c-types alien.strings fry byte-arrays classes.struct io.encodings.utf8 kernel locals math prettyprint -gst.ffi glib.ffi gobject.ffi gtk.ffi ; +gstreamer.ffi glib.ffi gobject.ffi gtk.ffi ; IN: gir.samples.lowlevel.gstreamer ! CONSTANT: uri "http://www.xiph.org/vorbis/listen/compilation-ogg-q4.ogg" From 832b55fe89deefd5790c6bc9073d33ddd269d145 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Thu, 22 Jul 2010 23:45:08 +0200 Subject: [PATCH 40/76] ui.backend.gtk: only set up event sources when we are deploying with io level 3 --- basis/ui/backend/gtk/gtk.factor | 27 +++++++++++++++------------ extra/hello-ui/deploy.factor | 2 +- 2 files changed, 16 insertions(+), 13 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 4d72abdd5e..441e02a04f 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,17 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data -alien.strings arrays assocs classes.struct command-line destructors -gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi -io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel libc -literals locals math math.bitwise math.order math.vectors namespaces -sequences strings system threads ui ui.backend ui.clipboards -ui.commands ui.event-loop ui.gadgets ui.gadgets.menus -ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats -ui.pixel-formats.private ui.private ; -RENAME: windows ui.private => ui:windows -EXCLUDE: ui.gadgets.editors => change-caret ; -RENAME: change-caret ui.gadgets.editors => editors:change-caret +alien.strings arrays assocs classes.struct command-line +destructors gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi +gtk.gl.ffi io.backend io.backend.unix.multiplexers +io.encodings.utf8 io.thread kernel libc literals locals math +math.bitwise math.order math.vectors namespaces sequences +strings system threads ui ui.backend ui.clipboards ui.commands +ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.menus +ui.gadgets.private ui.gadgets.worlds ui.gestures +ui.pixel-formats ui.pixel-formats.private ui.private ; IN: ui.backend.gtk SINGLETON: gtk-ui-backend @@ -229,7 +227,12 @@ CONSTANT: poll-fd-events mx get fd>> >>fd poll-fd-events >>events ; -: init-io-event-source ( -- ) +HOOK: init-io-event-source io-backend ( -- ) + +M: c-io-backend init-io-event-source + ; + +M: object init-io-event-source GSourceFuncs malloc-struct &free [ io-source-prepare ] GSourceFuncsPrepareFunc >>prepare [ io-source-check ] GSourceFuncsCheckFunc >>check diff --git a/extra/hello-ui/deploy.factor b/extra/hello-ui/deploy.factor index ceff9857cb..cf851f5a95 100644 --- a/extra/hello-ui/deploy.factor +++ b/extra/hello-ui/deploy.factor @@ -5,7 +5,7 @@ H{ { deploy-c-types? f } { deploy-unicode? f } { "stop-after-last-window?" t } - { deploy-io 1 } + { deploy-io 2 } { deploy-reflection 1 } { deploy-word-props? f } { deploy-math? t } From a8fb2494eea3710d2647c36a7cca1f9ce643b821 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Fri, 23 Jul 2010 23:17:07 +0600 Subject: [PATCH 41/76] gstreamer: add gstreamer.* vocabs --- basis/gstreamer/app/GstApp-0.10.gir | 951 +++ basis/gstreamer/app/app.factor | 5 + basis/gstreamer/app/ffi/ffi.factor | 17 + basis/gstreamer/audio/GstAudio-0.10.gir | 2360 +++++++ basis/gstreamer/audio/audio.factor | 5 + basis/gstreamer/audio/ffi/ffi.factor | 18 + basis/gstreamer/base/GstBase-0.10.gir | 5397 +++++++++++++++++ basis/gstreamer/base/base.factor | 5 + basis/gstreamer/base/ffi/ffi.factor | 16 + basis/gstreamer/check/GstCheck-0.10.gir | 808 +++ basis/gstreamer/check/check.factor | 5 + basis/gstreamer/check/ffi/ffi.factor | 20 + .../controller/GstController-0.10.gir | 1005 +++ basis/gstreamer/controller/controller.factor | 5 + basis/gstreamer/controller/ffi/ffi.factor | 17 + basis/gstreamer/fft/GstFft-0.10.gir | 462 ++ basis/gstreamer/fft/ffi/ffi.factor | 17 + basis/gstreamer/fft/fft.factor | 5 + .../interfaces/GstInterfaces-0.10.gir | 3570 +++++++++++ basis/gstreamer/interfaces/ffi/ffi.factor | 17 + basis/gstreamer/interfaces/interfaces.factor | 5 + basis/gstreamer/net/GstNet-0.10.gir | 279 + basis/gstreamer/net/ffi/ffi.factor | 17 + basis/gstreamer/net/net.factor | 5 + .../gstreamer/netbuffer/GstNetbuffer-0.10.gir | 267 + basis/gstreamer/netbuffer/ffi/ffi.factor | 16 + basis/gstreamer/netbuffer/netbuffer.factor | 5 + basis/gstreamer/pbutils/GstPbutils-0.10.gir | 665 ++ basis/gstreamer/pbutils/ffi/ffi.factor | 16 + basis/gstreamer/pbutils/pbutils.factor | 5 + basis/gstreamer/riff/GstRiff-0.10.gir | 983 +++ basis/gstreamer/riff/ffi/ffi.factor | 27 + basis/gstreamer/riff/riff.factor | 5 + basis/gstreamer/rtp/GstRtp-0.10.gir | 2550 ++++++++ basis/gstreamer/rtp/ffi/ffi.factor | 16 + basis/gstreamer/rtp/rtp.factor | 5 + basis/gstreamer/rtsp/GstRtsp-0.10.gir | 2761 +++++++++ basis/gstreamer/rtsp/ffi/ffi.factor | 20 + basis/gstreamer/rtsp/rtsp.factor | 5 + basis/gstreamer/sdp/GstSdp-0.10.gir | 1056 ++++ basis/gstreamer/sdp/ffi/ffi.factor | 16 + basis/gstreamer/sdp/sdp.factor | 5 + basis/gstreamer/tag/GstTag-0.10.gir | 797 +++ basis/gstreamer/tag/ffi/ffi.factor | 16 + basis/gstreamer/tag/tag.factor | 5 + basis/gstreamer/tags.txt | 2 + basis/gstreamer/video/GstVideo-0.10.gir | 925 +++ basis/gstreamer/video/ffi/ffi.factor | 19 + basis/gstreamer/video/video.factor | 5 + 49 files changed, 25203 insertions(+) create mode 100644 basis/gstreamer/app/GstApp-0.10.gir create mode 100644 basis/gstreamer/app/app.factor create mode 100644 basis/gstreamer/app/ffi/ffi.factor create mode 100644 basis/gstreamer/audio/GstAudio-0.10.gir create mode 100644 basis/gstreamer/audio/audio.factor create mode 100644 basis/gstreamer/audio/ffi/ffi.factor create mode 100644 basis/gstreamer/base/GstBase-0.10.gir create mode 100644 basis/gstreamer/base/base.factor create mode 100644 basis/gstreamer/base/ffi/ffi.factor create mode 100644 basis/gstreamer/check/GstCheck-0.10.gir create mode 100644 basis/gstreamer/check/check.factor create mode 100644 basis/gstreamer/check/ffi/ffi.factor create mode 100644 basis/gstreamer/controller/GstController-0.10.gir create mode 100644 basis/gstreamer/controller/controller.factor create mode 100644 basis/gstreamer/controller/ffi/ffi.factor create mode 100644 basis/gstreamer/fft/GstFft-0.10.gir create mode 100644 basis/gstreamer/fft/ffi/ffi.factor create mode 100644 basis/gstreamer/fft/fft.factor create mode 100644 basis/gstreamer/interfaces/GstInterfaces-0.10.gir create mode 100644 basis/gstreamer/interfaces/ffi/ffi.factor create mode 100644 basis/gstreamer/interfaces/interfaces.factor create mode 100644 basis/gstreamer/net/GstNet-0.10.gir create mode 100644 basis/gstreamer/net/ffi/ffi.factor create mode 100644 basis/gstreamer/net/net.factor create mode 100644 basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir create mode 100644 basis/gstreamer/netbuffer/ffi/ffi.factor create mode 100644 basis/gstreamer/netbuffer/netbuffer.factor create mode 100644 basis/gstreamer/pbutils/GstPbutils-0.10.gir create mode 100644 basis/gstreamer/pbutils/ffi/ffi.factor create mode 100644 basis/gstreamer/pbutils/pbutils.factor create mode 100644 basis/gstreamer/riff/GstRiff-0.10.gir create mode 100644 basis/gstreamer/riff/ffi/ffi.factor create mode 100644 basis/gstreamer/riff/riff.factor create mode 100644 basis/gstreamer/rtp/GstRtp-0.10.gir create mode 100644 basis/gstreamer/rtp/ffi/ffi.factor create mode 100644 basis/gstreamer/rtp/rtp.factor create mode 100644 basis/gstreamer/rtsp/GstRtsp-0.10.gir create mode 100644 basis/gstreamer/rtsp/ffi/ffi.factor create mode 100644 basis/gstreamer/rtsp/rtsp.factor create mode 100644 basis/gstreamer/sdp/GstSdp-0.10.gir create mode 100644 basis/gstreamer/sdp/ffi/ffi.factor create mode 100644 basis/gstreamer/sdp/sdp.factor create mode 100644 basis/gstreamer/tag/GstTag-0.10.gir create mode 100644 basis/gstreamer/tag/ffi/ffi.factor create mode 100644 basis/gstreamer/tag/tag.factor create mode 100644 basis/gstreamer/video/GstVideo-0.10.gir create mode 100644 basis/gstreamer/video/ffi/ffi.factor create mode 100644 basis/gstreamer/video/video.factor diff --git a/basis/gstreamer/app/GstApp-0.10.gir b/basis/gstreamer/app/GstApp-0.10.gir new file mode 100644 index 0000000000..40ccd7ed0e --- /dev/null +++ b/basis/gstreamer/app/GstApp-0.10.gir @@ -0,0 +1,951 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/app/app.factor b/basis/gstreamer/app/app.factor new file mode 100644 index 0000000000..ae80d54541 --- /dev/null +++ b/basis/gstreamer/app/app.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.app.ffi ; +IN: gstreamer.app + diff --git a/basis/gstreamer/app/ffi/ffi.factor b/basis/gstreamer/app/ffi/ffi.factor new file mode 100644 index 0000000000..b92d568fa2 --- /dev/null +++ b/basis/gstreamer/app/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gstreamer.ffi ; +IN: gstreamer.app.ffi + +<< +"gstreamer.app" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstapp-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/app/GstApp-0.10.gir + diff --git a/basis/gstreamer/audio/GstAudio-0.10.gir b/basis/gstreamer/audio/GstAudio-0.10.gir new file mode 100644 index 0000000000..73d9983fe0 --- /dev/null +++ b/basis/gstreamer/audio/GstAudio-0.10.gir @@ -0,0 +1,2360 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/audio/audio.factor b/basis/gstreamer/audio/audio.factor new file mode 100644 index 0000000000..1495be4c9e --- /dev/null +++ b/basis/gstreamer/audio/audio.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.audio.ffi ; +IN: gstreamer.audio + diff --git a/basis/gstreamer/audio/ffi/ffi.factor b/basis/gstreamer/audio/ffi/ffi.factor new file mode 100644 index 0000000000..5b0be1db23 --- /dev/null +++ b/basis/gstreamer/audio/ffi/ffi.factor @@ -0,0 +1,18 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gstreamer.ffi gstreamer.base.ffi +gstreamer.interfaces.ffi ; +IN: gstreamer.audio.ffi + +<< +"gstreamer.audio" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstaudio-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/audio/GstAudio-0.10.gir + diff --git a/basis/gstreamer/base/GstBase-0.10.gir b/basis/gstreamer/base/GstBase-0.10.gir new file mode 100644 index 0000000000..a4ebc0125b --- /dev/null +++ b/basis/gstreamer/base/GstBase-0.10.gir @@ -0,0 +1,5397 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/base/base.factor b/basis/gstreamer/base/base.factor new file mode 100644 index 0000000000..445d506e02 --- /dev/null +++ b/basis/gstreamer/base/base.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.base.ffi ; +IN: gstreamer.base + diff --git a/basis/gstreamer/base/ffi/ffi.factor b/basis/gstreamer/base/ffi/ffi.factor new file mode 100644 index 0000000000..1f15ecf3e4 --- /dev/null +++ b/basis/gstreamer/base/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gstreamer.ffi ; +IN: gstreamer.base.ffi + +<< +"gstreamer.base" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstbase-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/base/GstBase-0.10.gir + diff --git a/basis/gstreamer/check/GstCheck-0.10.gir b/basis/gstreamer/check/GstCheck-0.10.gir new file mode 100644 index 0000000000..061269c4cb --- /dev/null +++ b/basis/gstreamer/check/GstCheck-0.10.gir @@ -0,0 +1,808 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/check/check.factor b/basis/gstreamer/check/check.factor new file mode 100644 index 0000000000..e43cd026a1 --- /dev/null +++ b/basis/gstreamer/check/check.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.check.ffi ; +IN: gstreamer.check + diff --git a/basis/gstreamer/check/ffi/ffi.factor b/basis/gstreamer/check/ffi/ffi.factor new file mode 100644 index 0000000000..e52f19ccb1 --- /dev/null +++ b/basis/gstreamer/check/ffi/ffi.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gstreamer.ffi ; +FROM: unix.types => pid_t ; +IN: gstreamer.check.ffi + +<< +"gstreamer.check" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstcheck-0.10.so" cdecl add-library ] } +} cond +>> + +IMPLEMENT-STRUCTS: GstCheckABIStruct ; + +GIR: vocab:gstreamer/check/GstCheck-0.10.gir + diff --git a/basis/gstreamer/controller/GstController-0.10.gir b/basis/gstreamer/controller/GstController-0.10.gir new file mode 100644 index 0000000000..137e69a1b4 --- /dev/null +++ b/basis/gstreamer/controller/GstController-0.10.gir @@ -0,0 +1,1005 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/controller/controller.factor b/basis/gstreamer/controller/controller.factor new file mode 100644 index 0000000000..ca101cbbba --- /dev/null +++ b/basis/gstreamer/controller/controller.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.controller.ffi ; +IN: gstreamer.controller + diff --git a/basis/gstreamer/controller/ffi/ffi.factor b/basis/gstreamer/controller/ffi/ffi.factor new file mode 100644 index 0000000000..ea5de2f3a1 --- /dev/null +++ b/basis/gstreamer/controller/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gobject.ffi gstreamer.ffi ; +IN: gstreamer.controller.ffi + +<< +"gstreamer.controller" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstcontroller-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/controller/GstController-0.10.gir + diff --git a/basis/gstreamer/fft/GstFft-0.10.gir b/basis/gstreamer/fft/GstFft-0.10.gir new file mode 100644 index 0000000000..578dc59d8b --- /dev/null +++ b/basis/gstreamer/fft/GstFft-0.10.gir @@ -0,0 +1,462 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/fft/ffi/ffi.factor b/basis/gstreamer/fft/ffi/ffi.factor new file mode 100644 index 0000000000..77fd0e3d12 --- /dev/null +++ b/basis/gstreamer/fft/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gstreamer.ffi ; +IN: gstreamer.fft.ffi + +<< +"gstreamer.fft" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstfft-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/fft/GstFft-0.10.gir + diff --git a/basis/gstreamer/fft/fft.factor b/basis/gstreamer/fft/fft.factor new file mode 100644 index 0000000000..4ddb102c0a --- /dev/null +++ b/basis/gstreamer/fft/fft.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.fft.ffi ; +IN: gstreamer.fft + diff --git a/basis/gstreamer/interfaces/GstInterfaces-0.10.gir b/basis/gstreamer/interfaces/GstInterfaces-0.10.gir new file mode 100644 index 0000000000..06591faf88 --- /dev/null +++ b/basis/gstreamer/interfaces/GstInterfaces-0.10.gir @@ -0,0 +1,3570 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/interfaces/ffi/ffi.factor b/basis/gstreamer/interfaces/ffi/ffi.factor new file mode 100644 index 0000000000..45d57d2404 --- /dev/null +++ b/basis/gstreamer/interfaces/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gobject.ffi gstreamer.ffi ; +IN: gstreamer.interfaces.ffi + +<< +"gstreamer.interfaces" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstinterfaces-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/interfaces/GstInterfaces-0.10.gir + diff --git a/basis/gstreamer/interfaces/interfaces.factor b/basis/gstreamer/interfaces/interfaces.factor new file mode 100644 index 0000000000..b9b57f6759 --- /dev/null +++ b/basis/gstreamer/interfaces/interfaces.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.interfaces.ffi ; +IN: gstreamer.interfaces + diff --git a/basis/gstreamer/net/GstNet-0.10.gir b/basis/gstreamer/net/GstNet-0.10.gir new file mode 100644 index 0000000000..eb3a4b7e87 --- /dev/null +++ b/basis/gstreamer/net/GstNet-0.10.gir @@ -0,0 +1,279 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/net/ffi/ffi.factor b/basis/gstreamer/net/ffi/ffi.factor new file mode 100644 index 0000000000..5c5e315c39 --- /dev/null +++ b/basis/gstreamer/net/ffi/ffi.factor @@ -0,0 +1,17 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gstreamer.ffi ; +FROM: unix.types => socklen_t ; +IN: gstreamer.net.ffi + +<< +"gstreamer.net" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstnet-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/net/GstNet-0.10.gir + diff --git a/basis/gstreamer/net/net.factor b/basis/gstreamer/net/net.factor new file mode 100644 index 0000000000..b409685093 --- /dev/null +++ b/basis/gstreamer/net/net.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.net.ffi ; +IN: gstreamer.net + diff --git a/basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir b/basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir new file mode 100644 index 0000000000..4095f0d032 --- /dev/null +++ b/basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir @@ -0,0 +1,267 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/netbuffer/ffi/ffi.factor b/basis/gstreamer/netbuffer/ffi/ffi.factor new file mode 100644 index 0000000000..c291a8b4f1 --- /dev/null +++ b/basis/gstreamer/netbuffer/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi ; +IN: gstreamer.netbuffer.ffi + +<< +"gstreamer.netbuffer" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstnetbuffer-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/netbuffer/GstNetbuffer-0.10.gir + diff --git a/basis/gstreamer/netbuffer/netbuffer.factor b/basis/gstreamer/netbuffer/netbuffer.factor new file mode 100644 index 0000000000..7273c3a747 --- /dev/null +++ b/basis/gstreamer/netbuffer/netbuffer.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.netbuffer.ffi ; +IN: gstreamer.netbuffer + diff --git a/basis/gstreamer/pbutils/GstPbutils-0.10.gir b/basis/gstreamer/pbutils/GstPbutils-0.10.gir new file mode 100644 index 0000000000..c9748b3f1e --- /dev/null +++ b/basis/gstreamer/pbutils/GstPbutils-0.10.gir @@ -0,0 +1,665 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/pbutils/ffi/ffi.factor b/basis/gstreamer/pbutils/ffi/ffi.factor new file mode 100644 index 0000000000..f494c51c69 --- /dev/null +++ b/basis/gstreamer/pbutils/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gstreamer.ffi ; +IN: gstreamer.pbutils.ffi + +<< +"gstreamer.pbutils" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstpbutils-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/pbutils/GstPbutils-0.10.gir + diff --git a/basis/gstreamer/pbutils/pbutils.factor b/basis/gstreamer/pbutils/pbutils.factor new file mode 100644 index 0000000000..9010553008 --- /dev/null +++ b/basis/gstreamer/pbutils/pbutils.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.pbutils.ffi ; +IN: gstreamer.pbutils + diff --git a/basis/gstreamer/riff/GstRiff-0.10.gir b/basis/gstreamer/riff/GstRiff-0.10.gir new file mode 100644 index 0000000000..d3c7519f58 --- /dev/null +++ b/basis/gstreamer/riff/GstRiff-0.10.gir @@ -0,0 +1,983 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/riff/ffi/ffi.factor b/basis/gstreamer/riff/ffi/ffi.factor new file mode 100644 index 0000000000..ac31e7d0c5 --- /dev/null +++ b/basis/gstreamer/riff/ffi/ffi.factor @@ -0,0 +1,27 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.syntax alien.libraries combinators kernel +system +gobject-introspection glib.ffi gmodule.ffi gobject.ffi ; +EXCLUDE: alien.c-types => pointer ; +IN: gstreamer.ffi + +<< +"gstreamer" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstreamer-0.10.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: gpointer GstClockID +TYPEDEF: guint64 GstClockTime +TYPEDEF: gint64 GstClockTimeDiff + +! types from libxml2 +TYPEDEF: void* xmlNodePtr +TYPEDEF: void* xmlDocPtr +TYPEDEF: void* xmlNsPtr + +GIR: vocab:gstreamer/Gst-0.10.gir + diff --git a/basis/gstreamer/riff/riff.factor b/basis/gstreamer/riff/riff.factor new file mode 100644 index 0000000000..174fbc6dca --- /dev/null +++ b/basis/gstreamer/riff/riff.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.ffi ; +IN: gstreamer + diff --git a/basis/gstreamer/rtp/GstRtp-0.10.gir b/basis/gstreamer/rtp/GstRtp-0.10.gir new file mode 100644 index 0000000000..e72015073a --- /dev/null +++ b/basis/gstreamer/rtp/GstRtp-0.10.gir @@ -0,0 +1,2550 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/rtp/ffi/ffi.factor b/basis/gstreamer/rtp/ffi/ffi.factor new file mode 100644 index 0000000000..28f860549a --- /dev/null +++ b/basis/gstreamer/rtp/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gstreamer.base.ffi gstreamer.ffi ; +IN: gstreamer.rtp.ffi + +<< +"gstreamer.rtp" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstrtp-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/rtp/GstRtp-0.10.gir + diff --git a/basis/gstreamer/rtp/rtp.factor b/basis/gstreamer/rtp/rtp.factor new file mode 100644 index 0000000000..7e928c1a9f --- /dev/null +++ b/basis/gstreamer/rtp/rtp.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.rtp.ffi ; +IN: gstreamer.rtp + diff --git a/basis/gstreamer/rtsp/GstRtsp-0.10.gir b/basis/gstreamer/rtsp/GstRtsp-0.10.gir new file mode 100644 index 0000000000..b0cf681543 --- /dev/null +++ b/basis/gstreamer/rtsp/GstRtsp-0.10.gir @@ -0,0 +1,2761 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/rtsp/ffi/ffi.factor b/basis/gstreamer/rtsp/ffi/ffi.factor new file mode 100644 index 0000000000..a3989d7747 --- /dev/null +++ b/basis/gstreamer/rtsp/ffi/ffi.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.syntax alien.libraries combinators kernel +system +gobject-introspection glib.ffi gstreamer.ffi gstreamer.sdp.ffi ; +IN: gstreamer.rtsp.ffi + +<< +"gstreamer.rtsp" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstrtsp-0.10.so" cdecl add-library ] } +} cond +>> + +! git error (there is _GstRTSPTransport only in .gir) +C-TYPE: GstRTSPTransport + +GIR: vocab:gstreamer/rtsp/GstRtsp-0.10.gir + diff --git a/basis/gstreamer/rtsp/rtsp.factor b/basis/gstreamer/rtsp/rtsp.factor new file mode 100644 index 0000000000..72069f606b --- /dev/null +++ b/basis/gstreamer/rtsp/rtsp.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.rtsp.ffi ; +IN: gstreamer.rtsp + diff --git a/basis/gstreamer/sdp/GstSdp-0.10.gir b/basis/gstreamer/sdp/GstSdp-0.10.gir new file mode 100644 index 0000000000..16f62f6f58 --- /dev/null +++ b/basis/gstreamer/sdp/GstSdp-0.10.gir @@ -0,0 +1,1056 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/sdp/ffi/ffi.factor b/basis/gstreamer/sdp/ffi/ffi.factor new file mode 100644 index 0000000000..f023bb271c --- /dev/null +++ b/basis/gstreamer/sdp/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi ; +IN: gstreamer.sdp.ffi + +<< +"gstreamer.sdp" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstsdp-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/sdp/GstSdp-0.10.gir + diff --git a/basis/gstreamer/sdp/sdp.factor b/basis/gstreamer/sdp/sdp.factor new file mode 100644 index 0000000000..1cfdbfede2 --- /dev/null +++ b/basis/gstreamer/sdp/sdp.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.sdp.ffi ; +IN: gstreamer.sdp + diff --git a/basis/gstreamer/tag/GstTag-0.10.gir b/basis/gstreamer/tag/GstTag-0.10.gir new file mode 100644 index 0000000000..f5714599bb --- /dev/null +++ b/basis/gstreamer/tag/GstTag-0.10.gir @@ -0,0 +1,797 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/tag/ffi/ffi.factor b/basis/gstreamer/tag/ffi/ffi.factor new file mode 100644 index 0000000000..28eda35e8a --- /dev/null +++ b/basis/gstreamer/tag/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gstreamer.ffi ; +IN: gstreamer.tag.ffi + +<< +"gstreamer.tag" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgsttag-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:gstreamer/tag/GstTag-0.10.gir + diff --git a/basis/gstreamer/tag/tag.factor b/basis/gstreamer/tag/tag.factor new file mode 100644 index 0000000000..30c6c97ed5 --- /dev/null +++ b/basis/gstreamer/tag/tag.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.tag.ffi ; +IN: gstreamer.tag + diff --git a/basis/gstreamer/tags.txt b/basis/gstreamer/tags.txt index bb863cf9a0..be30e2cdd4 100755 --- a/basis/gstreamer/tags.txt +++ b/basis/gstreamer/tags.txt @@ -1 +1,3 @@ bindings +audio +video diff --git a/basis/gstreamer/video/GstVideo-0.10.gir b/basis/gstreamer/video/GstVideo-0.10.gir new file mode 100644 index 0000000000..ff905a0d8f --- /dev/null +++ b/basis/gstreamer/video/GstVideo-0.10.gir @@ -0,0 +1,925 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gstreamer/video/ffi/ffi.factor b/basis/gstreamer/video/ffi/ffi.factor new file mode 100644 index 0000000000..474c48b0b3 --- /dev/null +++ b/basis/gstreamer/video/ffi/ffi.factor @@ -0,0 +1,19 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gobject.ffi gstreamer.ffi ; +IN: gstreamer.video.ffi + +<< +"gstreamer.video" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgstvideo-0.10.so" cdecl add-library ] } +} cond +>> + +IMPLEMENT-STRUCTS: GstVideoRectangle ; + +GIR: vocab:gstreamer/video/GstVideo-0.10.gir + diff --git a/basis/gstreamer/video/video.factor b/basis/gstreamer/video/video.factor new file mode 100644 index 0000000000..fde33e9131 --- /dev/null +++ b/basis/gstreamer/video/video.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gstreamer.video.ffi ; +IN: gstreamer.video + From 66da664a991363a36488159645f88bd346f92713 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 24 Jul 2010 12:51:57 +0600 Subject: [PATCH 42/76] move gstreamer from basis to extra --- {basis => extra}/gstreamer/Gst-0.10.gir | 0 {basis => extra}/gstreamer/app/GstApp-0.10.gir | 0 {basis => extra}/gstreamer/app/app.factor | 0 {basis => extra}/gstreamer/app/ffi/ffi.factor | 0 {basis => extra}/gstreamer/audio/GstAudio-0.10.gir | 0 {basis => extra}/gstreamer/audio/audio.factor | 0 {basis => extra}/gstreamer/audio/ffi/ffi.factor | 0 {basis => extra}/gstreamer/authors.txt | 0 {basis => extra}/gstreamer/base/GstBase-0.10.gir | 0 {basis => extra}/gstreamer/base/base.factor | 0 {basis => extra}/gstreamer/base/ffi/ffi.factor | 0 {basis => extra}/gstreamer/check/GstCheck-0.10.gir | 0 {basis => extra}/gstreamer/check/check.factor | 0 {basis => extra}/gstreamer/check/ffi/ffi.factor | 0 {basis => extra}/gstreamer/controller/GstController-0.10.gir | 0 {basis => extra}/gstreamer/controller/controller.factor | 0 {basis => extra}/gstreamer/controller/ffi/ffi.factor | 0 {basis => extra}/gstreamer/ffi/ffi.factor | 0 {basis => extra}/gstreamer/fft/GstFft-0.10.gir | 0 {basis => extra}/gstreamer/fft/ffi/ffi.factor | 0 {basis => extra}/gstreamer/fft/fft.factor | 0 {basis => extra}/gstreamer/gstreamer.factor | 0 {basis => extra}/gstreamer/interfaces/GstInterfaces-0.10.gir | 0 {basis => extra}/gstreamer/interfaces/ffi/ffi.factor | 0 {basis => extra}/gstreamer/interfaces/interfaces.factor | 0 {basis => extra}/gstreamer/net/GstNet-0.10.gir | 0 {basis => extra}/gstreamer/net/ffi/ffi.factor | 0 {basis => extra}/gstreamer/net/net.factor | 0 {basis => extra}/gstreamer/netbuffer/GstNetbuffer-0.10.gir | 0 {basis => extra}/gstreamer/netbuffer/ffi/ffi.factor | 0 {basis => extra}/gstreamer/netbuffer/netbuffer.factor | 0 {basis => extra}/gstreamer/pbutils/GstPbutils-0.10.gir | 0 {basis => extra}/gstreamer/pbutils/ffi/ffi.factor | 0 {basis => extra}/gstreamer/pbutils/pbutils.factor | 0 {basis => extra}/gstreamer/riff/GstRiff-0.10.gir | 0 {basis => extra}/gstreamer/riff/ffi/ffi.factor | 0 {basis => extra}/gstreamer/riff/riff.factor | 0 {basis => extra}/gstreamer/rtp/GstRtp-0.10.gir | 0 {basis => extra}/gstreamer/rtp/ffi/ffi.factor | 0 {basis => extra}/gstreamer/rtp/rtp.factor | 0 {basis => extra}/gstreamer/rtsp/GstRtsp-0.10.gir | 0 {basis => extra}/gstreamer/rtsp/ffi/ffi.factor | 0 {basis => extra}/gstreamer/rtsp/rtsp.factor | 0 {basis => extra}/gstreamer/sdp/GstSdp-0.10.gir | 0 {basis => extra}/gstreamer/sdp/ffi/ffi.factor | 0 {basis => extra}/gstreamer/sdp/sdp.factor | 0 {basis => extra}/gstreamer/summary.txt | 0 {basis => extra}/gstreamer/tag/GstTag-0.10.gir | 0 {basis => extra}/gstreamer/tag/ffi/ffi.factor | 0 {basis => extra}/gstreamer/tag/tag.factor | 0 {basis => extra}/gstreamer/tags.txt | 0 {basis => extra}/gstreamer/video/GstVideo-0.10.gir | 0 {basis => extra}/gstreamer/video/ffi/ffi.factor | 0 {basis => extra}/gstreamer/video/video.factor | 0 54 files changed, 0 insertions(+), 0 deletions(-) rename {basis => extra}/gstreamer/Gst-0.10.gir (100%) rename {basis => extra}/gstreamer/app/GstApp-0.10.gir (100%) rename {basis => extra}/gstreamer/app/app.factor (100%) rename {basis => extra}/gstreamer/app/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/audio/GstAudio-0.10.gir (100%) rename {basis => extra}/gstreamer/audio/audio.factor (100%) rename {basis => extra}/gstreamer/audio/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/authors.txt (100%) rename {basis => extra}/gstreamer/base/GstBase-0.10.gir (100%) rename {basis => extra}/gstreamer/base/base.factor (100%) rename {basis => extra}/gstreamer/base/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/check/GstCheck-0.10.gir (100%) rename {basis => extra}/gstreamer/check/check.factor (100%) rename {basis => extra}/gstreamer/check/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/controller/GstController-0.10.gir (100%) rename {basis => extra}/gstreamer/controller/controller.factor (100%) rename {basis => extra}/gstreamer/controller/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/fft/GstFft-0.10.gir (100%) rename {basis => extra}/gstreamer/fft/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/fft/fft.factor (100%) rename {basis => extra}/gstreamer/gstreamer.factor (100%) rename {basis => extra}/gstreamer/interfaces/GstInterfaces-0.10.gir (100%) rename {basis => extra}/gstreamer/interfaces/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/interfaces/interfaces.factor (100%) rename {basis => extra}/gstreamer/net/GstNet-0.10.gir (100%) rename {basis => extra}/gstreamer/net/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/net/net.factor (100%) rename {basis => extra}/gstreamer/netbuffer/GstNetbuffer-0.10.gir (100%) rename {basis => extra}/gstreamer/netbuffer/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/netbuffer/netbuffer.factor (100%) rename {basis => extra}/gstreamer/pbutils/GstPbutils-0.10.gir (100%) rename {basis => extra}/gstreamer/pbutils/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/pbutils/pbutils.factor (100%) rename {basis => extra}/gstreamer/riff/GstRiff-0.10.gir (100%) rename {basis => extra}/gstreamer/riff/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/riff/riff.factor (100%) rename {basis => extra}/gstreamer/rtp/GstRtp-0.10.gir (100%) rename {basis => extra}/gstreamer/rtp/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/rtp/rtp.factor (100%) rename {basis => extra}/gstreamer/rtsp/GstRtsp-0.10.gir (100%) rename {basis => extra}/gstreamer/rtsp/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/rtsp/rtsp.factor (100%) rename {basis => extra}/gstreamer/sdp/GstSdp-0.10.gir (100%) rename {basis => extra}/gstreamer/sdp/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/sdp/sdp.factor (100%) rename {basis => extra}/gstreamer/summary.txt (100%) rename {basis => extra}/gstreamer/tag/GstTag-0.10.gir (100%) rename {basis => extra}/gstreamer/tag/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/tag/tag.factor (100%) rename {basis => extra}/gstreamer/tags.txt (100%) rename {basis => extra}/gstreamer/video/GstVideo-0.10.gir (100%) rename {basis => extra}/gstreamer/video/ffi/ffi.factor (100%) rename {basis => extra}/gstreamer/video/video.factor (100%) diff --git a/basis/gstreamer/Gst-0.10.gir b/extra/gstreamer/Gst-0.10.gir similarity index 100% rename from basis/gstreamer/Gst-0.10.gir rename to extra/gstreamer/Gst-0.10.gir diff --git a/basis/gstreamer/app/GstApp-0.10.gir b/extra/gstreamer/app/GstApp-0.10.gir similarity index 100% rename from basis/gstreamer/app/GstApp-0.10.gir rename to extra/gstreamer/app/GstApp-0.10.gir diff --git a/basis/gstreamer/app/app.factor b/extra/gstreamer/app/app.factor similarity index 100% rename from basis/gstreamer/app/app.factor rename to extra/gstreamer/app/app.factor diff --git a/basis/gstreamer/app/ffi/ffi.factor b/extra/gstreamer/app/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/app/ffi/ffi.factor rename to extra/gstreamer/app/ffi/ffi.factor diff --git a/basis/gstreamer/audio/GstAudio-0.10.gir b/extra/gstreamer/audio/GstAudio-0.10.gir similarity index 100% rename from basis/gstreamer/audio/GstAudio-0.10.gir rename to extra/gstreamer/audio/GstAudio-0.10.gir diff --git a/basis/gstreamer/audio/audio.factor b/extra/gstreamer/audio/audio.factor similarity index 100% rename from basis/gstreamer/audio/audio.factor rename to extra/gstreamer/audio/audio.factor diff --git a/basis/gstreamer/audio/ffi/ffi.factor b/extra/gstreamer/audio/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/audio/ffi/ffi.factor rename to extra/gstreamer/audio/ffi/ffi.factor diff --git a/basis/gstreamer/authors.txt b/extra/gstreamer/authors.txt similarity index 100% rename from basis/gstreamer/authors.txt rename to extra/gstreamer/authors.txt diff --git a/basis/gstreamer/base/GstBase-0.10.gir b/extra/gstreamer/base/GstBase-0.10.gir similarity index 100% rename from basis/gstreamer/base/GstBase-0.10.gir rename to extra/gstreamer/base/GstBase-0.10.gir diff --git a/basis/gstreamer/base/base.factor b/extra/gstreamer/base/base.factor similarity index 100% rename from basis/gstreamer/base/base.factor rename to extra/gstreamer/base/base.factor diff --git a/basis/gstreamer/base/ffi/ffi.factor b/extra/gstreamer/base/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/base/ffi/ffi.factor rename to extra/gstreamer/base/ffi/ffi.factor diff --git a/basis/gstreamer/check/GstCheck-0.10.gir b/extra/gstreamer/check/GstCheck-0.10.gir similarity index 100% rename from basis/gstreamer/check/GstCheck-0.10.gir rename to extra/gstreamer/check/GstCheck-0.10.gir diff --git a/basis/gstreamer/check/check.factor b/extra/gstreamer/check/check.factor similarity index 100% rename from basis/gstreamer/check/check.factor rename to extra/gstreamer/check/check.factor diff --git a/basis/gstreamer/check/ffi/ffi.factor b/extra/gstreamer/check/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/check/ffi/ffi.factor rename to extra/gstreamer/check/ffi/ffi.factor diff --git a/basis/gstreamer/controller/GstController-0.10.gir b/extra/gstreamer/controller/GstController-0.10.gir similarity index 100% rename from basis/gstreamer/controller/GstController-0.10.gir rename to extra/gstreamer/controller/GstController-0.10.gir diff --git a/basis/gstreamer/controller/controller.factor b/extra/gstreamer/controller/controller.factor similarity index 100% rename from basis/gstreamer/controller/controller.factor rename to extra/gstreamer/controller/controller.factor diff --git a/basis/gstreamer/controller/ffi/ffi.factor b/extra/gstreamer/controller/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/controller/ffi/ffi.factor rename to extra/gstreamer/controller/ffi/ffi.factor diff --git a/basis/gstreamer/ffi/ffi.factor b/extra/gstreamer/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/ffi/ffi.factor rename to extra/gstreamer/ffi/ffi.factor diff --git a/basis/gstreamer/fft/GstFft-0.10.gir b/extra/gstreamer/fft/GstFft-0.10.gir similarity index 100% rename from basis/gstreamer/fft/GstFft-0.10.gir rename to extra/gstreamer/fft/GstFft-0.10.gir diff --git a/basis/gstreamer/fft/ffi/ffi.factor b/extra/gstreamer/fft/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/fft/ffi/ffi.factor rename to extra/gstreamer/fft/ffi/ffi.factor diff --git a/basis/gstreamer/fft/fft.factor b/extra/gstreamer/fft/fft.factor similarity index 100% rename from basis/gstreamer/fft/fft.factor rename to extra/gstreamer/fft/fft.factor diff --git a/basis/gstreamer/gstreamer.factor b/extra/gstreamer/gstreamer.factor similarity index 100% rename from basis/gstreamer/gstreamer.factor rename to extra/gstreamer/gstreamer.factor diff --git a/basis/gstreamer/interfaces/GstInterfaces-0.10.gir b/extra/gstreamer/interfaces/GstInterfaces-0.10.gir similarity index 100% rename from basis/gstreamer/interfaces/GstInterfaces-0.10.gir rename to extra/gstreamer/interfaces/GstInterfaces-0.10.gir diff --git a/basis/gstreamer/interfaces/ffi/ffi.factor b/extra/gstreamer/interfaces/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/interfaces/ffi/ffi.factor rename to extra/gstreamer/interfaces/ffi/ffi.factor diff --git a/basis/gstreamer/interfaces/interfaces.factor b/extra/gstreamer/interfaces/interfaces.factor similarity index 100% rename from basis/gstreamer/interfaces/interfaces.factor rename to extra/gstreamer/interfaces/interfaces.factor diff --git a/basis/gstreamer/net/GstNet-0.10.gir b/extra/gstreamer/net/GstNet-0.10.gir similarity index 100% rename from basis/gstreamer/net/GstNet-0.10.gir rename to extra/gstreamer/net/GstNet-0.10.gir diff --git a/basis/gstreamer/net/ffi/ffi.factor b/extra/gstreamer/net/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/net/ffi/ffi.factor rename to extra/gstreamer/net/ffi/ffi.factor diff --git a/basis/gstreamer/net/net.factor b/extra/gstreamer/net/net.factor similarity index 100% rename from basis/gstreamer/net/net.factor rename to extra/gstreamer/net/net.factor diff --git a/basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir b/extra/gstreamer/netbuffer/GstNetbuffer-0.10.gir similarity index 100% rename from basis/gstreamer/netbuffer/GstNetbuffer-0.10.gir rename to extra/gstreamer/netbuffer/GstNetbuffer-0.10.gir diff --git a/basis/gstreamer/netbuffer/ffi/ffi.factor b/extra/gstreamer/netbuffer/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/netbuffer/ffi/ffi.factor rename to extra/gstreamer/netbuffer/ffi/ffi.factor diff --git a/basis/gstreamer/netbuffer/netbuffer.factor b/extra/gstreamer/netbuffer/netbuffer.factor similarity index 100% rename from basis/gstreamer/netbuffer/netbuffer.factor rename to extra/gstreamer/netbuffer/netbuffer.factor diff --git a/basis/gstreamer/pbutils/GstPbutils-0.10.gir b/extra/gstreamer/pbutils/GstPbutils-0.10.gir similarity index 100% rename from basis/gstreamer/pbutils/GstPbutils-0.10.gir rename to extra/gstreamer/pbutils/GstPbutils-0.10.gir diff --git a/basis/gstreamer/pbutils/ffi/ffi.factor b/extra/gstreamer/pbutils/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/pbutils/ffi/ffi.factor rename to extra/gstreamer/pbutils/ffi/ffi.factor diff --git a/basis/gstreamer/pbutils/pbutils.factor b/extra/gstreamer/pbutils/pbutils.factor similarity index 100% rename from basis/gstreamer/pbutils/pbutils.factor rename to extra/gstreamer/pbutils/pbutils.factor diff --git a/basis/gstreamer/riff/GstRiff-0.10.gir b/extra/gstreamer/riff/GstRiff-0.10.gir similarity index 100% rename from basis/gstreamer/riff/GstRiff-0.10.gir rename to extra/gstreamer/riff/GstRiff-0.10.gir diff --git a/basis/gstreamer/riff/ffi/ffi.factor b/extra/gstreamer/riff/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/riff/ffi/ffi.factor rename to extra/gstreamer/riff/ffi/ffi.factor diff --git a/basis/gstreamer/riff/riff.factor b/extra/gstreamer/riff/riff.factor similarity index 100% rename from basis/gstreamer/riff/riff.factor rename to extra/gstreamer/riff/riff.factor diff --git a/basis/gstreamer/rtp/GstRtp-0.10.gir b/extra/gstreamer/rtp/GstRtp-0.10.gir similarity index 100% rename from basis/gstreamer/rtp/GstRtp-0.10.gir rename to extra/gstreamer/rtp/GstRtp-0.10.gir diff --git a/basis/gstreamer/rtp/ffi/ffi.factor b/extra/gstreamer/rtp/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/rtp/ffi/ffi.factor rename to extra/gstreamer/rtp/ffi/ffi.factor diff --git a/basis/gstreamer/rtp/rtp.factor b/extra/gstreamer/rtp/rtp.factor similarity index 100% rename from basis/gstreamer/rtp/rtp.factor rename to extra/gstreamer/rtp/rtp.factor diff --git a/basis/gstreamer/rtsp/GstRtsp-0.10.gir b/extra/gstreamer/rtsp/GstRtsp-0.10.gir similarity index 100% rename from basis/gstreamer/rtsp/GstRtsp-0.10.gir rename to extra/gstreamer/rtsp/GstRtsp-0.10.gir diff --git a/basis/gstreamer/rtsp/ffi/ffi.factor b/extra/gstreamer/rtsp/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/rtsp/ffi/ffi.factor rename to extra/gstreamer/rtsp/ffi/ffi.factor diff --git a/basis/gstreamer/rtsp/rtsp.factor b/extra/gstreamer/rtsp/rtsp.factor similarity index 100% rename from basis/gstreamer/rtsp/rtsp.factor rename to extra/gstreamer/rtsp/rtsp.factor diff --git a/basis/gstreamer/sdp/GstSdp-0.10.gir b/extra/gstreamer/sdp/GstSdp-0.10.gir similarity index 100% rename from basis/gstreamer/sdp/GstSdp-0.10.gir rename to extra/gstreamer/sdp/GstSdp-0.10.gir diff --git a/basis/gstreamer/sdp/ffi/ffi.factor b/extra/gstreamer/sdp/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/sdp/ffi/ffi.factor rename to extra/gstreamer/sdp/ffi/ffi.factor diff --git a/basis/gstreamer/sdp/sdp.factor b/extra/gstreamer/sdp/sdp.factor similarity index 100% rename from basis/gstreamer/sdp/sdp.factor rename to extra/gstreamer/sdp/sdp.factor diff --git a/basis/gstreamer/summary.txt b/extra/gstreamer/summary.txt similarity index 100% rename from basis/gstreamer/summary.txt rename to extra/gstreamer/summary.txt diff --git a/basis/gstreamer/tag/GstTag-0.10.gir b/extra/gstreamer/tag/GstTag-0.10.gir similarity index 100% rename from basis/gstreamer/tag/GstTag-0.10.gir rename to extra/gstreamer/tag/GstTag-0.10.gir diff --git a/basis/gstreamer/tag/ffi/ffi.factor b/extra/gstreamer/tag/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/tag/ffi/ffi.factor rename to extra/gstreamer/tag/ffi/ffi.factor diff --git a/basis/gstreamer/tag/tag.factor b/extra/gstreamer/tag/tag.factor similarity index 100% rename from basis/gstreamer/tag/tag.factor rename to extra/gstreamer/tag/tag.factor diff --git a/basis/gstreamer/tags.txt b/extra/gstreamer/tags.txt similarity index 100% rename from basis/gstreamer/tags.txt rename to extra/gstreamer/tags.txt diff --git a/basis/gstreamer/video/GstVideo-0.10.gir b/extra/gstreamer/video/GstVideo-0.10.gir similarity index 100% rename from basis/gstreamer/video/GstVideo-0.10.gir rename to extra/gstreamer/video/GstVideo-0.10.gir diff --git a/basis/gstreamer/video/ffi/ffi.factor b/extra/gstreamer/video/ffi/ffi.factor similarity index 100% rename from basis/gstreamer/video/ffi/ffi.factor rename to extra/gstreamer/video/ffi/ffi.factor diff --git a/basis/gstreamer/video/video.factor b/extra/gstreamer/video/video.factor similarity index 100% rename from basis/gstreamer/video/video.factor rename to extra/gstreamer/video/video.factor From 0f9a2265a7623fbf69ac4e07fb870223638d0de3 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 25 Jul 2010 19:46:11 +0600 Subject: [PATCH 43/76] gstreamer: remove gstreamer.check because it is "Common code for GStreamer unit tests" --- extra/gstreamer/check/GstCheck-0.10.gir | 808 ------------------------ extra/gstreamer/check/check.factor | 5 - extra/gstreamer/check/ffi/ffi.factor | 20 - 3 files changed, 833 deletions(-) delete mode 100644 extra/gstreamer/check/GstCheck-0.10.gir delete mode 100644 extra/gstreamer/check/check.factor delete mode 100644 extra/gstreamer/check/ffi/ffi.factor diff --git a/extra/gstreamer/check/GstCheck-0.10.gir b/extra/gstreamer/check/GstCheck-0.10.gir deleted file mode 100644 index 061269c4cb..0000000000 --- a/extra/gstreamer/check/GstCheck-0.10.gir +++ /dev/null @@ -1,808 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/extra/gstreamer/check/check.factor b/extra/gstreamer/check/check.factor deleted file mode 100644 index e43cd026a1..0000000000 --- a/extra/gstreamer/check/check.factor +++ /dev/null @@ -1,5 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: gstreamer.check.ffi ; -IN: gstreamer.check - diff --git a/extra/gstreamer/check/ffi/ffi.factor b/extra/gstreamer/check/ffi/ffi.factor deleted file mode 100644 index e52f19ccb1..0000000000 --- a/extra/gstreamer/check/ffi/ffi.factor +++ /dev/null @@ -1,20 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system -gobject-introspection glib.ffi gstreamer.ffi ; -FROM: unix.types => pid_t ; -IN: gstreamer.check.ffi - -<< -"gstreamer.check" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgstcheck-0.10.so" cdecl add-library ] } -} cond ->> - -IMPLEMENT-STRUCTS: GstCheckABIStruct ; - -GIR: vocab:gstreamer/check/GstCheck-0.10.gir - From d82a78f89b2afed23c0cea2a055a44fc8febdbc6 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 25 Jul 2010 22:18:32 +0600 Subject: [PATCH 44/76] gobject-introspection: add REPLACE-C-TYPE: parsing word --- basis/gdk/ffi/ffi.factor | 2 ++ basis/glib/ffi/ffi.factor | 6 +++--- basis/gobject-introspection/common/common.factor | 4 ++++ basis/gobject-introspection/ffi/ffi.factor | 6 ++++-- .../gobject-introspection.factor | 14 ++++++++++---- basis/gobject/ffi/ffi.factor | 7 ++++--- extra/gstreamer/net/ffi/ffi.factor | 2 ++ 7 files changed, 29 insertions(+), 12 deletions(-) diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 11dbbc6fdb..28a9f7be37 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -18,6 +18,8 @@ TYPEDEF: guint32 GdkNativeWindow TYPEDEF: guint32 GdkWChar C-TYPE: GdkXEvent +REPLACE-C-TYPE: any gpointer + IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index d7b265004e..f810348aa0 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -13,8 +13,6 @@ IN: glib.ffi } cond >> -<< double "long double" current-vocab create typedef >> - TYPEDEF: char gchar TYPEDEF: uchar guchar TYPEDEF: short gshort @@ -65,7 +63,9 @@ TYPEDEF: guint32 gunichar TYPEDEF: guint16 gunichar2 TYPEDEF: gpointer pointer -TYPEDEF: gpointer any + +REPLACE-C-TYPE: long\sdouble double +REPLACE-C-TYPE: any gpointer IMPLEMENT-STRUCTS: GPollFD GSource GSourceFuncs ; diff --git a/basis/gobject-introspection/common/common.factor b/basis/gobject-introspection/common/common.factor index 8bf2c7eb78..7ffca04bde 100644 --- a/basis/gobject-introspection/common/common.factor +++ b/basis/gobject-introspection/common/common.factor @@ -14,4 +14,8 @@ SYMBOL: aliases aliases [ H{ } ] initialize SYMBOL: implement-structs +implement-structs [ V{ } ] initialize + +SYMBOL: replaced-c-types +replaced-c-types [ H{ } ] initialize diff --git a/basis/gobject-introspection/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor index 9af0186553..fb58ede1f6 100644 --- a/basis/gobject-introspection/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.parser arrays +USING: accessors alien alien.c-types alien.parser arrays assocs classes.parser classes.struct combinators combinators.short-circuit definitions effects fry gobject-introspection.common gobject-introspection.types kernel @@ -9,7 +9,9 @@ sequences.generalizations words words.constant ; IN: gobject-introspection.ffi : string>c-type ( str -- c-type ) - parse-c-type ; + dup CHAR: * swap index [ cut ] [ "" ] if* + [ replaced-c-types get-global ?at drop ] dip + append parse-c-type ; : define-each ( nodes quot -- ) '[ dup @ >>ffi drop ] each ; inline diff --git a/basis/gobject-introspection/gobject-introspection.factor b/basis/gobject-introspection/gobject-introspection.factor index f0a5a982b2..ae934ea76f 100755 --- a/basis/gobject-introspection/gobject-introspection.factor +++ b/basis/gobject-introspection/gobject-introspection.factor @@ -1,8 +1,8 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors assocs combinators gobject-introspection.common -gobject-introspection.ffi gobject-introspection.loader -kernel lexer locals math namespaces sequences vocabs.parser xml ; +gobject-introspection.ffi gobject-introspection.loader kernel lexer +locals math namespaces sequences strings.parser vocabs.parser xml ; IN: gobject-introspection : with-child-vocab ( name quot -- ) @@ -19,9 +19,15 @@ IN: gobject-introspection { [ define-ffi-repository ] } cleave - f implement-structs set-global ; + V{ } clone implement-structs set-global + H{ } clone replaced-c-types set-global ; SYNTAX: GIR: scan define-gir-vocab ; SYNTAX: IMPLEMENT-STRUCTS: - ";" parse-tokens implement-structs set-global ; + ";" parse-tokens + implement-structs [ swap append! ] change-global ; + +SYNTAX: REPLACE-C-TYPE: + scan unescape-string scan swap + replaced-c-types get-global set-at ; diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index 2904ceb833..7e2c5eace6 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.syntax alien.destructors alien.libraries -combinators kernel literals math system +classes.struct combinators kernel literals math system gobject-introspection glib.ffi ; EXCLUDE: alien.c-types => pointer ; IN: gobject.ffi @@ -18,12 +18,13 @@ TYPEDEF: void* GSignalCMarshaller TYPEDEF: void GStrv TYPEDEF: gchar* gchararray -IMPLEMENT-STRUCTS: GValue ; - GIR: vocab:gobject/GObject-2.0.gir IN: gobject.ffi +FORGET: GValue +STRUCT: GValue { g_type GType } { data guint64[2] } ; + FORGET: GIOCondition FORGET: G_IO_IN FORGET: G_IO_OUT diff --git a/extra/gstreamer/net/ffi/ffi.factor b/extra/gstreamer/net/ffi/ffi.factor index 5c5e315c39..fbd5148ff4 100644 --- a/extra/gstreamer/net/ffi/ffi.factor +++ b/extra/gstreamer/net/ffi/ffi.factor @@ -13,5 +13,7 @@ IN: gstreamer.net.ffi } cond >> +REPLACE-C-TYPE: any gpointer + GIR: vocab:gstreamer/net/GstNet-0.10.gir From 0b02a6b4d73ca0e922c55faa2e5ba5842d56611a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 25 Jul 2010 22:20:43 +0600 Subject: [PATCH 45/76] add clutter (clutter, cogl and json) and clutter-gtk bindings --- extra/clutter/Clutter-1.0.gir | 27859 +++++++++++++++++++++++ extra/clutter/authors.txt | 1 + extra/clutter/clutter.factor | 5 + extra/clutter/cogl/Cogl-1.0.gir | 5539 +++++ extra/clutter/cogl/cogl.factor | 5 + extra/clutter/cogl/ffi/ffi.factor | 25 + extra/clutter/ffi/ffi.factor | 20 + extra/clutter/gtk/GtkClutter-0.10.gir | 809 + extra/clutter/gtk/ffi/ffi.factor | 18 + extra/clutter/gtk/gtk.factor | 5 + extra/clutter/json/ClutterJson-1.0.gir | 1549 ++ extra/clutter/json/ffi/ffi.factor | 16 + extra/clutter/json/json.factor | 5 + extra/clutter/summary.txt | 1 + extra/clutter/tags.txt | 1 + 15 files changed, 35858 insertions(+) create mode 100644 extra/clutter/Clutter-1.0.gir create mode 100644 extra/clutter/authors.txt create mode 100644 extra/clutter/clutter.factor create mode 100644 extra/clutter/cogl/Cogl-1.0.gir create mode 100644 extra/clutter/cogl/cogl.factor create mode 100644 extra/clutter/cogl/ffi/ffi.factor create mode 100644 extra/clutter/ffi/ffi.factor create mode 100644 extra/clutter/gtk/GtkClutter-0.10.gir create mode 100644 extra/clutter/gtk/ffi/ffi.factor create mode 100644 extra/clutter/gtk/gtk.factor create mode 100644 extra/clutter/json/ClutterJson-1.0.gir create mode 100644 extra/clutter/json/ffi/ffi.factor create mode 100644 extra/clutter/json/json.factor create mode 100644 extra/clutter/summary.txt create mode 100755 extra/clutter/tags.txt diff --git a/extra/clutter/Clutter-1.0.gir b/extra/clutter/Clutter-1.0.gir new file mode 100644 index 0000000000..fd67f1e174 --- /dev/null +++ b/extra/clutter/Clutter-1.0.gir @@ -0,0 +1,27859 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/extra/clutter/authors.txt b/extra/clutter/authors.txt new file mode 100644 index 0000000000..ce9bcc8313 --- /dev/null +++ b/extra/clutter/authors.txt @@ -0,0 +1 @@ +Anton Gorenko \ No newline at end of file diff --git a/extra/clutter/clutter.factor b/extra/clutter/clutter.factor new file mode 100644 index 0000000000..a69a8574b6 --- /dev/null +++ b/extra/clutter/clutter.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: clutter.ffi ; +IN: clutter + diff --git a/extra/clutter/cogl/Cogl-1.0.gir b/extra/clutter/cogl/Cogl-1.0.gir new file mode 100644 index 0000000000..94159e4bee --- /dev/null +++ b/extra/clutter/cogl/Cogl-1.0.gir @@ -0,0 +1,5539 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/extra/clutter/cogl/cogl.factor b/extra/clutter/cogl/cogl.factor new file mode 100644 index 0000000000..6b54a07aef --- /dev/null +++ b/extra/clutter/cogl/cogl.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: clutter.cogl.ffi ; +IN: clutter.cogl + diff --git a/extra/clutter/cogl/ffi/ffi.factor b/extra/clutter/cogl/ffi/ffi.factor new file mode 100644 index 0000000000..e1d85c9ae3 --- /dev/null +++ b/extra/clutter/cogl/ffi/ffi.factor @@ -0,0 +1,25 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries alien.syntax +combinators kernel opengl.gl system +gobject-introspection glib.ffi ; +IN: clutter.cogl.ffi + +<< +"clutter.cogl" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libclutter-glx-1.0.so" cdecl add-library ] } +} cond +>> + +TYPEDEF: int CoglAngle +TYPEDEF: int CoglFixed +TYPEDEF: void* CoglHandle + +REPLACE-C-TYPE: unsigned\schar uchar +REPLACE-C-TYPE: unsigned\sint uint +REPLACE-C-TYPE: unsigned\slong ulong + +GIR: vocab:clutter/cogl/Cogl-1.0.gir + diff --git a/extra/clutter/ffi/ffi.factor b/extra/clutter/ffi/ffi.factor new file mode 100644 index 0000000000..bbb929468e --- /dev/null +++ b/extra/clutter/ffi/ffi.factor @@ -0,0 +1,20 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries cairo.ffi +combinators kernel system +gobject-introspection clutter.cogl.ffi clutter.json.ffi +glib.ffi gobject.ffi pango.ffi ; +IN: clutter.ffi + +<< +"clutter" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libclutter-glx-1.0.so" cdecl add-library ] } +} cond +>> + +IMPLEMENT-STRUCTS: ClutterVertex ; + +GIR: vocab:clutter/Clutter-1.0.gir + diff --git a/extra/clutter/gtk/GtkClutter-0.10.gir b/extra/clutter/gtk/GtkClutter-0.10.gir new file mode 100644 index 0000000000..7d929326ac --- /dev/null +++ b/extra/clutter/gtk/GtkClutter-0.10.gir @@ -0,0 +1,809 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/extra/clutter/gtk/ffi/ffi.factor b/extra/clutter/gtk/ffi/ffi.factor new file mode 100644 index 0000000000..eba6b39f38 --- /dev/null +++ b/extra/clutter/gtk/ffi/ffi.factor @@ -0,0 +1,18 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection clutter.ffi gdk.pixbuf.ffi glib.ffi +gtk.ffi ; +IN: clutter.gtk.ffi + +<< +"clutter.gtk" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libclutter-gtk-0.10.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:clutter/gtk/GtkClutter-0.10.gir + diff --git a/extra/clutter/gtk/gtk.factor b/extra/clutter/gtk/gtk.factor new file mode 100644 index 0000000000..6c495f5460 --- /dev/null +++ b/extra/clutter/gtk/gtk.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: clutter.gtk.ffi ; +IN: clutter.gtk + diff --git a/extra/clutter/json/ClutterJson-1.0.gir b/extra/clutter/json/ClutterJson-1.0.gir new file mode 100644 index 0000000000..e0b3cf9dff --- /dev/null +++ b/extra/clutter/json/ClutterJson-1.0.gir @@ -0,0 +1,1549 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/extra/clutter/json/ffi/ffi.factor b/extra/clutter/json/ffi/ffi.factor new file mode 100644 index 0000000000..e9b811c311 --- /dev/null +++ b/extra/clutter/json/ffi/ffi.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.libraries combinators kernel system +gobject-introspection glib.ffi gobject.ffi ; +IN: clutter.json.ffi + +<< +"clutter.json" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libclutter-glx-1.0.so" cdecl add-library ] } +} cond +>> + +GIR: vocab:clutter/json/ClutterJson-1.0.gir + diff --git a/extra/clutter/json/json.factor b/extra/clutter/json/json.factor new file mode 100644 index 0000000000..95304836c7 --- /dev/null +++ b/extra/clutter/json/json.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: clutter.json.ffi ; +IN: clutter.json + diff --git a/extra/clutter/summary.txt b/extra/clutter/summary.txt new file mode 100644 index 0000000000..e7b8c48a88 --- /dev/null +++ b/extra/clutter/summary.txt @@ -0,0 +1 @@ +Clutter binding diff --git a/extra/clutter/tags.txt b/extra/clutter/tags.txt new file mode 100755 index 0000000000..bb863cf9a0 --- /dev/null +++ b/extra/clutter/tags.txt @@ -0,0 +1 @@ +bindings From fde0321f4403de4cc7ffdacbb5750c552e2e900f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Philipp=20Br=C3=BCschweiler?= Date: Mon, 26 Jul 2010 19:27:27 +0200 Subject: [PATCH 46/76] ui.backend.gtk: don't initialize io event source when deploying with io level 1 and 2 --- basis/ui/backend/gtk/gtk.factor | 4 ++-- extra/hello-ui/deploy.factor | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 441e02a04f..2285453e5f 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -229,8 +229,8 @@ CONSTANT: poll-fd-events HOOK: init-io-event-source io-backend ( -- ) -M: c-io-backend init-io-event-source - ; +M: f init-io-event-source ; +M: c-io-backend init-io-event-source ; M: object init-io-event-source GSourceFuncs malloc-struct &free diff --git a/extra/hello-ui/deploy.factor b/extra/hello-ui/deploy.factor index cf851f5a95..ceff9857cb 100644 --- a/extra/hello-ui/deploy.factor +++ b/extra/hello-ui/deploy.factor @@ -5,7 +5,7 @@ H{ { deploy-c-types? f } { deploy-unicode? f } { "stop-after-last-window?" t } - { deploy-io 2 } + { deploy-io 1 } { deploy-reflection 1 } { deploy-word-props? f } { deploy-math? t } From 9dfa0adbfb53e43d6a56ade3e1757cb4e596007c Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Tue, 31 Aug 2010 23:01:39 +0600 Subject: [PATCH 47/76] start to write tests for 'gobject-introspection'; small fixes --- basis/glib/ffi/ffi.factor | 22 +- .../loader/loader.factor | 28 +- .../GIMarshallingTests-1.0.gir | 3600 +++++++++++++++++ .../g-i-marshalling-tests/ffi/ffi.factor | 19 + .../g-i-marshalling-tests.factor | 5 + .../tests/marshalling.factor | 295 ++ basis/gobject/ffi/ffi.factor | 2 +- 7 files changed, 3959 insertions(+), 12 deletions(-) create mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir create mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor create mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor create mode 100644 basis/gobject-introspection/tests/marshalling.factor diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index f810348aa0..405c25025f 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -1,8 +1,9 @@ ! Copyright (C) 2009 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien alien.c-types alien.destructors -alien.libraries alien.syntax combinators compiler.units -gobject-introspection kernel system vocabs.parser words ; +alien.libraries alien.syntax classes.struct combinators +compiler.units gobject-introspection kernel system vocabs.parser +words ; IN: glib.ffi << @@ -64,11 +65,26 @@ TYPEDEF: guint16 gunichar2 TYPEDEF: gpointer pointer -REPLACE-C-TYPE: long\sdouble double +STRUCT: fake-long-double { data char[10] } ; +REPLACE-C-TYPE: long\sdouble fake-long-double + REPLACE-C-TYPE: any gpointer IMPLEMENT-STRUCTS: GPollFD GSource GSourceFuncs ; +CONSTANT: G_MININT8 HEX: -80 +CONSTANT: G_MAXINT8 HEX: 7f +CONSTANT: G_MAXUINT8 HEX: ff +CONSTANT: G_MININT16 HEX: -8000 +CONSTANT: G_MAXINT16 HEX: 7fff +CONSTANT: G_MAXUINT16 HEX: ffff +CONSTANT: G_MININT32 HEX: -80000000 +CONSTANT: G_MAXINT32 HEX: 7fffffff +CONSTANT: G_MAXUINT32 HEX: ffffffff +CONSTANT: G_MININT64 HEX: -8000000000000000 +CONSTANT: G_MAXINT64 HEX: 7fffffffffffffff +CONSTANT: G_MAXUINT64 HEX: ffffffffffffffff + GIR: vocab:glib/GLib-2.0.gir DESTRUCTOR: g_source_unref diff --git a/basis/gobject-introspection/loader/loader.factor b/basis/gobject-introspection/loader/loader.factor index 7f0b161322..8c79e7a0b8 100644 --- a/basis/gobject-introspection/loader/loader.factor +++ b/basis/gobject-introspection/loader/loader.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: accessors ascii combinators fry gobject-introspection.common gobject-introspection.repository -gobject-introspection.types kernel math.parser sequences +gobject-introspection.types literals kernel math.parser sequences splitting xml.data xml.traversal ; FROM: namespaces => set get ; IN: gobject-introspection.loader @@ -57,12 +57,24 @@ SYMBOL: namespace-PREFIX { "varargs" [ drop f f ] } { "callback" [ drop f "any" f type boa ] } } case ; + +CONSTANT: type-tags { + $[ "array" ] + $[ "type" ] + $[ "varargs" ] + $[ "callback" ] +} + +: child-type-tag ( xml -- type-tag ) + children-tags [ + type-tags [ swap tag-named? ] with any? + ] find nip ; : load-parameter ( param xml -- param ) [ "transfer-ownership" attr >>transfer-ownership ] - [ first-child-tag "type" attr >>c-type ] + [ child-type-tag "type" attr >>c-type ] [ - first-child-tag xml>type + child-type-tag xml>type [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* ] tri ; @@ -146,7 +158,7 @@ SYMBOL: namespace-PREFIX [ "readable" attr "0" = not >>readable? ] [ "construct" attr "1" = >>construct? ] [ "construct-only" attr "1" = >>construct-only? ] - [ first-child-tag xml>type nip >>type ] + [ child-type-tag xml>type nip >>type ] } cleave ; : xml>callback ( xml -- callback ) @@ -223,12 +235,12 @@ SYMBOL: namespace-PREFIX [ "name" attr >>name ] [ "writable" attr "1" = >>writable? ] [ - first-child-tag dup name>> main>> "callback" = + child-type-tag dup name>> main>> "callback" = [ drop "gpointer" ] [ "type" attr ] if >>c-type ] [ - first-child-tag xml>type + child-type-tag xml>type [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* ] } cleave ; @@ -264,8 +276,8 @@ SYMBOL: namespace-PREFIX >>c-identifier ] [ "value" attr >>value ] - [ first-child-tag "type" attr >>c-type ] - [ first-child-tag xml>type nip >>type ] + [ child-type-tag "type" attr >>c-type ] + [ child-type-tag xml>type nip >>type ] } cleave ; : xml>namespace ( xml -- namespace ) diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir b/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir new file mode 100644 index 0000000000..56d62773c6 --- /dev/null +++ b/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir @@ -0,0 +1,3600 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + an array of strings + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor b/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor new file mode 100644 index 0000000000..3bf08bd601 --- /dev/null +++ b/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor @@ -0,0 +1,19 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection glib.ffi gobject.ffi ; +IN: gobject-introspection.tests.g-i-marshalling-tests.ffi + +<< +"gobject-introspection.tests.g-i-marshalling-tests" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgirepository-gimarshallingtests-1.0.so" cdecl add-library ] } +} cond +>> + +IMPLEMENT-STRUCTS: GIMarshallingTestsSimpleStruct ; + +GIR: vocab:gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir + diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor b/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor new file mode 100644 index 0000000000..bde6d26e4c --- /dev/null +++ b/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gobject-introspection.tests.g-i-marshalling-tests.ffi ; +IN: gobject-introspection.tests.g-i-marshalling-tests + diff --git a/basis/gobject-introspection/tests/marshalling.factor b/basis/gobject-introspection/tests/marshalling.factor new file mode 100644 index 0000000000..eecf21a381 --- /dev/null +++ b/basis/gobject-introspection/tests/marshalling.factor @@ -0,0 +1,295 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien.c-types alien.data alien.strings +alien.syntax arrays classes.struct destructors +gobject-introspection.tests.g-i-marshalling-tests.ffi +glib.ffi gobject.ffi io.encodings.utf8 kernel literals +sequences specialized-arrays tools.test ; +IN: gobject-introspection.tests.marshalling + +SPECIALIZED-ARRAYS: gint gshort void* +GIMarshallingTestsSimpleStruct ; + +CONSTANT: G_I_MARSHALLING_TESTS_CONSTANT_NUMBER 42 + +CONSTANT: G_I_MARSHALLING_TESTS_CONSTANT_UTF8 "const ♥ utf8" + +! gboolean + +[ t ] [ g_i_marshalling_tests_boolean_return_true ] unit-test +[ f ] [ g_i_marshalling_tests_boolean_return_false ] unit-test + +: boolean-out-true ( -- out ) + { gboolean } [ g_i_marshalling_tests_boolean_out_true ] + with-out-parameters ; +[ t ] [ boolean-out-true ] unit-test + +: boolean-out-false ( -- out ) + { gboolean } [ g_i_marshalling_tests_boolean_out_false ] + with-out-parameters ; +[ f ] [ boolean-out-false ] unit-test + +! gint8 + +[ $ G_MAXINT8 ] [ g_i_marshalling_tests_int8_return_max ] unit-test +[ $ G_MININT8 ] [ g_i_marshalling_tests_int8_return_min ] unit-test + +: int8-out-max ( -- out ) + { gint8 } [ g_i_marshalling_tests_int8_out_max ] + with-out-parameters ; +[ $ G_MAXINT8 ] [ int8-out-max ] unit-test + +: int8-out-min ( -- out ) + { gint8 } [ g_i_marshalling_tests_int8_out_min ] + with-out-parameters ; +[ $ G_MININT8 ] [ int8-out-min ] unit-test + +: int8-inout-max-min ( -- out ) + { { gint8 initial: $ G_MAXINT8 } } + [ g_i_marshalling_tests_int8_inout_max_min ] + with-out-parameters ; +[ $ G_MININT8 ] [ int8-inout-max-min ] unit-test + +! guint8 + +[ $ G_MAXUINT8 ] [ g_i_marshalling_tests_uint8_return ] unit-test + +: uint8-out ( -- out ) + { guint8 } [ g_i_marshalling_tests_uint8_out ] + with-out-parameters ; +[ $ G_MAXUINT8 ] [ uint8-out ] unit-test + +: uint8-inout ( -- out ) + { { guint8 initial: $ G_MAXUINT8 } } + [ g_i_marshalling_tests_uint8_inout ] + with-out-parameters ; +[ 0 ] [ uint8-inout ] unit-test + +! gint16 + +[ $ G_MAXINT16 ] [ g_i_marshalling_tests_int16_return_max ] unit-test +[ $ G_MININT16 ] [ g_i_marshalling_tests_int16_return_min ] unit-test + +: int16-out-max ( -- out ) + { gint16 } [ g_i_marshalling_tests_int16_out_max ] + with-out-parameters ; +[ $ G_MAXINT16 ] [ int16-out-max ] unit-test + +: int16-out-min ( -- out ) + { gint16 } [ g_i_marshalling_tests_int16_out_min ] + with-out-parameters ; +[ $ G_MININT16 ] [ int16-out-min ] unit-test + +: int16-inout-max-min ( -- out ) + { { gint16 initial: $ G_MAXINT16 } } + [ g_i_marshalling_tests_int16_inout_max_min ] + with-out-parameters ; +[ $ G_MININT16 ] [ int16-inout-max-min ] unit-test + +! guint16 + +[ $ G_MAXUINT16 ] [ g_i_marshalling_tests_uint16_return ] unit-test + +: uint16-out ( -- out ) + { guint16 } [ g_i_marshalling_tests_uint16_out ] + with-out-parameters ; +[ $ G_MAXUINT16 ] [ uint16-out ] unit-test + +: uint16-inout ( -- out ) + { { guint16 initial: $ G_MAXUINT16 } } + [ g_i_marshalling_tests_uint16_inout ] + with-out-parameters ; +[ 0 ] [ uint16-inout ] unit-test + +! gint32 + +[ $ G_MAXINT32 ] [ g_i_marshalling_tests_int32_return_max ] unit-test +[ $ G_MININT32 ] [ g_i_marshalling_tests_int32_return_min ] unit-test + +: int32-out-max ( -- out ) + { gint32 } [ g_i_marshalling_tests_int32_out_max ] + with-out-parameters ; +[ $ G_MAXINT32 ] [ int32-out-max ] unit-test + +: int32-out-min ( -- out ) + { gint32 } [ g_i_marshalling_tests_int32_out_min ] + with-out-parameters ; +[ $ G_MININT32 ] [ int32-out-min ] unit-test + +: int32-inout-max-min ( -- out ) + { { gint32 initial: $ G_MAXINT32 } } + [ g_i_marshalling_tests_int32_inout_max_min ] + with-out-parameters ; +[ $ G_MININT32 ] [ int32-inout-max-min ] unit-test + +! guint32 + +[ $ G_MAXUINT32 ] [ g_i_marshalling_tests_uint32_return ] unit-test + +: uint32-out ( -- out ) + { guint32 } [ g_i_marshalling_tests_uint32_out ] + with-out-parameters ; +[ $ G_MAXUINT32 ] [ uint32-out ] unit-test + +: uint32-inout ( -- out ) + { { guint32 initial: $ G_MAXUINT32 } } + [ g_i_marshalling_tests_uint32_inout ] + with-out-parameters ; +[ 0 ] [ uint32-inout ] unit-test + +! gint64 + +[ $ G_MAXINT64 ] [ g_i_marshalling_tests_int64_return_max ] unit-test +[ $ G_MININT64 ] [ g_i_marshalling_tests_int64_return_min ] unit-test + +: int64-out-max ( -- out ) + { gint64 } [ g_i_marshalling_tests_int64_out_max ] + with-out-parameters ; +[ $ G_MAXINT64 ] [ int64-out-max ] unit-test + +: int64-out-min ( -- out ) + { gint64 } [ g_i_marshalling_tests_int64_out_min ] + with-out-parameters ; +[ $ G_MININT64 ] [ int64-out-min ] unit-test + +: int64-inout-max-min ( -- out ) + { { gint64 initial: $ G_MAXINT64 } } + [ g_i_marshalling_tests_int64_inout_max_min ] + with-out-parameters ; +[ $ G_MININT64 ] [ int64-inout-max-min ] unit-test + +! guint64 + +[ $ G_MAXUINT64 ] [ g_i_marshalling_tests_uint64_return ] unit-test + +: uint64-out ( -- out ) + { guint64 } [ g_i_marshalling_tests_uint64_out ] + with-out-parameters ; +[ $ G_MAXUINT64 ] [ uint64-out ] unit-test + +: uint64-inout ( -- out ) + { { guint64 initial: $ G_MAXUINT64 } } + [ g_i_marshalling_tests_uint64_inout ] + with-out-parameters ; +[ 0 ] [ uint64-inout ] unit-test + +! gssize +! gsize +! gfloat +! gdouble +! time_t + +! gtype + +[ $ G_TYPE_NONE ] +[ g_i_marshalling_tests_gtype_return ] unit-test + +: gtype-out ( -- out ) + { GType } [ g_i_marshalling_tests_gtype_out ] + with-out-parameters ; +[ $ G_TYPE_NONE ] [ gtype-out ] unit-test + +: gtype-inout ( -- out ) + { { GType initial: $ G_TYPE_NONE } } + [ g_i_marshalling_tests_gtype_inout ] + with-out-parameters ; +[ $ G_TYPE_INT ] [ gtype-inout ] unit-test + +! strings + +[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] +[ g_i_marshalling_tests_utf8_none_return utf8 alien>string ] unit-test + +[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] [ + [ + g_i_marshalling_tests_utf8_full_return &g_free + utf8 alien>string + ] with-destructors +] unit-test + +: utf8-none-out ( -- out ) + { pointer: gchar } + [ g_i_marshalling_tests_utf8_none_out ] + with-out-parameters ; +[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] +[ utf8-none-out utf8 alien>string ] unit-test + +: utf8-full-out ( -- out ) + { pointer: gchar } + [ g_i_marshalling_tests_utf8_full_out ] + with-out-parameters ; +[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] [ + [ utf8-full-out &g_free utf8 alien>string ] with-destructors +] unit-test + +: utf8-dangling-out ( -- out ) + { { pointer: gchar initial: f } } + [ g_i_marshalling_tests_utf8_dangling_out ] + with-out-parameters ; +[ f ] +[ utf8-dangling-out ] unit-test + +! arrays + +[ int-array{ -1 0 1 2 } ] +[ + g_i_marshalling_tests_array_fixed_int_return + 4 >int-array +] unit-test + +[ short-array{ -1 0 1 2 } ] +[ + g_i_marshalling_tests_array_fixed_short_return + 4 >short-array +] unit-test + +: array-fixed-out ( -- out ) + { pointer: gint } + [ g_i_marshalling_tests_array_fixed_out ] + with-out-parameters ; +[ int-array{ -1 0 1 2 } ] +[ + array-fixed-out + 4 >int-array +] unit-test + +: array-fixed-out-struct ( -- out ) + { pointer: gint } + [ g_i_marshalling_tests_array_fixed_out_struct ] + with-out-parameters ; +[ { { 7 6 } { 6 7 } } ] +[ + array-fixed-out-struct + 2 + [ [ long_>> ] [ int8>> ] bi 2array ] { } map-as +] unit-test + +: array-return ( -- array length ) + { gint } + [ g_i_marshalling_tests_array_return ] + with-out-parameters ; +[ int-array{ -1 0 1 2 } ] +[ array-return >int-array ] unit-test + +: array-out ( -- array length ) + { pointer: gint gint } + [ g_i_marshalling_tests_array_out ] + with-out-parameters ; +[ int-array{ -1 0 1 2 } ] +[ array-out >int-array ] unit-test + +[ { "0" "1" "2" f } ] +[ + g_i_marshalling_tests_array_zero_terminated_return + 4 [ utf8 alien>string ] { } map-as +] unit-test + +: array-zero-terminated-out ( -- out ) + { pointer: pointer: gchar } + [ g_i_marshalling_tests_array_zero_terminated_out ] + with-out-parameters ; +[ { "0" "1" "2" f } ] +[ + array-zero-terminated-out + 4 [ utf8 alien>string ] { } map-as +] unit-test diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index 7e2c5eace6..30100de3b9 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -15,7 +15,7 @@ IN: gobject.ffi >> TYPEDEF: void* GSignalCMarshaller -TYPEDEF: void GStrv +TYPEDEF: gchar** GStrv TYPEDEF: gchar* gchararray GIR: vocab:gobject/GObject-2.0.gir From 6ef16684e598b9a4c8727aa504067246c32f591a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 4 Sep 2010 23:15:00 +0600 Subject: [PATCH 48/76] ui.backend.gtk: remove "Input method" menu, because it's for testing only --- basis/ui/backend/gtk/gtk.factor | 40 +++++++++------------------------ 1 file changed, 10 insertions(+), 30 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 2285453e5f..c73c66f4c2 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,21 +1,20 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data -alien.strings arrays assocs classes.struct command-line -destructors gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi -gtk.gl.ffi io.backend io.backend.unix.multiplexers -io.encodings.utf8 io.thread kernel libc literals locals math -math.bitwise math.order math.vectors namespaces sequences -strings system threads ui ui.backend ui.clipboards ui.commands -ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.menus -ui.gadgets.private ui.gadgets.worlds ui.gestures -ui.pixel-formats ui.pixel-formats.private ui.private ; +alien.strings arrays assocs classes.struct command-line destructors +gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi io.backend +io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel libc +literals locals math math.bitwise math.order math.vectors namespaces +sequences strings system threads ui ui.backend ui.clipboards +ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.private +ui.gadgets.worlds ui.gestures ui.pixel-formats +ui.pixel-formats.private ui.private ; IN: ui.backend.gtk SINGLETON: gtk-ui-backend TUPLE: handle ; -TUPLE: window-handle < handle window fullscreen? im-context im-menu ; +TUPLE: window-handle < handle window fullscreen? im-context ; : ( window im-context -- window-handle ) window-handle new @@ -398,28 +397,9 @@ M: editor get-cursor-loc&dim nip [ f gtk_im_context_set_client_window ] [ g_object_unref ] bi ; -! for testing only - -: com-input-method ( world -- ) - find-world handle>> im-menu>> f f f f 0 - gtk_get_current_event_time gtk_menu_popup ; - -: im-menu ( world -- ) - { com-input-method } show-commands-menu ; - -editor "input-method" f { - { T{ button-down f { S+ C+ } 3 } im-menu } -} define-command-map - -! -------- - :: configure-im ( win im -- ) im win gtk_widget_get_window gtk_im_context_set_client_window im f gtk_im_context_set_use_preedit - - gtk_menu_new :> menu - im menu gtk_im_multicontext_append_menuitems - menu win window handle>> im-menu<< im "commit" [ on-commit yield ] GtkIMContext:commit win connect-signal-with-data @@ -494,7 +474,7 @@ CONSTANT: window-controls>func-flags M:: gtk-ui-backend (open-window) ( world -- ) GTK_WINDOW_TOPLEVEL gtk_window_new :> win gtk_im_multicontext_new :> im - + win im world handle<< world win register-window From 8812052ba9b855ba03a3cddc5c596f2b6149c9c3 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 12 Sep 2010 13:43:20 +0600 Subject: [PATCH 49/76] ui.backend.gtk: set 'wmclass' hint to 'Factor' for new windows --- basis/ui/backend/gtk/gtk.factor | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index c73c66f4c2..a691db6383 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -316,8 +316,6 @@ M: gtk-ui-backend (with-ui) win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; -! ---------------------- - GENERIC: support-input-methods? ( gadget -- ? ) GENERIC: get-cursor-surrounding ( gadget -- text cursor-pos ) GENERIC: delete-cursor-surrounding ( offset count gadget -- ) @@ -335,15 +333,11 @@ M: editor delete-cursor-surrounding 3drop ; M: editor set-preedit-string - nip dup [ editor-caret ] keep - [ user-input* drop ] 2dip - set-caret ; + 3drop ; M: editor get-cursor-loc&dim [ caret-loc ] [ caret-dim ] bi ; -! ---------------------- - : on-retrieve-surrounding ( im-context win -- ? ) window world-focus dup support-input-methods? [ get-cursor-surrounding [ utf8 string>alien -1 ] dip @@ -481,6 +475,9 @@ M:: gtk-ui-backend (open-window) ( world -- ) win world [ window-loc>> auto-position ] [ dim>> first2 gtk_window_set_default_size ] 2bi + + win "factor" "Factor" [ utf8 string>alien ] bi@ + gtk_window_set_wmclass world setup-gl drop From 534402469c6f798aa31cacb6db514fd53d378d48 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 12 Sep 2010 17:28:24 +0600 Subject: [PATCH 50/76] ui.backend.gtk: clean up and rearrange the code --- basis/ui/backend/gtk/gtk.factor | 388 +++++++++++++++++--------------- 1 file changed, 206 insertions(+), 182 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index a691db6383..996a26e584 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -21,42 +21,106 @@ TUPLE: window-handle < handle window fullscreen? im-context ; swap >>im-context swap >>window ; +: connect-signal-with-data ( object signal-name callback data -- ) + [ utf8 string>alien ] 2dip g_signal_connect drop ; + +: connect-signal ( object signal-name callback -- ) + f connect-signal-with-data ; + +! Clipboards + TUPLE: gtk-clipboard handle ; C: gtk-clipboard -PIXEL-FORMAT-ATTRIBUTE-TABLE: gl-config-attribs ${ GDK_GL_USE_GL GDK_GL_RGBA } H{ - { double-buffered ${ GDK_GL_DOUBLEBUFFER } } - { stereo ${ GDK_GL_STEREO } } - ! { offscreen ${ GDK_GL_DRAWABLE_TYPE 2 } } - ! { fullscreen ${ GDK_GL_DRAWABLE_TYPE 1 } } - ! { windowed ${ GDK_GL_DRAWABLE_TYPE 1 } } - { color-bits ${ GDK_GL_BUFFER_SIZE } } - { red-bits ${ GDK_GL_RED_SIZE } } - { green-bits ${ GDK_GL_GREEN_SIZE } } - { blue-bits ${ GDK_GL_BLUE_SIZE } } - { alpha-bits ${ GDK_GL_ALPHA_SIZE } } - { accum-red-bits ${ GDK_GL_ACCUM_RED_SIZE } } - { accum-green-bits ${ GDK_GL_ACCUM_GREEN_SIZE } } - { accum-blue-bits ${ GDK_GL_ACCUM_BLUE_SIZE } } - { accum-alpha-bits ${ GDK_GL_ACCUM_ALPHA_SIZE } } - { depth-bits ${ GDK_GL_DEPTH_SIZE } } - { stencil-bits ${ GDK_GL_STENCIL_SIZE } } - { aux-buffers ${ GDK_GL_AUX_BUFFERS } } - { sample-buffers ${ GDK_GL_SAMPLE_BUFFERS } } - { samples ${ GDK_GL_SAMPLES } } -} +M: gtk-clipboard clipboard-contents + [ + handle>> gtk_clipboard_wait_for_text + [ &g_free utf8 alien>string ] [ f ] if* + ] with-destructors ; -M: gtk-ui-backend (make-pixel-format) - nip >gl-config-attribs-int-array gdk_gl_config_new ; +M: gtk-clipboard set-clipboard-contents + swap [ handle>> ] [ utf8 string>alien ] bi* + -1 gtk_clipboard_set_text ; -M: gtk-ui-backend (free-pixel-format) - handle>> g_object_unref ; +: init-clipboard ( -- ) + selection "PRIMARY" + clipboard "CLIPBOARD" + [ + utf8 string>alien gdk_atom_intern_static_string + gtk_clipboard_get swap set-global + ] 2bi@ ; -M: gtk-ui-backend (pixel-format-attribute) - [ handle>> ] [ >gl-config-attribs ] bi* - { int } [ gdk_gl_config_get_attrib drop ] - with-out-parameters ; +! IO events + +: io-source-prepare ( source timeout -- ? ) + 2drop f ; + +: io-source-check ( source -- ? ) + poll_fds>> 0 g_slist_nth_data GPollFD memory>struct + revents>> 0 = not ; + +: io-source-dispatch ( source callback user_data -- ? ) + 3drop + 0 mx get wait-for-events + yield t ; + +CONSTANT: poll-fd-events + flags{ + G_IO_IN + G_IO_OUT + G_IO_PRI + G_IO_ERR + G_IO_HUP + G_IO_NVAL + } + +: create-poll-fd ( -- poll-fd ) + GPollFD malloc-struct &free + mx get fd>> >>fd + poll-fd-events >>events ; + +HOOK: init-io-event-source io-backend ( -- ) + +M: f init-io-event-source ; +M: c-io-backend init-io-event-source ; + +M: object init-io-event-source + GSourceFuncs malloc-struct &free + [ io-source-prepare ] GSourceFuncsPrepareFunc >>prepare + [ io-source-check ] GSourceFuncsCheckFunc >>check + [ io-source-dispatch ] GSourceFuncsDispatchFunc >>dispatch + GSource heap-size g_source_new &g_source_unref + [ create-poll-fd g_source_add_poll ] + [ f g_source_attach drop ] bi ; + +SYMBOL: next-timeout + +: set-timeout*-value ( alien value -- ) + swap 0 set-alien-signed-4 ; inline + +: timeout-prepare ( source timeout* -- ? ) + nip next-timeout get-global nano-count [-] + [ 1,000,000 /i set-timeout*-value ] keep 0 = ; + +: timeout-check ( source -- ? ) + drop next-timeout get-global nano-count [-] 0 = ; + +: timeout-dispatch ( source callback user_data -- ? ) + 3drop sleep-time [ 1,000,000,000 ] unless* nano-count + + next-timeout set-global + yield t ; + +: init-timeout ( -- ) + GSourceFuncs malloc-struct &free + [ timeout-prepare ] GSourceFuncsPrepareFunc >>prepare + [ timeout-check ] GSourceFuncsCheckFunc >>check + [ timeout-dispatch ] GSourceFuncsDispatchFunc >>dispatch + GSource heap-size g_source_new &g_source_unref + f g_source_attach drop + nano-count next-timeout set-global ; + +! User input CONSTANT: events-mask flags{ @@ -129,30 +193,30 @@ CONSTANT: action-key-codes : mouse-event>gesture ( event -- modifiers button loc ) [ event-modifiers ] [ button>> ] [ event-loc ] tri ; -: on-motion ( sender event user-data -- result ) +: on-motion ( win event user-data -- ? ) drop swap [ GdkEventMotion memory>struct event-loc ] dip window move-hand fire-motion t ; -: on-enter ( sender event user-data -- result ) +: on-enter ( win event user-data -- ? ) on-motion ; -: on-leave ( sender event user-data -- result ) +: on-leave ( win event user-data -- ? ) 3drop forget-rollover t ; -: on-button-press ( sender event user-data -- result ) +: on-button-press ( win event user-data -- ? ) drop swap [ GdkEventButton memory>struct mouse-event>gesture [ ] dip ] dip window send-button-down t ; -: on-button-release ( sender event user-data -- result ) +: on-button-release ( win event user-data -- ? ) drop swap [ GdkEventButton memory>struct mouse-event>gesture [ ] dip ] dip window send-button-up t ; -: on-scroll ( sender event user-data -- result ) +: on-scroll ( win event user-data -- ? ) drop swap [ GdkEventScroll memory>struct [ scroll-direction ] [ event-loc ] bi @@ -166,133 +230,22 @@ CONSTANT: action-key-codes GdkEventKey memory>struct [ event-modifiers ] [ key-sym ] bi ; -: on-key-press ( sender event user-data -- result ) +: on-key-press ( win event user-data -- ? ) drop swap [ key-event>gesture ] [ window ] bi* propagate-key-gesture t ; -: on-key-release ( sender event user-data -- result ) +: on-key-release ( win event user-data -- ? ) drop swap [ key-event>gesture ] [ window ] bi* propagate-key-gesture t ; -: on-focus-in ( sender event user-data -- result ) +: on-focus-in ( win event user-data -- ? ) 2drop window focus-world t ; -: on-focus-out ( sender event user-data -- result ) +: on-focus-out ( win event user-data -- ? ) 2drop window unfocus-world t ; -: on-expose ( sender event user-data -- result ) - 2drop window relayout t ; - -: on-configure ( sender event user-data -- result ) - drop [ window ] dip GdkEventConfigure memory>struct - [ event-loc >>window-loc ] [ event-dim >>dim ] bi - relayout-1 f ; - -: on-delete ( sender event user-data -- result ) - 2drop window ungraft t ; - -: init-clipboard ( -- ) - selection "PRIMARY" - clipboard "CLIPBOARD" - [ - utf8 string>alien gdk_atom_intern_static_string - gtk_clipboard_get swap set-global - ] 2bi@ ; - -: io-source-prepare ( source timeout -- result ) - 2drop f ; - -: io-source-check ( source -- result ) - poll_fds>> 0 g_slist_nth_data GPollFD memory>struct - revents>> 0 = not ; - -: io-source-dispatch ( source callback user_data -- result ) - 3drop - 0 mx get wait-for-events - yield t ; - -CONSTANT: poll-fd-events - flags{ - G_IO_IN - G_IO_OUT - G_IO_PRI - G_IO_ERR - G_IO_HUP - G_IO_NVAL - } - -: create-poll-fd ( -- poll-fd ) - GPollFD malloc-struct &free - mx get fd>> >>fd - poll-fd-events >>events ; - -HOOK: init-io-event-source io-backend ( -- ) - -M: f init-io-event-source ; -M: c-io-backend init-io-event-source ; - -M: object init-io-event-source - GSourceFuncs malloc-struct &free - [ io-source-prepare ] GSourceFuncsPrepareFunc >>prepare - [ io-source-check ] GSourceFuncsCheckFunc >>check - [ io-source-dispatch ] GSourceFuncsDispatchFunc >>dispatch - GSource heap-size g_source_new &g_source_unref - [ create-poll-fd g_source_add_poll ] - [ f g_source_attach drop ] bi ; - -SYMBOL: next-timeout - -: set-timeout*-value ( alien value -- ) - swap 0 set-alien-signed-4 ; inline - -: timeout-prepare ( source timeout* -- result ) - nip next-timeout get-global nano-count [-] - [ 1,000,000 /i set-timeout*-value ] keep 0 = ; - -: timeout-check ( source -- result ) - drop next-timeout get-global nano-count [-] 0 = ; - -: timeout-dispatch ( source callback user_data -- result ) - 3drop sleep-time [ 1,000,000,000 ] unless* nano-count + - next-timeout set-global - yield t ; - -: init-timeout ( -- ) - GSourceFuncs malloc-struct &free - [ timeout-prepare ] GSourceFuncsPrepareFunc >>prepare - [ timeout-check ] GSourceFuncsCheckFunc >>check - [ timeout-dispatch ] GSourceFuncsDispatchFunc >>dispatch - GSource heap-size g_source_new &g_source_unref - f g_source_attach drop - nano-count next-timeout set-global ; - -M: gtk-ui-backend (with-ui) - [ - f f gtk_init - f f gtk_gl_init - init-clipboard - start-ui - stop-io-thread - [ - init-io-event-source - init-timeout - gtk_main - ] with-destructors - ] ui-running ; - -: connect-signal-with-data ( object signal-name callback data -- ) - [ utf8 string>alien ] 2dip g_signal_connect drop ; - -: connect-signal ( object signal-name callback -- ) - f connect-signal-with-data ; - -:: connect-signals ( win -- ) +:: connect-user-input-signals ( win -- ) win events-mask gtk_widget_add_events - - win "expose-event" [ on-expose yield ] - GtkWidget:expose-event connect-signal - win "configure-event" [ on-configure yield ] - GtkWidget:configure-event connect-signal win "motion-notify-event" [ on-motion yield ] GtkWidget:motion-notify-event connect-signal win "leave-notify-event" [ on-leave yield ] @@ -312,10 +265,31 @@ M: gtk-ui-backend (with-ui) win "focus-in-event" [ on-focus-in yield ] GtkWidget:focus-in-event connect-signal win "focus-out-event" [ on-focus-out yield ] - GtkWidget:focus-out-event connect-signal + GtkWidget:focus-out-event connect-signal ; + +! Window state events + +: on-expose ( win event user-data -- ? ) + 2drop window relayout t ; + +: on-configure ( win event user-data -- ? ) + drop [ window ] [ GdkEventConfigure memory>struct ] bi* + [ event-loc >>window-loc ] [ event-dim >>dim ] bi + relayout-1 f ; + +: on-delete ( win event user-data -- ? ) + 2drop window ungraft t ; + +:: connect-win-state-signals ( win -- ) + win "expose-event" [ on-expose yield ] + GtkWidget:expose-event connect-signal + win "configure-event" [ on-configure yield ] + GtkWidget:configure-event connect-signal win "delete-event" [ on-delete yield ] GtkWidget:delete-event connect-signal ; +! Input methods + GENERIC: support-input-methods? ( gadget -- ? ) GENERIC: get-cursor-surrounding ( gadget -- text cursor-pos ) GENERIC: delete-cursor-surrounding ( offset count gadget -- ) @@ -353,12 +327,12 @@ M: editor get-cursor-loc&dim with-out-parameters [ [ utf8 alien>string ] [ g_free ] bi ] dip ; -: on-preedit-changed ( im-context user-data -- ) +: on-preedit-changed ( im-context win -- ) window world-focus dup support-input-methods? [ [ get-preedit-string ] dip set-preedit-string ] [ 2drop ] if ; -: on-commit ( sender str user_data -- ) +: on-commit ( im-context str win -- ) [ drop ] [ utf8 alien>string ] [ window ] tri* user-input ; : gadget-location ( gadget -- loc ) @@ -372,24 +346,26 @@ M: editor get-cursor-loc&dim gadget-cursor-location gtk_im_context_set_cursor_location ; ! has to be called before the window signal handler -:: im-on-key-event ( sender event im-context -- result ) - sender window world-focus :> gadget +:: im-on-key-event ( win event im-context -- ? ) + win window world-focus :> gadget gadget support-input-methods? [ im-context gadget update-cursor-location im-context event gtk_im_context_filter_keypress ] [ im-context gtk_im_context_reset f ] if ; -: im-on-focus-in ( sender event user-data -- result ) - 2drop window handle>> im-context>> +: im-on-focus-in ( win event im-context -- ? ) + 2nip [ gtk_im_context_focus_in ] [ gtk_im_context_reset ] bi f ; -: im-on-focus-out ( sender event user-data -- result ) - 2drop window handle>> im-context>> +: im-on-focus-out ( win event im-context -- ? ) + 2nip [ gtk_im_context_focus_out ] [ gtk_im_context_reset ] bi f ; -: im-on-destroy ( sender user-data -- ) +: im-on-destroy ( win im-context -- ) nip [ f gtk_im_context_set_client_window ] - [ g_object_unref ] bi ; + ! weird GLib-GObject-WARNING message appears after calling this code + ! [ g_object_unref ] bi ; + [ drop ] bi ; :: configure-im ( win im -- ) im win gtk_widget_get_window gtk_im_context_set_client_window @@ -415,6 +391,8 @@ M: editor get-cursor-loc&dim win "destroy" [ im-on-destroy yield ] GtkObject:destroy im connect-signal-with-data ; +! Window controls + CONSTANT: window-controls>decor-flags H{ { close-button 0 } @@ -452,10 +430,58 @@ CONSTANT: window-controls>func-flags GDK_FUNC_MOVE bitor gdk_window_set_functions ] 2tri ; -: setup-gl ( world -- ? ) +! OpenGL and Pixel formats + +PIXEL-FORMAT-ATTRIBUTE-TABLE: gl-config-attribs + ${ GDK_GL_USE_GL GDK_GL_RGBA } + H{ + { double-buffered ${ GDK_GL_DOUBLEBUFFER } } + { stereo ${ GDK_GL_STEREO } } + ! { offscreen ${ GDK_GL_DRAWABLE_TYPE 2 } } + ! { fullscreen ${ GDK_GL_DRAWABLE_TYPE 1 } } + ! { windowed ${ GDK_GL_DRAWABLE_TYPE 1 } } + { color-bits ${ GDK_GL_BUFFER_SIZE } } + { red-bits ${ GDK_GL_RED_SIZE } } + { green-bits ${ GDK_GL_GREEN_SIZE } } + { blue-bits ${ GDK_GL_BLUE_SIZE } } + { alpha-bits ${ GDK_GL_ALPHA_SIZE } } + { accum-red-bits ${ GDK_GL_ACCUM_RED_SIZE } } + { accum-green-bits ${ GDK_GL_ACCUM_GREEN_SIZE } } + { accum-blue-bits ${ GDK_GL_ACCUM_BLUE_SIZE } } + { accum-alpha-bits ${ GDK_GL_ACCUM_ALPHA_SIZE } } + { depth-bits ${ GDK_GL_DEPTH_SIZE } } + { stencil-bits ${ GDK_GL_STENCIL_SIZE } } + { aux-buffers ${ GDK_GL_AUX_BUFFERS } } + { sample-buffers ${ GDK_GL_SAMPLE_BUFFERS } } + { samples ${ GDK_GL_SAMPLES } } + } + +M: gtk-ui-backend (make-pixel-format) + nip >gl-config-attribs-int-array gdk_gl_config_new ; + +M: gtk-ui-backend (free-pixel-format) + handle>> g_object_unref ; + +M: gtk-ui-backend (pixel-format-attribute) + [ handle>> ] [ >gl-config-attribs ] bi* + { int } [ gdk_gl_config_get_attrib drop ] + with-out-parameters ; + +M: window-handle select-gl-context ( handle -- ) + window>> + [ gtk_widget_get_gl_window ] [ gtk_widget_get_gl_context ] bi + gdk_gl_drawable_make_current drop ; + +M: window-handle flush-gl-context ( handle -- ) + window>> gtk_widget_get_gl_window + gdk_gl_drawable_swap_buffers ; + +! Window + +: configure-gl ( world -- ) [ [ handle>> window>> ] [ handle>> ] bi* - f t GDK_GL_RGBA_TYPE gtk_widget_set_gl_capability + f t GDK_GL_RGBA_TYPE gtk_widget_set_gl_capability drop ] with-world-pixel-format ; : auto-position ( win loc -- ) @@ -479,13 +505,14 @@ M:: gtk-ui-backend (open-window) ( world -- ) win "factor" "Factor" [ utf8 string>alien ] bi@ gtk_window_set_wmclass - world setup-gl drop + world configure-gl win gtk_widget_realize win world window-controls>> configure-window-controls win im configure-im - win connect-signals + win connect-user-input-signals + win connect-win-state-signals win gtk_widget_show_all ; @@ -524,14 +551,7 @@ M: gtk-ui-backend (ungrab-input) window>> [ gtk_grab_remove ] [ GDK_LEFT_PTR set-cursor ] bi ; -M: window-handle select-gl-context ( handle -- ) - window>> - [ gtk_widget_get_gl_window ] [ gtk_widget_get_gl_context ] bi - gdk_gl_drawable_make_current drop ; - -M: window-handle flush-gl-context ( handle -- ) - window>> gtk_widget_get_gl_window - gdk_gl_drawable_swap_buffers ; +! Misc. M: gtk-ui-backend beep gdk_beep ; @@ -543,15 +563,19 @@ M:: gtk-ui-backend system-alert ( caption text -- ) [ gtk_dialog_run drop ] [ gtk_widget_destroy ] tri ; -M: gtk-clipboard clipboard-contents +M: gtk-ui-backend (with-ui) [ - handle>> gtk_clipboard_wait_for_text - [ &g_free utf8 alien>string ] [ f ] if* - ] with-destructors ; - -M: gtk-clipboard set-clipboard-contents - swap [ handle>> ] [ utf8 string>alien ] bi* - -1 gtk_clipboard_set_text ; + f f gtk_init + f f gtk_gl_init + init-clipboard + start-ui + stop-io-thread + [ + init-io-event-source + init-timeout + gtk_main + ] with-destructors + ] ui-running ; gtk-ui-backend ui-backend set-global From 58ab818708127f74c509727642413fa00f1748aa Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 12 Sep 2010 23:08:52 +0600 Subject: [PATCH 51/76] gobject-introspection: add new tests --- basis/gobject-introspection/ffi/ffi.factor | 5 +- .../tests/codegen.factor | 267 ++ .../tests/everything/Everything-1.0.gir | 2340 +++++++++++++++++ .../tests/everything/everything.factor | 5 + .../tests/everything/ffi/ffi.factor | 19 + 5 files changed, 2635 insertions(+), 1 deletion(-) create mode 100644 basis/gobject-introspection/tests/codegen.factor create mode 100644 basis/gobject-introspection/tests/everything/Everything-1.0.gir create mode 100644 basis/gobject-introspection/tests/everything/everything.factor create mode 100644 basis/gobject-introspection/tests/everything/ffi/ffi.factor diff --git a/basis/gobject-introspection/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor index fb58ede1f6..1328bdc787 100644 --- a/basis/gobject-introspection/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -161,7 +161,8 @@ IN: gobject-introspection.ffi [ define-ffi-interface-content ] each ; : get-type-invoker ( name -- quot ) - [ "GType" current-lib get-global ] dip + ! hack + [ "GType" "glib.ffi" lookup current-lib get-global ] dip { } \ alien-invoke 5 narray >quotation ; : define-ffi-class ( class -- word ) @@ -230,6 +231,8 @@ IN: gobject-introspection.ffi [ classes>> define-ffi-classes-content ] [ interfaces>> define-ffi-interfaces-content ] [ functions>> define-ffi-functions ] + + [ define-get-types ] } cleave ; : define-ffi-repository ( repository -- ) diff --git a/basis/gobject-introspection/tests/codegen.factor b/basis/gobject-introspection/tests/codegen.factor new file mode 100644 index 0000000000..0a28b68174 --- /dev/null +++ b/basis/gobject-introspection/tests/codegen.factor @@ -0,0 +1,267 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: glib.ffi gobject-introspection.tests.everything.ffi +io.streams.string see tools.test ; +IN: gobject-introspection.tests.godegen + +! Constants + +[ "IN: glib.ffi +CONSTANT: G_ASCII_DTOSTR_BUF_SIZE 39 inline +" ] [ + [ \ G_ASCII_DTOSTR_BUF_SIZE see ] with-string-writer +] unit-test + +[ "IN: glib.ffi +CONSTANT: G_CSET_a_2_z \"abcdefghijklmnopqrstuvwxyz\" inline +" ] [ + [ \ G_CSET_a_2_z see ] with-string-writer +] unit-test + +[ "IN: glib.ffi +CONSTANT: G_E 2.71828182846 inline +" ] [ + [ \ G_E see ] with-string-writer +] unit-test + +! Enumerations + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +TYPEDEF: int TestEnum +" ] [ + [ \ TestEnum see ] with-string-writer +] unit-test + +[ "IN: gobject-introspection.tests.everything.ffi +CONSTANT: TEST_VALUE1 0 inline +" ] [ + [ \ TEST_VALUE1 see ] with-string-writer +] unit-test + +[ "IN: gobject-introspection.tests.everything.ffi +CONSTANT: TEST_VALUE3 42 inline +" ] [ + [ \ TEST_VALUE3 see ] with-string-writer +] unit-test + +! Bitfields + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +TYPEDEF: int TestFlags +" ] [ + [ \ TestFlags see ] with-string-writer +] unit-test + +[ "IN: gobject-introspection.tests.everything.ffi +CONSTANT: TEST_FLAG2 2 inline +" ] [ + [ \ TEST_FLAG2 see ] with-string-writer +] unit-test + +! Functions + +[ "USING: alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + gint test_int ( gint in ) ; +" ] [ + [ \ test_int see ] with-string-writer +] unit-test + +! - throws + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + gboolean test_torture_signature_1 + ( int x, double* y, int* z, char* foo, int* q, guint m, + GError** error ) ; +" ] [ + [ \ test_torture_signature_1 see ] with-string-writer +] unit-test + +! Records + +[ "USING: alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +C-TYPE: TestSimpleBoxedA +" ] [ + [ \ TestSimpleBoxedA see ] with-string-writer +] unit-test + +[ "USING: classes.struct glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +STRUCT: TestBoxed + { some_int8 gint8 initial: 0 } + { nested_a TestSimpleBoxedA } { priv TestBoxedPrivate* } ; +" ] [ + [ \ TestBoxed see ] with-string-writer +] unit-test + +! - constructors + +[ "USING: alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + TestBoxed* test_boxed_new ( ) ; +" ] [ + [ \ test_boxed_new see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + TestBoxed* test_boxed_new_alternative_constructor1 + ( int i ) ; +" ] [ + [ \ test_boxed_new_alternative_constructor1 see ] with-string-writer +] unit-test + +! - functions + +! - methods + +[ "USING: alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + TestBoxed* test_boxed_copy ( TestBoxed* self ) ; +" ] [ + [ \ test_boxed_copy see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + void test_struct_a_clone + ( TestStructA* self, TestStructA* a_out ) ; +" ] [ + [ \ test_struct_a_clone see ] with-string-writer +] unit-test + +! Classes + +[ "USING: alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +C-TYPE: TestObj +" ] [ + [ \ TestObj see ] with-string-writer +] unit-test + +! - get_type + +[ "USING: alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + GType test_obj_get_type ( ) ; +" ] [ + [ \ test_obj_get_type see ] with-string-writer +] unit-test + +! - constructors + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + TestObj* test_obj_new_from_file ( char* x, GError** error ) + ; +" ] [ + [ \ test_obj_new_from_file see ] with-string-writer +] unit-test + +[ "USING: alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + TestObj* test_obj_new_callback + ( TestCallbackUserData callback, gpointer user_data, + GDestroyNotify notify ) ; +" ] [ + [ \ test_obj_new_callback see ] with-string-writer +] unit-test + +! - functions + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + double test_obj_static_method ( int x ) ; +" ] [ + [ \ test_obj_static_method see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + void test_obj_static_method_callback + ( TestCallback callback ) ; +" ] [ + [ \ test_obj_static_method_callback see ] with-string-writer +] unit-test + +! - methods + +[ "USING: alien.c-types alien.syntax gobject.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + void test_obj_set_bare ( TestObj* self, GObject* bare ) ; +" ] [ + [ \ test_obj_set_bare see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + int test_obj_instance_method ( TestObj* self ) ; +" ] [ + [ \ test_obj_instance_method see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything FUNCTION: + gboolean test_obj_torture_signature_1 + ( TestObj* self, int x, double* y, int* z, char* foo, int* + q, guint m, GError** error ) ; +" ] [ + [ \ test_obj_torture_signature_1 see ] with-string-writer +] unit-test + +! - signals + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything CALLBACK: + void TestObj:test ( TestObj* sender, gpointer user_data ) ; +" ] [ + [ \ TestObj:test see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything CALLBACK: + void TestObj:test-with-static-scope-arg + ( TestObj* sender, TestSimpleBoxedA* object, gpointer + user_data ) ; +" ] [ + [ \ TestObj:test-with-static-scope-arg see ] with-string-writer +] unit-test + +! Callbacks + +[ "USING: alien.c-types alien.syntax ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything CALLBACK: + int TestCallback ( ) ; +" ] [ + [ \ TestCallback see ] with-string-writer +] unit-test + +[ "USING: alien.c-types alien.syntax glib.ffi ; +IN: gobject-introspection.tests.everything.ffi +LIBRARY: gobject-introspection.tests.everything CALLBACK: + int TestCallbackUserData ( gpointer user_data ) ; +" ] [ + [ \ TestCallbackUserData see ] with-string-writer +] unit-test + diff --git a/basis/gobject-introspection/tests/everything/Everything-1.0.gir b/basis/gobject-introspection/tests/everything/Everything-1.0.gir new file mode 100644 index 0000000000..aa7de3b4b6 --- /dev/null +++ b/basis/gobject-introspection/tests/everything/Everything-1.0.gir @@ -0,0 +1,2340 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This method is virtual. Notably its name differs from the virtual +slot name, which makes it useful for testing bindings handle this +case. + + + + + + Meaningless string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This function throws an error if m is odd. + + + + + + + + + + + + + + + + + + + + + + + + + + This method is virtual. Notably its name differs from the virtual +slot name, which makes it useful for testing bindings handle this +case. + + + + + + Meaningless string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Meaningless string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Make a copy of a TestStructA + + + + + + the cloned structure + + + + + + + + + + + + + + Make a copy of a TestStructB + + + + + + the cloned structure + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + the sum of the items in @ints + + + + + a list of 5 integers + + + + + + + + + + + + + a list of 5 integers ranging from 0 to 4 + + + + + + + + + a list of 5 integers ranging from 0 to 4 + + + + + + + + + + + + + + + List of ints + + + + + + + + + + + + + + + + List of ints + + + + + + + + + + + + + + + + List of ints + + + + + + + + + + + + + + + + List of ints + + + + + + + + + string representation of provided types + + + + + + + + List of types + + + + + + + + + a new array of integers. + + + + + + + length of the returned array. + + + + + + + + + + + + + + List of ints + + + + + + + + + + + + + + + + List of ints + + + + + + + + + + + + + the length of @ints + + + + a list of integers whose items will be increased by 1, except the first that will be dropped + + + + + + + + + a static array of integers. + + + + + + + length of the returned array. + + + + + + + + + + + + + + + + length + + + + + + + + + + + + + + + + length + + + + + + + + + + + the length of @ints + + + + a list of 5 integers, from 0 to 4 in consecutive order + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Notified - callback persists until a DestroyNotify delegate +is invoked. + + + + + + + + + + + + + + + + + + + + + + Invokes all callbacks installed by #test_callback_destroy_notify(), +adding up their return values, and removes them, invoking the +corresponding destroy notfications. + + Sum of the return values of the invoked callbacks. + + + + + Call - callback parameter persists for the duration of the method +call and can be released on return. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + list of strings + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Specify nested parameterized types directly with the (type ) annotation. + + + + + + + + + + + + element-type annotation. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A #TestObj + + + + + + + + + + + A #TestObj + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No annotations here. We want the default to Do The Right Thing. + + + + + + + + No annotations here. We want the default to Do The Right Thing. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This function throws an error if m is odd. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <const char*> UTF-8 string + + + + + + + + + + + + + + + + + + + + + + + + + + <char*> UTF-8 string + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a copy of "first" + + + + + a copy of "second" + + + + + + + + + + + a copy of "first" + + + + a copy of "second" + + + + + + + + + + + + + + + + + the int wrapped in a GValue. + + + + + an int + + + + + + + + + + + + + + + + + + + diff --git a/basis/gobject-introspection/tests/everything/everything.factor b/basis/gobject-introspection/tests/everything/everything.factor new file mode 100644 index 0000000000..bfb94a842c --- /dev/null +++ b/basis/gobject-introspection/tests/everything/everything.factor @@ -0,0 +1,5 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: gobject-introspection.tests.everything.ffi ; +IN: gobject-introspection.tests.everything + diff --git a/basis/gobject-introspection/tests/everything/ffi/ffi.factor b/basis/gobject-introspection/tests/everything/ffi/ffi.factor new file mode 100644 index 0000000000..d4a7c2ff34 --- /dev/null +++ b/basis/gobject-introspection/tests/everything/ffi/ffi.factor @@ -0,0 +1,19 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: alien alien.c-types alien.libraries combinators kernel +system +gobject-introspection cairo.ffi gio.ffi glib.ffi gobject.ffi ; +IN: gobject-introspection.tests.everything.ffi + +<< +"gobject-introspection.tests.everything" { + { [ os winnt? ] [ drop ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ "libgirepository-everything-1.0.so" cdecl add-library ] } +} cond +>> + +IMPLEMENT-STRUCTS: TestBoxed ; + +GIR: vocab:gobject-introspection/tests/everything/Everything-1.0.gir + From 913362a3a2e322d34db5c31069be8258cb605149 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 29 Sep 2010 15:08:31 +0600 Subject: [PATCH 52/76] gobject-introspection: rewrite gir files loading and code generation totally generate girs from fresh sources ui.backend.gtk, ui.text.pango: update a little bit (this commit is unstable, because new GObject-introspection release (> 0.9) is much different from 0.6 and it needs more detailed annotations (e.g. to parse out/inout parameters), which are mostly missing now) --- basis/atk/Atk-1.0.gir | 7567 +- basis/atk/ffi/ffi.factor | 20 +- basis/gdk/Gdk-2.0.gir | 22284 ---- basis/gdk/Gdk-3.0.gir | 19560 ++++ basis/gdk/ffi/ffi.factor | 40 +- .../gl/{GdkGL-1.0.gir => GdkGLExt-1.0.gir} | 1337 +- basis/gdk/gl/ffi/ffi.factor | 17 +- basis/gdk/pixbuf/GdkPixbuf-2.0.gir | 3021 +- basis/gdk/pixbuf/ffi/ffi.factor | 14 +- basis/gio/Gio-2.0.gir | 39131 +++++-- basis/gio/ffi/ffi.factor | 14 +- basis/glib/GLib-2.0.gir | 22216 ++-- basis/glib/ffi/ffi.factor | 68 +- basis/gmodule/GModule-2.0.gir | 37 +- basis/gmodule/ffi/ffi.factor | 13 +- .../common/common.factor | 16 +- basis/gobject-introspection/ffi/ffi.factor | 467 +- .../gobject-introspection.factor | 34 +- .../loader/loader.factor | 399 +- .../repository/repository.factor | 144 +- .../standard-types/standard-types.factor | 71 + .../gobject-introspection/types/types.factor | 196 +- basis/gobject/GObject-2.0.gir | 7954 +- basis/gobject/ffi/ffi.factor | 26 +- basis/gtk/{Gtk-2.0.gir => Gtk-3.0.gir} | 97327 +++++++--------- basis/gtk/ffi/ffi.factor | 30 +- basis/gtk/gl/GtkGL-1.0.gir | 173 - basis/gtk/gl/GtkGLExt-1.0.gir | 213 + basis/gtk/gl/ffi/ffi.factor | 16 +- basis/pango/Pango-1.0.gir | 7680 +- basis/pango/cairo/PangoCairo-1.0.gir | 701 +- basis/pango/cairo/ffi/ffi.factor | 26 +- basis/pango/ffi/ffi.factor | 26 +- basis/ui/backend/gtk/gtk.factor | 111 +- basis/ui/text/pango/pango.factor | 21 +- 35 files changed, 124562 insertions(+), 106408 deletions(-) delete mode 100644 basis/gdk/Gdk-2.0.gir create mode 100644 basis/gdk/Gdk-3.0.gir rename basis/gdk/gl/{GdkGL-1.0.gir => GdkGLExt-1.0.gir} (51%) create mode 100644 basis/gobject-introspection/standard-types/standard-types.factor rename basis/gtk/{Gtk-2.0.gir => Gtk-3.0.gir} (59%) delete mode 100644 basis/gtk/gl/GtkGL-1.0.gir create mode 100644 basis/gtk/gl/GtkGLExt-1.0.gir diff --git a/basis/atk/Atk-1.0.gir b/basis/atk/Atk-1.0.gir index 27bb0f0466..f14914edd0 100644 --- a/basis/atk/Atk-1.0.gir +++ b/basis/atk/Atk-1.0.gir @@ -2,202 +2,265 @@ - + - - + c:identifier-prefixes="Atk" + c:symbol-prefixes="atk"> + + This is a singly-linked list (a #GSList) of #AtkAttribute. It is +used by atk_text_get_run_attributes(), atk_text_get_default_attributes() +and atk_editable_text_set_run_attributes() + + + + + + Perform the specified action on the object. - + %TRUE if success, %FALSE otherwise + - + the action index corresponding to the action to be performed + - - - - - + Returns a description of the specified action of the object. +Returns a description string, or %NULL +if @action does not implement this interface. - - - - - - - - - - - + the action index corresponding to the action to be performed + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Returns a keybinding associated with this action, if one exists. +The returned string is in the format "<a>;<b>;<c>" (i.e. semicolon-delimited), where <a> is the keybinding which -activates the object if it is presently enabled onscreen, +activates the object if it is presently enabled onscreen, <b> corresponds to the keybinding or sequence of keys which invokes the action even if the relevant element is not currently posted on screen (for instance, for a menu item it posts the parent menus before invoking). The last token in the above string, if non-empty, represents a keyboard shortcut which invokes the same action without posting the component or its -enclosing menus or dialogs. +enclosing menus or dialogs. Returns a string representing the available keybindings, or %NULL -if there is no keybinding for this action."> +if there is no keybinding for this action. - + the action index corresponding to the action to be performed + - - + + + Returns the localized name of the specified action of the object. +Returns a name string, or %NULL +if @action does not implement this interface. - + - + the action index corresponding to the action to be performed + + + + + + Gets the number of accessible actions available on the object. +If there are more than one, the first one is considered the +"default" action of the object. +implement this interface. + + a the number of actions, or 0 if @action does not + + + + + Returns a non-localized string naming the specified action of the +object. This name is generally not descriptive of the end result +of the action, but instead names the 'interaction type' which the +object supports. By convention, the above strings should be used to +represent the actions which correspond to the common point-and-click +"click", "press", "release", "drag", "drop", "popup", etc. +The "popup" action should be used to pop up a context menu for the +object, if one exists. +For technical reasons, some toolkits cannot guarantee that the +reported action is actually 'bound' to a nontrivial user event; +i.e. the result of some actions via atk_action_do_action() may be +NIL. +Returns a name string, or %NULL +if @action does not implement this interface. + + + + + + the action index corresponding to the action to be performed + + + + + + Sets a description of the specified action of the object. + + a gboolean representing if the description was successfully set; + + + + + the action index corresponding to the action to be performed + + the description to be assigned to this action + + + Perform the specified action on the object. + + %TRUE if success, %FALSE otherwise + + + + + the action index corresponding to the action to be performed + + + + + + Returns a description of the specified action of the object. +Returns a description string, or %NULL +if @action does not implement this interface. + + + + + + the action index corresponding to the action to be performed + + + + + + Returns a keybinding associated with this action, if one exists. +The returned string is in the format "<a>;<b>;<c>" +(i.e. semicolon-delimited), where <a> is the keybinding which +activates the object if it is presently enabled onscreen, +<b> corresponds to the keybinding or sequence of keys +which invokes the action even if the relevant element is not +currently posted on screen (for instance, for a menu item it +posts the parent menus before invoking). The last token in the +above string, if non-empty, represents a keyboard shortcut which +invokes the same action without posting the component or its +enclosing menus or dialogs. +Returns a string representing the available keybindings, or %NULL +if there is no keybinding for this action. + + + + + + the action index corresponding to the action to be performed + + + + Returns the localized name of the specified action of the object. Returns a name string, or %NULL -if @action does not implement this interface."> +if @action does not implement this interface. - + the action index corresponding to the action to be performed + + + + + + Gets the number of accessible actions available on the object. +If there are more than one, the first one is considered the +"default" action of the object. +implement this interface. + + a the number of actions, or 0 if @action does not + + + + + Returns a non-localized string naming the specified action of the +object. This name is generally not descriptive of the end result +of the action, but instead names the 'interaction type' which the +object supports. By convention, the above strings should be used to +represent the actions which correspond to the common point-and-click +"click", "press", "release", "drag", "drop", "popup", etc. +The "popup" action should be used to pop up a context menu for the +object, if one exists. +For technical reasons, some toolkits cannot guarantee that the +reported action is actually 'bound' to a nontrivial user event; +i.e. the result of some actions via atk_action_do_action() may be +NIL. +Returns a name string, or %NULL +if @action does not implement this interface. + + + + + + the action index corresponding to the action to be performed + + + + + + Sets a description of the specified action of the object. + + a gboolean representing if the description was successfully set; + + + + + the action index corresponding to the action to be performed + + + + the description to be assigned to this action + @@ -209,24 +272,27 @@ if @action does not implement this interface."> - + - + %TRUE if success, %FALSE otherwise + - + the action index corresponding to the action to be performed + - + - + a the number of actions, or 0 if @action does not + @@ -236,7 +302,7 @@ if @action does not implement this interface."> - + @@ -245,13 +311,14 @@ if @action does not implement this interface."> - + the action index corresponding to the action to be performed + - + @@ -260,13 +327,14 @@ if @action does not implement this interface."> - + the action index corresponding to the action to be performed + - + @@ -275,31 +343,35 @@ if @action does not implement this interface."> - + the action index corresponding to the action to be performed + - + - + a gboolean representing if the description was successfully set; + - + the action index corresponding to the action to be performed + + the description to be assigned to this action - + @@ -308,7 +380,8 @@ if @action does not implement this interface."> - + the action index corresponding to the action to be performed + @@ -317,12 +390,8 @@ if @action does not implement this interface."> - + + A string name/value pair representing a text attribute. @@ -331,415 +400,507 @@ A string name/value pair representing a text attribute."> - + + Add the specified handler to the set of functions to be called +when this object receives focus events (in or out). If the handler is +already added it is not added again +or zero if the handler was already added. - + a handler id which can be used in atk_component_remove_focus_handler + + The #AtkFocusHandler to be attached to @component + Checks whether the specified point is within the extent of the @component. +the extent of the @component or not - + %TRUE or %FALSE indicating whether the specified point is within + - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window - - - + + Returns the alpha value (i.e. the opacity) for this +(fully opaque). + + An alpha value from 0 to 1.0, inclusive. + - - - - - - - - - - - + Gets the rectangle which gives the extent of the @component. - - + + address of #gint to put x coordinate + - - + + address of #gint to put y coordinate + - - + + address of #gint to put width + - - + + address of #gint to put height + + specifies whether the coordinates are relative to the screen or to the components top level window + + Gets the layer of the component. + + an #AtkLayer which is the layer of the component + + + + + Gets the zorder of the component. The value G_MININT will be returned +if the layer of the component is not ATK_LAYER_MDI or ATK_LAYER_WINDOW. +which the component is shown in relation to other components in the same +container. + + a gint which is the zorder of the component, i.e. the depth at + + + + Gets the position of @component in the form of +a point specifying @component's top-left corner. - - + + address of #gint to put x coordinate position + - - + + address of #gint to put y coordinate position + + specifies whether the coordinates are relative to the screen or to the components top level window + Gets the size of the @component in terms of width and height. - - + + address of #gint to put width of @component + - - + + address of #gint to put height of @component + + Grabs focus for this @component. - + %TRUE if successful, %FALSE otherwise. + + + Gets a reference to the accessible child, if one exists, at the +coordinate point specified by @x and @y. + + a reference to the accessible child, if one exists + + + + + x coordinate + + + + y coordinate + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + Remove the handler specified by @handler_id from the list of +functions to be executed when this object receives focus events +(in or out). - + the handler id of the focus handler to be removed from @component + + Sets the extents of @component. - + %TRUE or %FALSE whether the extents were set or not + - + x coordinate + - + y coordinate + - + width to set for @component + - + height to set for @component + + specifies whether the coordinates are relative to the screen or to the components top level window + Sets the postition of @component. - + %TRUE or %FALSE whether or not the position was set or not + - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window + Set the size of the @component in terms of width and height. - + %TRUE or %FALSE whether the size was set or not + - + width to set for @component + - + height to set for @component + - - - - - - - - - - - - - - - + Add the specified handler to the set of functions to be called when this object receives focus events (in or out). If the handler is already added it is not added again -or zero if the handler was already added."> +or zero if the handler was already added. - + a handler id which can be used in atk_component_remove_focus_handler + - + + The #AtkFocusHandler to be attached to @component - + + Checks whether the specified point is within the extent of the @component. +the extent of the @component or not - + %TRUE or %FALSE indicating whether the specified point is within + - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns the alpha value (i.e. the opacity) for this +(fully opaque). - + An alpha value from 0 to 1.0, inclusive. + - - + + Gets the rectangle which gives the extent of the @component. + + + + address of #gint to put x coordinate + + + + address of #gint to put y coordinate + + + + address of #gint to put width + + + + address of #gint to put height + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Gets the layer of the component. + + an #AtkLayer which is the layer of the component + + + + + Gets the zorder of the component. The value G_MININT will be returned +if the layer of the component is not ATK_LAYER_MDI or ATK_LAYER_WINDOW. +which the component is shown in relation to other components in the same +container. + + a gint which is the zorder of the component, i.e. the depth at + + + + + Gets the position of @component in the form of +a point specifying @component's top-left corner. + + + + + + address of #gint to put x coordinate position + + + + address of #gint to put y coordinate position + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Gets the size of the @component in terms of width and height. + + + + + + address of #gint to put width of @component + + + + address of #gint to put height of @component + + + + + + Grabs focus for this @component. + + %TRUE if successful, %FALSE otherwise. + + + + + Gets a reference to the accessible child, if one exists, at the +coordinate point specified by @x and @y. + + a reference to the accessible child, if one exists + + + + + x coordinate + + + + y coordinate + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Remove the handler specified by @handler_id from the list of +functions to be executed when this object receives focus events +(in or out). + + + + + + the handler id of the focus handler to be removed from @component + + + + + + Sets the extents of @component. + + %TRUE or %FALSE whether the extents were set or not + + + + + x coordinate + + + + y coordinate + + + + width to set for @component + + + + height to set for @component + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Sets the postition of @component. + + %TRUE or %FALSE whether or not the position was set or not + + + + + x coordinate + + + + y coordinate + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Set the size of the @component in terms of width and height. + + %TRUE or %FALSE whether the size was set or not + + + + + width to set for @component + + + + height to set for @component + + + + + + + + - + @@ -750,46 +911,52 @@ Sets the postition of @component."> - - + + - + a handler id which can be used in atk_component_remove_focus_handler + + The #AtkFocusHandler to be attached to @component - + - + %TRUE or %FALSE indicating whether the specified point is within + - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window - - - + + + + a reference to the accessible child, if one exists @@ -797,19 +964,22 @@ Sets the postition of @component."> - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window - + @@ -817,26 +987,31 @@ Sets the postition of @component."> - - + + address of #gint to put x coordinate + - - + + address of #gint to put y coordinate + - - + + address of #gint to put width + - - + + address of #gint to put height + + specifies whether the coordinates are relative to the screen or to the components top level window - + @@ -844,20 +1019,23 @@ Sets the postition of @component."> - - + + address of #gint to put x coordinate position + - - + + address of #gint to put y coordinate position + + specifies whether the coordinates are relative to the screen or to the components top level window - + @@ -865,19 +1043,22 @@ Sets the postition of @component."> - - + + address of #gint to put width of @component + - - + + address of #gint to put height of @component + - + - + %TRUE if successful, %FALSE otherwise. + @@ -887,7 +1068,7 @@ Sets the postition of @component."> - + @@ -896,80 +1077,95 @@ Sets the postition of @component."> - + the handler id of the focus handler to be removed from @component + - + - + %TRUE or %FALSE whether the extents were set or not + - + x coordinate + - + y coordinate + - + width to set for @component + - + height to set for @component + + specifies whether the coordinates are relative to the screen or to the components top level window - + - + %TRUE or %FALSE whether or not the position was set or not + - + x coordinate + - + y coordinate + + specifies whether the coordinates are relative to the screen or to the components top level window - + - + %TRUE or %FALSE whether the size was set or not + - + width to set for @component + - + height to set for @component + - - + + + an #AtkLayer which is the layer of the component @@ -980,9 +1176,10 @@ Sets the postition of @component."> - + - + a gint which is the zorder of the component, i.e. the depth at + @@ -992,7 +1189,7 @@ Sets the postition of @component."> - + @@ -1007,9 +1204,10 @@ Sets the postition of @component."> - + - + An alpha value from 0 to 1.0, inclusive. + @@ -1033,28 +1231,20 @@ Sets the postition of @component."> glib:nick="window"/> - - - - - - - - - - - - - - - - - - + + Gets a %gpointer that points to an instance of the DOM. It is +up to the caller to check atk_document_get_type to determine +how to cast this pointer. + + a %gpointer that points to an instance of the DOM. + @@ -1067,9 +1257,26 @@ Sets the postition of @component."> + + + + + + + + + + + + Gets a string indicating the document type. + + a string indicating the document type + + + - + @@ -1080,92 +1287,100 @@ Sets the postition of @component."> - + + document, or NULL if a value for #attribute_name has not been specified +for this document. + a string value associated with the named attribute for this + + + a character string representing the name of the attribute whose value is being queried. + + + + + + Gets an AtkAttributeSet which describes document-wide +attributes as name-value pairs. +set name-value-pair attributes associated with this document +as a whole. + + An AtkAttributeSet containing the explicitly + + + Gets a %gpointer that points to an instance of the DOM. It is up to the caller to check atk_document_get_type to determine -how to cast this pointer."> - - +how to cast this pointer. + + a %gpointer that points to an instance of the DOM. + - + Gets a string indicating the document type. + + a string indicating the document type + + + + + Gets a UTF-8 string indicating the POSIX-style LC_MESSAGES locale of the content of this document instance. Individual text substrings or images within this document may have a different locale, see atk_text_get_attributes and atk_image_get_image_locale. locale of the document content as a whole, or NULL if -the document content does not specify a locale."> +the document content does not specify a locale. + a UTF-8 string indicating the POSIX-style LC_MESSAGES - - - - - - - - - - - - - - - + for this document, FALSE otherwise (e.g. if the document does not +allow the attribute to be modified). - + TRUE if #value is successfully associated with #attribute_name + + a character string representing the name of the attribute whose value is being set. + a string value to be associated with #attribute_name. - - + + - - + + - - + + @@ -1176,8 +1391,9 @@ allow the attribute to be modified)." - + + a string indicating the document type @@ -1187,10 +1403,11 @@ allow the attribute to be modified)." - - - - + + + + a %gpointer that points to an instance of the DOM. + @@ -1200,7 +1417,7 @@ allow the attribute to be modified)." - + @@ -1211,10 +1428,9 @@ allow the attribute to be modified)." - - - + + + @@ -1225,8 +1441,7 @@ allow the attribute to be modified)." - + @@ -1241,10 +1456,9 @@ allow the attribute to be modified)." - + - + @@ -1273,206 +1487,230 @@ allow the attribute to be modified)." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Copy text from @start_pos up to, but not including @end_pos +to the clipboard. - + start position + - + end position + + Copy text from @start_pos up to, but not including @end_pos +to the clipboard and then delete from the widget. - + start position + - + end position + + Delete text @start_pos up to, but not including @end_pos. - + start position + - + end position + + + + + + Insert text at a given position. + + + + + + the text to insert + + + + the length of text to insert, in bytes + + + + The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text. + + Paste text from clipboard to specified @position. - + position to paste + - + - + - + - + - - + + + Set text contents of @text. + string to set for text contents of @text + + + Copy text from @start_pos up to, but not including @end_pos +to the clipboard. + + + + + + start position + + + + end position + + + - + + Copy text from @start_pos up to, but not including @end_pos +to the clipboard and then delete from the widget. + + + + + + start position + + + + end position + + + + + + Delete text @start_pos up to, but not including @end_pos. + + + + + + start position + + + + end position + + + + + + Insert text at a given position. + the text to insert - + the length of text to insert, in bytes + - - + + The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Paste text from clipboard to specified @position. - + position to paste + + + + + + + + + + + + + + + + + + + + + + Set text contents of @text. + + + + + + string to set for text contents of @text + @@ -1484,9 +1722,9 @@ to the clipboard and then delete from the widget."> - + - + @@ -1496,16 +1734,16 @@ to the clipboard and then delete from the widget."> - + - + - + @@ -1514,13 +1752,14 @@ to the clipboard and then delete from the widget."> + string to set for text contents of @text - + @@ -1529,21 +1768,22 @@ to the clipboard and then delete from the widget."> + the text to insert - + the length of text to insert, in bytes + - - + + The caller initializes this to the position at which to insert the text. After the call it points at the position after the newly inserted text. + - + @@ -1552,16 +1792,18 @@ to the clipboard and then delete from the widget."> - + start position + - + end position + - + @@ -1570,16 +1812,18 @@ to the clipboard and then delete from the widget."> - + start position + - + end position + - + @@ -1588,16 +1832,18 @@ to the clipboard and then delete from the widget."> - + start position + - + end position + - + @@ -1606,7 +1852,8 @@ to the clipboard and then delete from the widget."> - + position to paste + @@ -1618,28 +1865,26 @@ to the clipboard and then delete from the widget."> - + A function which is called when an object emits a matching event, as used in #atk_add_focus_tracker. Currently the only events for which object-specific handlers are -supported are events of type "focus:". Most clients of ATK will prefer to -attach signal handlers for the various ATK signals instead."> +supported are events of type "focus:". Most clients of ATK will prefer to +attach signal handlers for the various ATK signals instead. + An #AtkObject instance for whom the callback will be called when the specified event (e.g. 'focus:') takes place. - + An #AtkEventListenerInit function is a special function that is called in order to initialize the per-object event registration system -used by #AtkEventListener, if any preparation is required."> +used by #AtkEventListener, if any preparation is required. @@ -1653,21 +1898,22 @@ used by #AtkEventListener, if any preparation is required."> - + - + - + glib:type-struct="GObjectAccessibleClass"> - + introspectable="0"> + Gets the accessible object for the specified @obj. + + a #AtkObject which is the accessible object for the @obj + a #GObject - + introspectable="0"> + Gets the GObject for which @obj is the accessible object. + + a #GObject which is the object for which @obj is the accessible object @@ -1710,155 +1961,180 @@ used by #AtkEventListener, if any preparation is required."> - - - + + Gets the index with the hypertext document at which this link ends. + + the index with the hypertext document at which this link ends + - - - - - - - + + Gets the number of anchors associated with this hyperlink. + + the number of anchors associated with this hyperlink + + + + + Returns the item associated with this hyperlinks nth anchor. +For instance, the returned #AtkObject will implement #AtkText +if @link_ is a text hyperlink, #AtkImage if @link_ is an image +hyperlink etc. +Multiple anchors are primarily used by client-side image maps. + + an #AtkObject associated with this hyperlinks i-th anchor - + a (zero-index) integer specifying the desired anchor + - + + Gets the index with the hypertext document at which this link begins. - + the index with the hypertext document at which this link begins + - + + Get a the URI associated with the anchor specified +by @i of @link_. +Multiple anchors are primarily used by client-side image maps. + + a string specifying the URI + + + + + a (zero-index) integer specifying the desired anchor + + + + + - + + Since the document that a link is associated with may have changed +this method returns %TRUE if the link is still valid (with +respect to the document it references) and %FALSE otherwise. - - - - - - + whether or not this link is still valid + - + - + + Gets the index with the hypertext document at which this link ends. - + the index with the hypertext document at which this link ends + - - - - + + + Gets the number of anchors associated with this hyperlink. + + the number of anchors associated with this hyperlink + - - - - - + Returns the item associated with this hyperlinks nth anchor. For instance, the returned #AtkObject will implement #AtkText if @link_ is a text hyperlink, #AtkImage if @link_ is an image -hyperlink etc. -Multiple anchors are primarily used by client-side image maps."> - +hyperlink etc. +Multiple anchors are primarily used by client-side image maps. + + an #AtkObject associated with this hyperlinks i-th anchor - - + + a (zero-index) integer specifying the desired anchor + - - - - - + c:identifier="atk_hyperlink_get_start_index"> + Gets the index with the hypertext document at which this link begins. - + the index with the hypertext document at which this link begins + - - - + + Get a the URI associated with the anchor specified +by @i of @link_. +Multiple anchors are primarily used by client-side image maps. + + a string specifying the URI + + + + a (zero-index) integer specifying the desired anchor + + + - + Indicates whether the link currently displays some or all of its content inline. Ordinary HTML links will usually return %FALSE, but an inline &lt;src&gt; HTML element will return -%TRUE. -*"> +%TRUE. - + whether or not this link displays its content inline. + - + + Since the document that a link is associated with may have changed +this method returns %TRUE if the link is still valid (with +respect to the document it references) and %FALSE otherwise. - + whether or not this link is still valid + - - + + - - + + - - + + - - + + - - + + @@ -1869,8 +2145,9 @@ content inline. Ordinary HTML links will usually return - + + a string specifying the URI @@ -1878,14 +2155,16 @@ content inline. Ordinary HTML links will usually return - + a (zero-index) integer specifying the desired anchor + - - - + + + + an #AtkObject associated with this hyperlinks i-th anchor @@ -1893,15 +2172,17 @@ content inline. Ordinary HTML links will usually return - + a (zero-index) integer specifying the desired anchor + - + - + the index with the hypertext document at which this link ends + @@ -1911,9 +2192,10 @@ content inline. Ordinary HTML links will usually return - + - + the index with the hypertext document at which this link begins + @@ -1923,9 +2205,10 @@ content inline. Ordinary HTML links will usually return - + - + whether or not this link is still valid + @@ -1935,9 +2218,10 @@ content inline. Ordinary HTML links will usually return - + - + the number of anchors associated with this hyperlink + @@ -1947,9 +2231,9 @@ content inline. Ordinary HTML links will usually return - + - + @@ -1959,9 +2243,9 @@ content inline. Ordinary HTML links will usually return - + - + @@ -1971,7 +2255,7 @@ content inline. Ordinary HTML links will usually return - + @@ -1987,21 +2271,28 @@ content inline. Ordinary HTML links will usually return - - + + Gets the hyperlink associated with this object. +Returns an AtkHyperlink object which points to this implementing AtkObject. + - + version="1.12" + introspectable="0"> + Gets the hyperlink associated with this object. +Returns an AtkHyperlink object which points to this implementing AtkObject. + @@ -2012,9 +2303,9 @@ Returns an AtkHyperlink object which points to this implementing AtkObject." - - - + + + @@ -2038,76 +2329,93 @@ Returns an AtkHyperlink object which points to this implementing AtkObject." glib:nick="inline"/> - - + + Gets the link in this hypertext document at index +index @link_index + + the link in this hypertext document at - + an integer specifying the desired link + + + + + + Gets the index into the array of hyperlinks that is associated with +the character specified by @char_index. +or -1 if there is no hyperlink associated with this character. + + an index into the array of hyperlinks in @hypertext, + + + + + a character index + + Gets the number of links within this hypertext document. - + the number of links within this hypertext document + - - - - - - - - - - - + introspectable="0"> + Gets the link in this hypertext document at index +index @link_index + + the link in this hypertext document at - + an integer specifying the desired link + - - - - - + Gets the index into the array of hyperlinks that is associated with the character specified by @char_index. -or -1 if there is no hyperlink associated with this character."> +or -1 if there is no hyperlink associated with this character. - + an index into the array of hyperlinks in @hypertext, + - + a character index + + + Gets the number of links within this hypertext document. + + the number of links within this hypertext document + + + - - + + - + @@ -2118,9 +2426,10 @@ or -1 if there is no hyperlink associated with this character."> - - - + + + + the link in this hypertext document at @@ -2128,15 +2437,17 @@ or -1 if there is no hyperlink associated with this character."> - + an integer specifying the desired link + - + - + the number of links within this hypertext document + @@ -2146,22 +2457,24 @@ or -1 if there is no hyperlink associated with this character."> - + - + an index into the array of hyperlinks in @hypertext, + - + a character index + - + @@ -2170,7 +2483,7 @@ or -1 if there is no hyperlink associated with this character."> - + @@ -2186,125 +2499,150 @@ or -1 if there is no hyperlink associated with this character."> - - - - - - - - - - - - - - - - + Get a textual description of this image. + + a string representing the image description + + + + + Since ATK 1.12 +Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image description, or NULL if the image does not specify a locale. - + + Gets the position of the image in the form of a point specifying the +images top-left corner. - - + + address of #gint to put x coordinate position; otherwise, -1 if value cannot be obtained. + - - + + address of #gint to put y coordinate position; otherwise, -1 if value cannot be obtained. + + + + specifies whether the coordinates are relative to the screen or to the components top level window + + + + + + Get the width and height in pixels for the specified image. +The values of @width and @height are returned as -1 if the +values cannot be obtained (for instance, if the object is not onscreen). + + + + + + filled with the image width, or -1 if the value cannot be obtained. + + + + filled with the image height, or -1 if the value cannot be obtained. + + Sets the textual description for this image. +not be completed. - + boolean TRUE, or FALSE if operation could + + a string description to set for @image - - - - - + c:identifier="atk_image_get_image_description"> + Get a textual description of this image. + + a string representing the image description + + + + + Since ATK 1.12 +Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image description, or NULL if the image does not specify a locale. - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="atk_image_get_image_position"> + Gets the position of the image in the form of a point specifying the +images top-left corner. - - + + address of #gint to put x coordinate position; otherwise, -1 if value cannot be obtained. + - - + + address of #gint to put y coordinate position; otherwise, -1 if value cannot be obtained. + + specifies whether the coordinates are relative to the screen or to the components top level window - + + Get the width and height in pixels for the specified image. +The values of @width and @height are returned as -1 if the +values cannot be obtained (for instance, if the object is not onscreen). - + + + + filled with the image width, or -1 if the value cannot be obtained. + + + + filled with the image height, or -1 if the value cannot be obtained. + + + + + + Sets the textual description for this image. +not be completed. + + boolean TRUE, or FALSE if operation could + + + + + a string description to set for @image + + + - + @@ -2322,21 +2660,25 @@ Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image - - + + address of #gint to put x coordinate position; otherwise, -1 if value cannot be obtained. + - - + + address of #gint to put y coordinate position; otherwise, -1 if value cannot be obtained. + + specifies whether the coordinates are relative to the screen or to the components top level window - + + a string representing the image description @@ -2347,7 +2689,7 @@ Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image - + @@ -2355,32 +2697,36 @@ Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image - - + + filled with the image width, or -1 if the value cannot be obtained. + - - + + filled with the image height, or -1 if the value cannot be obtained. + - + - + boolean TRUE, or FALSE if operation could + + a string description to set for @image - + @@ -2395,54 +2741,46 @@ Returns a string corresponding to the POSIX LC_MESSAGES locale used by the image - - - + - + introspectable="0"> + Gets a reference to an object's #AtkObject implementation, if +the object implements #AtkObjectIface + + a reference to an object's #AtkObject implementation + + - + + Encapsulates information about a key event. - + - + - + - + - + - + c:identifier="ATK_KEY_EVENT_LAST_DEFINED" glib:nick="last-defined"/> - + An #AtkKeySnoopFunc is a type of callback which is called whenever a key event occurs, +if registered via atk_add_key_event_listener. It allows for pre-emptive interception of key events via the return code as described below. -discarded without being passed to the normal GUI recipient; FALSE (zero) if the -event dispatch to the client application should proceed as normal."> - - +discarded without being passed to the normal GUI recipient; FALSE (zero) if the +event dispatch to the client application should proceed as normal. + + TRUE (nonzero) if the event emission should be stopped and the event + + an AtkKeyEventStruct containing information about the key event for which notification is being given. - + a block of data which will be passed to the event listener, on notification. + @@ -2521,6 +2859,7 @@ event dispatch to the client application should proceed as normal."> glib:nick="window"/> glib:type-struct="MiscClass"> + Obtain the singleton instance of AtkMisc for this application. + The singleton instance of AtkMisc for this application. - + + Take the thread mutex for the GUI toolkit, +if one exists. +(This method is implemented by the toolkit ATK implementation layer; +for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER). - + + Release the thread mutex for the GUI toolkit, +if one exists. This method, and atk_misc_threads_enter, +are needed in some situations by threaded application code which +services ATK requests, since fulfilling ATK requests often +requires calling into the GUI toolkit. If a long-running or +potentially blocking call takes place inside such a block, it should +be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls. +(This method is implemented by the toolkit ATK implementation layer; +for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE). + Take the thread mutex for the GUI toolkit, +if one exists. +(This method is implemented by the toolkit ATK implementation layer; +for instance, for GTK+, GAIL implements this via GDK_THREADS_ENTER). + Release the thread mutex for the GUI toolkit, +if one exists. This method, and atk_misc_threads_enter, +are needed in some situations by threaded application code which services ATK requests, since fulfilling ATK requests often requires calling into the GUI toolkit. If a long-running or potentially blocking call takes place inside such a block, it should be bracketed by atk_misc_threads_leave/atk_misc_threads_enter calls. (This method is implemented by the toolkit ATK implementation layer; -for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE)." - version="1.13"> +for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE). @@ -2582,7 +2939,7 @@ for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE)." - + @@ -2594,7 +2951,7 @@ for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE)." - + @@ -2607,11 +2964,12 @@ for instance, for GTK+, GAIL implements this via GDK_THREADS_LEAVE)." - + - - - + + Provides a default (non-functioning stub) #AtkObject. +Application maintainers should not use this method. + + a default (non-functioning stub) #AtkObject + + a #GObject @@ -2652,17 +3011,18 @@ Application maintainers should not use this method."> - + + Creates an instance of an #AtkObjectFactory which generates primitive +(non-functioning) #AtkObjects. - + an instance of an #AtkObjectFactory + @@ -2677,82 +3037,155 @@ Application maintainers should not use this method."> - + + Specifies a function to be called when a property changes value. +atk_object_remove_property_change_handler() - - - - - - - - - - - - - - - - - - - - - + a #guint which is the handler id used in + - - + + - + + Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of +name-value pairs. As such these attributes may be considered weakly-typed properties or annotations, +as distinct from strongly-typed object data available via other get/set methods. +Not all objects have explicit "name-value pair" #AtkAttributeSet properties. +the object, or an empty set if the object has no name-value pair attributes assigned to it. + + an #AtkAttributeSet consisting of all explicit properties/annotations applied to + + + + + Gets the accessible description of the accessible. +of the accessible. - + a character string representing the accessible description + - - - - - - - - + + Gets the 0-based index of this accessible in its parent; returns -1 if the +accessible does not have an accessible parent. + + an integer which is the index of the accessible in its parent + - + - + - - - + + + - + + Gets the accessible name of the accessible. + + a character string representing the accessible name of the object. + + + + + Gets the accessible parent of the accessible. + + a #AtkObject representing the accessible parent of the accessible + + + + + Gets the role of the accessible. + + an #AtkRole which is the role of the accessible + + + + + This function is called when implementing subclasses of #AtkObject. +It does initialization required for the new object. It is intended +that this function should called only in the ..._new() functions used +to create an instance of a subclass of #AtkObject - - + + a #gpointer which identifies the object for which the AtkObject was created. + + + + + + + + + + + + + + + + Gets the #AtkRelationSet associated with the object. + + an #AtkRelationSet representing the relation set of the object. + + + + + Gets a reference to the state set of the accessible; the caller must +unreference it when it is no longer needed. +set of the accessible + + a reference to an #AtkStateSet which is the state + + + + + Removes a property change handler. + + + + + + + Sets the accessible description of the accessible. @@ -2762,7 +3195,20 @@ Application maintainers should not use this method."> + + Sets the accessible name of the accessible. + + + + + + a character string to be set as the accessible name + + + + + Sets the accessible parent of the accessible. @@ -2773,6 +3219,7 @@ Application maintainers should not use this method."> + Sets the role of the accessible. @@ -2782,10 +3229,32 @@ Application maintainers should not use this method."> - + + Adds a relationship of the specified type with the specified target. +Returns TRUE if the relationship is added. - + + + + + The #AtkRelationType of the relation + + + + The #AtkObject which is to be the target of the relation. + + + + + + Specifies a function to be called when a property changes value. +atk_object_remove_property_change_handler() + + a #guint which is the handler id used in + @@ -2793,136 +3262,171 @@ Application maintainers should not use this method."> c:type="AtkPropertyChangeHandler*"/> - - - - - - - - - - - - - - - - - - - - - - - + + + Get a list of properties applied to this object as a whole, as an #AtkAttributeSet consisting of +name-value pairs. As such these attributes may be considered weakly-typed properties or annotations, +as distinct from strongly-typed object data available via other get/set methods. +Not all objects have explicit "name-value pair" #AtkAttributeSet properties. +the object, or an empty set if the object has no name-value pair attributes assigned to it. + + an #AtkAttributeSet consisting of all explicit properties/annotations applied to - - + + + Gets the accessible description of the accessible. +of the accessible. + a character string representing the accessible description - + + Gets the 0-based index of this accessible in its parent; returns -1 if the +accessible does not have an accessible parent. + an integer which is the index of the accessible in its parent + + + + + Gets the number of accessible children of the accessible. +of the accessible. + + an integer representing the number of accessible children + + + + + Gets the accessible name of the accessible. + + a character string representing the accessible name of the object. - + introspectable="0"> + Gets the accessible parent of the accessible. + + a #AtkObject representing the accessible parent of the accessible - + + Gets the role of the accessible. - + an #AtkRole which is the role of the accessible + + + This function is called when implementing subclasses of #AtkObject. +It does initialization required for the new object. It is intended +that this function should called only in the ..._new() functions used +to create an instance of a subclass of #AtkObject + + + + + + a #gpointer which identifies the object for which the AtkObject was created. + + + + + + Emits a state-change signal for the specified state. + + + + + + an #AtkState whose state is changed + + + + + + + + Gets a reference to the specified accessible child of the object. The accessible children are 0-based so the first accessible child is at index 0, the second at index 1 and so on. -of the accessible."> - +of the accessible. + + an #AtkObject representing the specified accessible child - + a gint representing the position of the child, starting from 0 + - + introspectable="0"> + Gets the #AtkRelationSet associated with the object. + + an #AtkRelationSet representing the relation set of the object. - - - - - - - - - - + Gets a reference to the state set of the accessible; the caller must unreference it when it is no longer needed. -set of the accessible"> - +set of the accessible + + a reference to an #AtkStateSet which is the state - - - - - - + + Removes a property change handler. - - + + - + + Removes a relationship of the specified type with the specified target. +Returns TRUE if the relationship is removed. + + + + + + The #AtkRelationType of the relation + + + + The #AtkObject which is the target of the relation to be removed. + + + + + + Sets the accessible description of the accessible. @@ -2932,9 +3436,20 @@ accessible does not have an accessible parent."> - + + Sets the accessible name of the accessible. + + + + + + a character string to be set as the accessible name + + + + + + Sets the accessible parent of the accessible. @@ -2944,9 +3459,8 @@ accessible does not have an accessible parent."> - + + Sets the role of the accessible. @@ -2956,138 +3470,69 @@ accessible does not have an accessible parent."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -3111,64 +3556,64 @@ Returns TRUE if the relationship is removed."> - - + + - + - - + + - + - + - - + + - + - - + + - + - - + + - + - + - - + + @@ -3179,8 +3624,9 @@ Returns TRUE if the relationship is removed."> - + + a character string representing the accessible name of the object. @@ -3191,8 +3637,9 @@ Returns TRUE if the relationship is removed."> - + + a character string representing the accessible description @@ -3202,9 +3649,10 @@ Returns TRUE if the relationship is removed."> - - - + + + + a #AtkObject representing the accessible parent of the accessible @@ -3215,9 +3663,9 @@ Returns TRUE if the relationship is removed."> - + - + @@ -3226,9 +3674,9 @@ Returns TRUE if the relationship is removed."> - - - + + + @@ -3236,15 +3684,16 @@ Returns TRUE if the relationship is removed."> - + - + - + an integer which is the index of the accessible in its parent + @@ -3253,9 +3702,10 @@ Returns TRUE if the relationship is removed."> - - - + + + + an #AtkRelationSet representing the relation set of the object. @@ -3266,8 +3716,9 @@ Returns TRUE if the relationship is removed."> - - + + + an #AtkRole which is the role of the accessible @@ -3278,8 +3729,8 @@ Returns TRUE if the relationship is removed."> - - + + @@ -3290,9 +3741,9 @@ Returns TRUE if the relationship is removed."> - + - + @@ -3301,9 +3752,10 @@ Returns TRUE if the relationship is removed."> - - - + + + + a reference to an #AtkStateSet which is the state @@ -3314,7 +3766,7 @@ Returns TRUE if the relationship is removed."> - + @@ -3323,13 +3775,14 @@ Returns TRUE if the relationship is removed."> + a character string to be set as the accessible name - + @@ -3344,7 +3797,7 @@ Returns TRUE if the relationship is removed."> - + @@ -3359,7 +3812,7 @@ Returns TRUE if the relationship is removed."> - + @@ -3373,11 +3826,11 @@ Returns TRUE if the relationship is removed."> - - + + - + a #guint which is the handler id used in + @@ -3391,8 +3844,7 @@ Returns TRUE if the relationship is removed."> - + @@ -3401,13 +3853,13 @@ Returns TRUE if the relationship is removed."> - + - + @@ -3416,13 +3868,14 @@ Returns TRUE if the relationship is removed."> - + a #gpointer which identifies the object for which the AtkObject was created. + - + @@ -3431,16 +3884,16 @@ Returns TRUE if the relationship is removed."> - + - + - + @@ -3449,13 +3902,13 @@ Returns TRUE if the relationship is removed."> - + - - + + @@ -3464,13 +3917,13 @@ Returns TRUE if the relationship is removed."> - + - + @@ -3482,13 +3935,13 @@ Returns TRUE if the relationship is removed."> - + - + @@ -3500,8 +3953,7 @@ Returns TRUE if the relationship is removed."> - + @@ -3510,14 +3962,15 @@ Returns TRUE if the relationship is removed."> - + - - - + + + + an #AtkAttributeSet consisting of all explicit properties/annotations applied to @@ -3535,47 +3988,54 @@ Returns TRUE if the relationship is removed."> + Inform @factory that it is no longer being used to create +accessibles. When called, @factory may need to inform +#AtkObjects which it has created that they need to be re-instantiated. +in object registries. + Provides an #AtkObject that implements an accessibility interface on behalf of @obj -on behalf of @obj"> - +on behalf of @obj + + an #AtkObject that implements an accessibility interface + a #GObject - + + Gets the GType of the accessible which is created by the factory. +The value G_TYPE_INVALID is returned if no type if found. - + the type of the accessible which is created by the @factory. + - + + Inform @factory that it is no longer being used to create +accessibles. When called, @factory may need to inform +#AtkObjects which it has created that they need to be re-instantiated. +in object registries. - + @@ -3588,9 +4048,9 @@ The value G_TYPE_INVALID is returned if no type if found."> - - - + + + @@ -3601,7 +4061,7 @@ The value G_TYPE_INVALID is returned if no type if found."> - + @@ -3613,7 +4073,7 @@ The value G_TYPE_INVALID is returned if no type if found."> - + @@ -3627,14 +4087,16 @@ The value G_TYPE_INVALID is returned if no type if found."> + - + @@ -3658,7 +4120,7 @@ The value G_TYPE_INVALID is returned if no type if found."> - + @@ -3670,7 +4132,9 @@ The value G_TYPE_INVALID is returned if no type if found."> - + @@ -3679,204 +4143,175 @@ The value G_TYPE_INVALID is returned if no type if found."> - + - - + glib:get-type="atk_rectangle_get_type" + c:symbol-prefix="rectangle"> - + - + - + - + - - - + glib:get-type="atk_registry_get_type"> + + Gets an #AtkObjectFactory appropriate for creating #AtkObjects +appropriate for @type. +appropriate for @type. + + an #AtkObjectFactory appropriate for creating #AtkObjects + - - - + a #GType with which to look up the associated #AtkObjectFactory + c:identifier="atk_registry_get_factory_type"> + Provides a #GType indicating the #AtkObjectFactory subclass +associated with @type. + a #GType associated with type @type + a #GType with which to look up the associated #AtkObjectFactory subclass - - - + + Associate an #AtkObjectFactory subclass with a #GType. Note: +The associated @factory_type will thereafter be responsible for +the creation of new #AtkObject implementations for instances +appropriate for @type. + + + an #AtkObject type + + + + an #AtkObjectFactory type to associate with @type. Must implement AtkObject appropriate for @type. - - - + + Create a new relation for the specified key and the specified list +of targets. See also atk_object_add_relationship(). + a pointer to a new #AtkRelation + an array of pointers to #AtkObjects - + number of #AtkObjects pointed to by @targets + + an #AtkRelationType with which to create the new #AtkRelation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds the specified AtkObject to the target for the relation, if it is +not already present. See also atk_object_add_relationship(). + an #AtkObject - + + Gets the type of @relation - + the type of @relation + + + + + Gets the target list of @relation + + the target list of @relation + + + + + + + Remove the specified AtkObject from the target for the relation. +Returns TRUE if the removal is successful. + + + an #AtkObject - - + + - - + + - + + + @@ -3890,115 +4325,127 @@ Returns TRUE if the removal is successful."> - + + Creates a new empty relation set. + a new #AtkRelationSet - - - - - - - - - - - - - - - - - - - - - + Add a new relation to the current relation set if it is not already present. -This function ref's the AtkRelation so the caller of this function +This function ref's the AtkRelation so the caller of this function should unref it to ensure that it will be destroyed when the AtkRelationSet -is destroyed."> +is destroyed. + an #AtkRelation - - - - - - - - - - - - - - - - - - - - - - - - - + Add a new relation of the specified type with the specified target to the current relation set if the relation set does not contain a relation of that type. If it is does contain a relation of that typea the target -is added to the relation." - version="1.9"> +is added to the relation. + an #AtkRelationType + an #AtkObject + + Determines whether the relation set contains a relation that matches the +specified type. +in @set, %FALSE otherwise + + %TRUE if @relationship is the relationship type of a relation + + + + + an #AtkRelationType + + + + + + Determines the number of relations in a relation set. + + an integer representing the number of relations in the set. + + + + + + + + + + + + + + + Finds a relation that matches the specified type. + + an #AtkRelation, which is a relation matching the specified type. + + + + + an #AtkRelationType + + + + + + Removes a relation from the relation set. +This function unref's the #AtkRelation so it will be deleted unless there +is another reference to it. + + + + + + an #AtkRelation + + + + - + + + + Adds the specified accessible child of the object to the +object's selection. - + TRUE if success, FALSE otherwise. + - + a #gint specifying the child index. + + Clears the selection in the object so that no children in the object +are selected. - + TRUE if success, FALSE otherwise. + - - + + Gets the number of accessible children currently selected. +indication of whether AtkSelectionIface is implemented, they should +use type checking/interface checking macros or the +atk_get_accessible_value() convenience method. +if @selection does not implement this interface. + + a gint representing the number of items selected, or 0 + + + + + Determines if the current child of this object is selected +indication of whether AtkSelectionIface is implemented, they should +use type checking/interface checking macros or the +atk_get_accessible_value() convenience method. +if @selection does not implement this interface. + + a gboolean representing the specified child is selected, or 0 + + + + + a #gint specifying the child index. + + + + + + Gets a reference to the accessible object representing the specified +selected child of the object. +indication of whether AtkSelectionIface is implemented, they should +use type checking/interface checking macros or the +atk_get_accessible_value() convenience method. +if @selection does not implement this interface. + + an #AtkObject representing the selected accessible , or %NULL - - - - - - - - - - - - - - - - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + + Removes the specified child of the object from the object's selection. - + TRUE if success, FALSE otherwise. + - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + + Causes every child of the object to be selected if the object +supports multiple selections. - + TRUE if success, FALSE otherwise. + - + + Adds the specified accessible child of the object to the +object's selection. - + TRUE if success, FALSE otherwise. + - + a #gint specifying the child index. + + c:identifier="atk_selection_clear_selection"> + Clears the selection in the object so that no children in the object +are selected. - + TRUE if success, FALSE otherwise. + + + Gets the number of accessible children currently selected. +indication of whether AtkSelectionIface is implemented, they should +use type checking/interface checking macros or the +atk_get_accessible_value() convenience method. +if @selection does not implement this interface. + + a gint representing the number of items selected, or 0 + + + + + Determines if the current child of this object is selected +indication of whether AtkSelectionIface is implemented, they should +use type checking/interface checking macros or the +atk_get_accessible_value() convenience method. +if @selection does not implement this interface. + + a gboolean representing the specified child is selected, or 0 + + + + + a #gint specifying the child index. + + + + + Gets a reference to the accessible object representing the specified selected child of the object. indication of whether AtkSelectionIface is implemented, they should use type checking/interface checking macros or the atk_get_accessible_value() convenience method. -if @selection does not implement this interface."> - +if @selection does not implement this interface. + + an #AtkObject representing the selected accessible , or %NULL - - - - - - - - - - - - - - - - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + + c:identifier="atk_selection_remove_selection"> + Removes the specified child of the object from the object's selection. - + TRUE if success, FALSE otherwise. + - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + + c:identifier="atk_selection_select_all_selection"> + Causes every child of the object to be selected if the object +supports multiple selections. - + TRUE if success, FALSE otherwise. + - - + + @@ -4613,24 +5106,27 @@ supports multiple selections."> - + - + TRUE if success, FALSE otherwise. + - + a #gint specifying the child index. + - + - + TRUE if success, FALSE otherwise. + @@ -4639,9 +5135,10 @@ supports multiple selections."> - - - + + + + an #AtkObject representing the selected accessible , or %NULL @@ -4649,15 +5146,17 @@ supports multiple selections."> - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + - + - + a gint representing the number of items selected, or 0 + @@ -4667,39 +5166,44 @@ supports multiple selections."> - + - + a gboolean representing the specified child is selected, or 0 + - + a #gint specifying the child index. + - + - + TRUE if success, FALSE otherwise. + - + a #gint specifying the index in the selection set. (e.g. the ith selection as opposed to the ith child). + - + - + TRUE if success, FALSE otherwise. + @@ -4709,7 +5213,7 @@ supports multiple selections."> - + @@ -4728,44 +5232,49 @@ supports multiple selections."> + - + + Embeds the children of an #AtkPlug as the children of the #AtkSocket. The +plug may be in the same process or in a different process. - + + the ID of an #AtkPlug - + + Embeds the children of an #AtkPlug as the children of the #AtkSocket. The +plug may be in the same process or in a different process. - + + the ID of an #AtkPlug - + + Determines whether or not the socket has an embedded plug. - + TRUE if a plug is embedded in the socket + @@ -4782,7 +5291,7 @@ plug may be in the same process or in a different process."> - + @@ -4790,7 +5299,8 @@ plug may be in the same process or in a different process."> - + + the ID of an #AtkPlug @@ -4798,137 +5308,154 @@ plug may be in the same process or in a different process."> - + + Creates a new empty state set. + a new #AtkStateSet - + + Add a new state for the specified type to the current state set if +it is not already present. - - - - - - + %TRUE if the state for @type is not already in @set. + + an #AtkStateType - + + Add the states for the specified types to the current state set. + an array of #AtkStateType - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The number of elements in the array + - + introspectable="0"> + Constructs the intersection of the two sets, returning %NULL if the +intersection is empty. + + a new #AtkStateSet which is the intersection of the two sets. + another #AtkStateSet + + Removes all states from the state set. + + + + + + Checks whether the state for the specified type is in the specified set. + + %TRUE if @type is the state type is in @set. + + + + + an #AtkStateType + + + + + + Checks whether the states for all the specified types are in the +specified set. + + %TRUE if all the states for @type are in @set. + + + + + an array of #AtkStateType + + + + The number of elements in the array + + + + + + Checks whether the state set is empty, i.e. has no states set. + + %TRUE if @set has no states set, otherwise %FALSE + + + - + introspectable="0"> + Constructs the union of the two sets. +returning %NULL is empty. + + a new #AtkStateSet which is the union of the two sets, + another #AtkStateSet + + Removes the state for the specified type from the state set. + + %TRUE if @type was the state type is in @set. + + + + + an #AtkType + + + + + Constructs the exclusive-or of the two sets, returning %NULL is empty. The set returned by this operation contains the states in exactly one of the two sets. -in exactly one of the two sets."> - +in exactly one of the two sets. + + a new #AtkStateSet which contains the states which are + another #AtkStateSet @@ -5110,96 +5637,125 @@ in exactly one of the two sets."> glib:nick="last-defined"/> - - - - - + Gets the character string of the specified mime type. The first mime +type is at position 0, the second at position 1, and so on. +should not free the character string. - + a gint representing the position of the mime type starting from 0 + - - + + Gets the number of mime types supported by this object. + + a gint which is the number of mime types supported by the object. + + + + + Gets the content in the specified mime type. +type. + + A #GIOChannel which contains the content in the specified mime + a gchar* representing the mime type - + + Get a string representing a URI in IETF standard format +(see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content +may be streamed in the specified mime-type, if one is available. +If mime_type is NULL, the URI for the default (and possibly only) mime-type is +returned. +Note that it is possible for get_uri to return NULL but for +get_stream to work nonetheless, since not all GIOChannels connect to URIs. +can be constructed. + Returns a string representing a URI, or NULL if no corresponding URI + a gchar* representing the mime type, or NULL to request a URI for the default mime type. - - - - - + Gets the character string of the specified mime type. The first mime type is at position 0, the second at position 1, and so on. -should not free the character string."> +should not free the character string. - + a gint representing the position of the mime type starting from 0 + + + Gets the number of mime types supported by this object. + + a gint which is the number of mime types supported by the object. + + + - + introspectable="0"> + Gets the content in the specified mime type. +type. + + A #GIOChannel which contains the content in the specified mime + a gchar* representing the mime type + Get a string representing a URI in IETF standard format +(see http://www.ietf.org/rfc/rfc2396.txt) from which the object's content may be streamed in the specified mime-type, if one is available. If mime_type is NULL, the URI for the default (and possibly only) mime-type is -returned. +returned. Note that it is possible for get_uri to return NULL but for get_stream to work nonetheless, since not all GIOChannels connect to URIs. -can be constructed." - version="1.12"> +can be constructed. + Returns a string representing a URI, or NULL if no corresponding URI + a gchar* representing the mime type, or NULL to request a URI for the default mime type. @@ -5212,9 +5768,10 @@ can be constructed." - + - + a gint which is the number of mime types supported by the object. + @@ -5224,7 +5781,7 @@ can be constructed." - + @@ -5233,14 +5790,16 @@ can be constructed." - + a gint representing the position of the mime type starting from 0 + - - - + + + + A #GIOChannel which contains the content in the specified mime @@ -5248,14 +5807,16 @@ can be constructed." + a gchar* representing the mime type - + + Returns a string representing a URI, or NULL if no corresponding URI @@ -5263,6 +5824,7 @@ can be constructed." + a gchar* representing the mime type, or NULL to request a URI for the default mime type. @@ -5279,767 +5841,941 @@ can be constructed." - - - + + Adds the specified @column to the selection. +the selection, or 0 if value does not implement this interface. + + a gboolean representing if the column was successfully added to + + + + + a #gint representing a column in @table + + + + + + Adds the specified @row to the selection. +or 0 if value does not implement this interface. + + a gboolean representing if row was successfully added to selection, + - + a #gint representing a row in @table + + + + + + Gets the caption for the @table. +if value does not implement this interface. + + a AtkObject* representing the table caption, or %NULL + + + + + Gets a #gint representing the column at the specified @index_. +or -1 if the table does not implement this interface + + a gint representing the column at the specified index, + + + + + a #gint representing an index in @table + + + + + + Gets the description text of the specified @column in the table +if value does not implement this interface. + + a gchar* representing the column description, or %NULL + + + + + a #gint representing a column in @table + + + + + + Gets the number of columns occupied by the accessible object +at the specified @row and @column in the @table. +if value does not implement this interface. + + a gint representing the column extent at specified position, or 0 + + + + + a #gint representing a row in @table + - + a #gint representing a column in @table + + + + + + Gets the column header of a specified column in an accessible table. +%NULL if value does not implement this interface. + + a AtkObject* representing the specified column header, or + + + + + a #gint representing a column in the table + + Gets a #gint representing the index at the specified @row and @column. +The value -1 is returned if the object at row,column is not a child +of table or table does not implement this interface. - + a #gint representing the index at specified position. + - + a #gint representing a row in @table + - - - - - - - - - - - - - - - - - - - - - + a #gint representing a column in @table + + Gets the number of columns in the table. +if value does not implement this interface. - + a gint representing the number of columns, or 0 + + Gets the number of rows in the table. +if value does not implement this interface. - + a gint representing the number of rows, or 0 + - + + Gets a #gint representing the row at the specified @index_. +or -1 if the table does not implement this interface - + a gint representing the row at the specified index, + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #gint representing an index in @table + + Gets the description text of the specified row in the table +if value does not implement this interface. + a gchar* representing the row description, or %NULL - + a #gint representing a row in @table + - - + + Gets the number of rows occupied by the accessible object +at a specified @row and @column in the @table. +if value does not implement this interface. + + a gint representing the row extent at specified position, or 0 + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Gets the row header of a specified row in an accessible table. +%NULL if value does not implement this interface. + + a AtkObject* representing the specified row header, or - + a #gint representing a row in the table + - - + + Gets the selected columns of the table by initializing **selected with +the selected column numbers. This array should be freed by the caller. +or %0 if value does not implement this interface. + + a gint representing the number of selected columns, + + + + + a #gint** that is to contain the selected columns numbers + + + + + + Gets the selected rows of the table by initializing **selected with +the selected row numbers. This array should be freed by the caller. +or zero if value does not implement this interface. + + a gint representing the number of selected rows, + + + + + a #gint** that is to contain the selected row numbers + + + + + + Gets the summary description of the table. +or zero if value does not implement this interface. + + a AtkObject* representing a summary description of the table, + + Gets a boolean value indicating whether the specified @column +is selected +if value does not implement this interface. + + a gboolean representing if the column is selected, or 0 + + + + + a #gint representing a column in @table + + + + + + Gets a boolean value indicating whether the specified @row +is selected +if value does not implement this interface. + + a gboolean representing if the row is selected, or 0 + + + + + a #gint representing a row in @table + + + + + + Gets a boolean value indicating whether the accessible object +at the specified @row and @column is selected +if value does not implement this interface. + + a gboolean representing if the cell is selected, or 0 + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Get a reference to the table cell at @row, @column. + + a AtkObject* representing the referred to accessible + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Adds the specified @column to the selection. +the selection, or 0 if value does not implement this interface. + + a gboolean representing if the column was successfully removed from + + + + + a #gint representing a column in @table + + + + + + Removes the specified @row from the selection. +the selection, or 0 if value does not implement this interface. + + a gboolean representing if the row was successfully removed from + + + + + a #gint representing a row in @table + + + + + Sets the caption for the table. + a #AtkObject representing the caption to set for @table + Sets the description text for the specified @column of the @table. - + a #gint representing a column in @table + + a #gchar representing the description text to set for the specified @column of the @table + Sets the specified column header to @header. - + a #gint representing a column in @table + + an #AtkTable + Sets the description text for the specified @row of @table. - + a #gint representing a row in @table + + a #gchar representing the description text to set for the specified @row of @table + Sets the specified row header to @header. - + a #gint representing a row in @table + + an #AtkTable + Sets the summary description of the table. + an #AtkObject representing the summary description to set for @table - + + Adds the specified @column to the selection. +the selection, or 0 if value does not implement this interface. - - - - - - - - - - - - - - - - - - - - - + a gboolean representing if the column was successfully added to + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a #gint representing a column in @table + - + + Adds the specified @row to the selection. +or 0 if value does not implement this interface. - + a gboolean representing if row was successfully added to selection, + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a #gint representing a row in @table + - + introspectable="0"> + Gets the caption for the @table. +if value does not implement this interface. + + a AtkObject* representing the table caption, or %NULL - + + Gets a #gint representing the column at the specified @index_. +or -1 if the table does not implement this interface + a gint representing the column at the specified index, + + + + + a #gint representing an index in @table + + + + + + Gets the description text of the specified @column in the table +if value does not implement this interface. + + a gchar* representing the column description, or %NULL - + a #gint representing a column in @table + + + + + + Gets the number of columns occupied by the accessible object +at the specified @row and @column in the @table. +if value does not implement this interface. + + a gint representing the column extent at specified position, or 0 + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + - + introspectable="0"> + Gets the column header of a specified column in an accessible table. +%NULL if value does not implement this interface. + + a AtkObject* representing the specified column header, or - + a #gint representing a column in the table + + + + + + Gets a #gint representing the index at the specified @row and @column. +The value -1 is returned if the object at row,column is not a child +of table or table does not implement this interface. + + a #gint representing the index at specified position. + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Gets the number of columns in the table. +if value does not implement this interface. + + a gint representing the number of columns, or 0 + + + + + Gets the number of rows in the table. +if value does not implement this interface. + + a gint representing the number of rows, or 0 + + + + + Gets a #gint representing the row at the specified @index_. +or -1 if the table does not implement this interface + + a gint representing the row at the specified index, + + + + + a #gint representing an index in @table + + c:identifier="atk_table_get_row_description"> + Gets the description text of the specified row in the table +if value does not implement this interface. + a gchar* representing the row description, or %NULL - + a #gint representing a row in @table + + + + + + Gets the number of rows occupied by the accessible object +at a specified @row and @column in the @table. +if value does not implement this interface. + + a gint representing the row extent at specified position, or 0 + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + - + introspectable="0"> + Gets the row header of a specified row in an accessible table. +%NULL if value does not implement this interface. + + a AtkObject* representing the specified row header, or - + a #gint representing a row in the table + + + + + + Gets the selected columns of the table by initializing **selected with +the selected column numbers. This array should be freed by the caller. +or %0 if value does not implement this interface. + + a gint representing the number of selected columns, + + + + + a #gint** that is to contain the selected columns numbers + + + + + + Gets the selected rows of the table by initializing **selected with +the selected row numbers. This array should be freed by the caller. +or zero if value does not implement this interface. + + a gint representing the number of selected rows, + + + + + a #gint** that is to contain the selected row numbers + - + introspectable="0"> + Gets the summary description of the table. +or zero if value does not implement this interface. + + a AtkObject* representing a summary description of the table, - + + Gets a boolean value indicating whether the specified @column +is selected +if value does not implement this interface. + + a gboolean representing if the column is selected, or 0 + + + + + a #gint representing a column in @table + + + + + + Gets a boolean value indicating whether the specified @row +is selected +if value does not implement this interface. + + a gboolean representing if the row is selected, or 0 + + + + + a #gint representing a row in @table + + + + + + Gets a boolean value indicating whether the accessible object +at the specified @row and @column is selected +if value does not implement this interface. + + a gboolean representing if the cell is selected, or 0 + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Get a reference to the table cell at @row, @column. + + a AtkObject* representing the referred to accessible + + + + + a #gint representing a row in @table + + + + a #gint representing a column in @table + + + + + + Adds the specified @column to the selection. +the selection, or 0 if value does not implement this interface. + + a gboolean representing if the column was successfully removed from + + + + + a #gint representing a column in @table + + + + + + Removes the specified @row from the selection. +the selection, or 0 if value does not implement this interface. + + a gboolean representing if the row was successfully removed from + + + + + a #gint representing a row in @table + + + + + + Sets the caption for the table. + a #AtkObject representing the caption to set for @table + c:identifier="atk_table_set_column_description"> + Sets the description text for the specified @column of the @table. - + a #gint representing a column in @table + + a #gchar representing the description text to set for the specified @column of the @table + c:identifier="atk_table_set_column_header"> + Sets the specified column header to @header. - + a #gint representing a column in @table + + an #AtkTable + c:identifier="atk_table_set_row_description"> + Sets the description text for the specified @row of @table. - + a #gint representing a row in @table + + a #gchar representing the description text to set for the specified @row of @table - + + Sets the specified row header to @header. - + a #gint representing a row in @table + + an #AtkTable - + + Sets the summary description of the table. + an #AtkObject representing the summary description to set for @table - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - + - - + + - + - + - - + + - - + + - - + + - + - + - - + + - + - + - - + + @@ -6049,9 +6785,10 @@ the selection, or 0 if value does not implement this interface."> - - - + + + + a AtkObject* representing the referred to accessible @@ -6059,66 +6796,76 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a row in @table + - + a #gint representing a column in @table + - + - + a #gint representing the index at specified position. + - + a #gint representing a row in @table + - + a #gint representing a column in @table + - + - + a gint representing the column at the specified index, + - + a #gint representing an index in @table + - + - + a gint representing the row at the specified index, + - + a #gint representing an index in @table + - + - + a gint representing the number of columns, or 0 + @@ -6128,9 +6875,10 @@ the selection, or 0 if value does not implement this interface."> - + - + a gint representing the number of rows, or 0 + @@ -6140,44 +6888,51 @@ the selection, or 0 if value does not implement this interface."> - + - + a gint representing the column extent at specified position, or 0 + - + a #gint representing a row in @table + - + a #gint representing a column in @table + - + - + a gint representing the row extent at specified position, or 0 + - + a #gint representing a row in @table + - + a #gint representing a column in @table + - - - + + + + a AtkObject* representing the table caption, or %NULL @@ -6188,9 +6943,9 @@ the selection, or 0 if value does not implement this interface."> - + + a gchar* representing the column description, or %NULL @@ -6198,14 +6953,16 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a column in @table + - - - + + + + a AtkObject* representing the specified column header, or @@ -6213,14 +6970,16 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a column in the table + - + + a gchar* representing the row description, or %NULL @@ -6228,14 +6987,16 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a row in @table + - - - + + + + a AtkObject* representing the specified row header, or @@ -6243,14 +7004,16 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a row in the table + - - - + + + + a AtkObject* representing a summary description of the table, @@ -6261,7 +7024,7 @@ the selection, or 0 if value does not implement this interface."> - + @@ -6270,14 +7033,14 @@ the selection, or 0 if value does not implement this interface."> + a #AtkObject representing the caption to set for @table - + @@ -6286,16 +7049,18 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a column in @table + + a #gchar representing the description text to set for the specified @column of the @table - + @@ -6304,16 +7069,18 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a column in @table + + an #AtkTable - + @@ -6322,16 +7089,18 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a row in @table + + a #gchar representing the description text to set for the specified @row of @table - + @@ -6340,16 +7109,18 @@ the selection, or 0 if value does not implement this interface."> - + a #gint representing a row in @table + + an #AtkTable - + @@ -6358,156 +7129,171 @@ the selection, or 0 if value does not implement this interface."> + an #AtkObject representing the summary description to set for @table - + - + a gint representing the number of selected columns, + - - + + a #gint** that is to contain the selected columns numbers + - + - + a gint representing the number of selected rows, + - - + + a #gint** that is to contain the selected row numbers + - + - + a gboolean representing if the column is selected, or 0 + - + a #gint representing a column in @table + - + - + a gboolean representing if the row is selected, or 0 + - + a #gint representing a row in @table + - + - + a gboolean representing if the cell is selected, or 0 + - + a #gint representing a row in @table + - + a #gint representing a column in @table + - + - + a gboolean representing if row was successfully added to selection, + - + a #gint representing a row in @table + - + - + a gboolean representing if the row was successfully removed from + - + a #gint representing a row in @table + - + - + a gboolean representing if the column was successfully added to + - + a #gint representing a column in @table + - + - + a gboolean representing if the column was successfully removed from + - + a #gint representing a column in @table + - + @@ -6516,16 +7302,16 @@ the selection, or 0 if value does not implement this interface."> - + - + - + @@ -6534,16 +7320,16 @@ the selection, or 0 if value does not implement this interface."> - + - + - + @@ -6552,16 +7338,16 @@ the selection, or 0 if value does not implement this interface."> - + - + - + @@ -6570,16 +7356,16 @@ the selection, or 0 if value does not implement this interface."> - + - + - + @@ -6591,7 +7377,7 @@ the selection, or 0 if value does not implement this interface."> - + @@ -6603,7 +7389,7 @@ the selection, or 0 if value does not implement this interface."> - + @@ -6628,331 +7414,249 @@ the selection, or 0 if value does not implement this interface."> - + + Adds a selection bounded by the specified offsets. + + %TRUE if success, %FALSE otherwise + + + + + the start position of the selected region + + + + the offset of the first character after the selected region. + + + + + + Get the ranges of text in the specified bounding box. +by this function will be NULL. + + Array of AtkTextRange. The last element of the array returned + + + + + An AtkTextRectagle giving the dimensions of the bounding box. + + + + Specify whether coordinates are relative to the screen or widget window. + + + + Specify the horizontal clip type. + + + + Specify the vertical clip type. + + + + + + Gets the offset position of the caret (cursor). + + the offset position of the caret (cursor). + + + + + Gets the specified text. + + the character at @offset. + + + + + position + + + + + + Gets the character count. + + the number of characters. + + + + + Get the bounding box containing the glyph representing the character at +a particular text offset. + + + + + + The offset of the text character for which bounding information is required. + + + + Pointer for the x cordinate of the bounding box + + + + Pointer for the y cordinate of the bounding box + + + + Pointer for the width of the bounding box + + + + Pointer for the height of the bounding box + + + + specify whether coordinates are relative to the screen or widget window + + + + + + + + + + + Gets the number of selected regions. +occurred. + + The number of selected regions, or -1 if a failure + + + + + Gets the offset of the character located at coordinates @x and @y. @x and @y +are interpreted as being relative to the screen or this widget's window +depending on @coords. +the specified @x and @y coordinates. + + the offset to the character which is located at + + + + + screen x-position of character + + + + screen y-position of character + + + + specify whether coordinates are relative to the screen or widget window + + + + + + Get the bounding box for text within the specified range. + + + + + + The offset of the first text character for which boundary information is required. + + + + The offset of the text character after the last character for which boundary information is required. + + + + Specify whether coordinates are relative to the screen or widget window. + + + + A pointer to a AtkTextRectangle which is filled in by this function. + + + + + + + + + + + + + + + + + + + + + + Gets the text from the specified selection. + the selected text. + + + + + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + + + + passes back the start position of the selected region + + + + passes back the end position of (e.g. offset immediately past) the selected region + + + + + + Gets the specified text. + + the text from @start_offset up to, but not including @end_offset. - + start position + - + end position + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Gets the specified text. +If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character after the offset is returned. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string is from the word start after the offset to the next word start. -The returned string will contain the word after the offset if the offset +The returned string will contain the word after the offset if the offset is inside a word or if the offset is not inside a word. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string is from the word end at or after the offset to the next work end. @@ -6972,413 +7676,665 @@ after the offset if the offset is not inside a sentence. If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned string is from the line start after the offset to the next line start. If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string -is from the line end at or after the offset to the next line start."> +is from the line end at or after the offset to the next line start. + the text after @offset bounded by the specified @boundary_type. - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - - + Gets the specified text. If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the offset is returned. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string -is from the word start at or before the offset to the word start after +is from the word start at or before the offset to the word start after the offset. The returned string will contain the word at the offset if the offset -is inside a word and will contain the word before the offset if the +is inside a word and will contain the word before the offset if the offset is not inside a word. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string is from the word end before the offset to the word end at or after the offset. The returned string will contain the word at the offset if the offset -is inside a word and will contain the word after to the offset if the +is inside a word and will contain the word after to the offset if the offset is not inside a word. If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned string is from the sentence start at or before the offset to the sentence start after the offset. The returned string will contain the sentence at the offset if the offset -is inside a sentence and will contain the sentence before the offset +is inside a sentence and will contain the sentence before the offset if the offset is not inside a sentence. If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string is from the sentence end before the offset to the sentence end at or after the offset. The returned string will contain the sentence at the offset if the offset -is inside a sentence and will contain the sentence after the offset +is inside a sentence and will contain the sentence after the offset if the offset is not inside a sentence. If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned string is from the line start at or before the offset to the line start after the offset. If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string is from the line end before the offset to the line end at or after -the offset."> +the offset. + the text at @offset bounded by the specified @boundary_type. - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - - + Gets the specified text. If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character before the offset is returned. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string -is from the word start before the word start before the offset to +is from the word start before the word start before the offset to the word start before the offset. The returned string will contain the word before the offset if the offset -is inside a word and will contain the word before the word before the +is inside a word and will contain the word before the word before the offset if the offset is not inside a word. If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string -is from the word end before the word end at or before the offset to the +is from the word end before the word end at or before the offset to the word end at or before the offset. The returned string will contain the word before the offset if the offset is inside a word or if the offset is not inside a word. If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned -string is from the sentence start before the sentence start before +string is from the sentence start before the sentence start before the offset to the sentence start before the offset. -The returned string will contain the sentence before the offset if the -offset is inside a sentence and will contain the sentence before the +The returned string will contain the sentence before the offset if the +offset is inside a sentence and will contain the sentence before the sentence before the offset if the offset is not inside a sentence. If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string -is from the sentence end before the sentence end at or before the offset to +is from the sentence end before the sentence end at or before the offset to the sentence end at or before the offset. -The returned string will contain the sentence before the offset if the +The returned string will contain the sentence before the offset if the offset is inside a sentence or if the offset is not inside a sentence. If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned -string is from the line start before the line start ar or before the offset +string is from the line start before the line start ar or before the offset to the line start ar or before the offset. If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string -is from the line end before the line end before the offset to the -line end before the offset."> +is from the line end before the line end before the offset to the +line end before the offset. + the text before @offset bounded by the specified @boundary_type. - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - - + + + Removes the specified selection. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if success, %FALSE otherwise + - - - - - - - + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + - - + + + Sets the caret (cursor) position to the specified @offset. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if success, %FALSE otherwise. + - + position + - - + + + Changes the start and end offset of the specified selection. - + %TRUE if success, %FALSE otherwise + + + + + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + + + + the new start position of the selection + + + + the new end position of (e.g. offset immediately past) the selection + + + + + + Adds a selection bounded by the specified offsets. + + %TRUE if success, %FALSE otherwise + - + the start position of the selected region + - - - - - - - + the offset of the first character after the selected region. + - + version="1.3" + introspectable="0"> + Get the ranges of text in the specified bounding box. +by this function will be NULL. + + Array of AtkTextRange. The last element of the array returned + An AtkTextRectagle giving the dimensions of the bounding box. + Specify whether coordinates are relative to the screen or widget window. + Specify the horizontal clip type. + Specify the vertical clip type. - - - + + Gets the offset position of the caret (cursor). + + the offset position of the caret (cursor). + - - - + + + Gets the specified text. + + the character at @offset. + + + + + position + + + + + + Gets the character count. + + the number of characters. + + + + + Get the bounding box containing the glyph representing the character at +a particular text offset. + + + + The offset of the text character for which bounding information is required. + + + + Pointer for the x cordinate of the bounding box + + + + Pointer for the y cordinate of the bounding box + + + + Pointer for the width of the bounding box + + + + Pointer for the height of the bounding box + + + + specify whether coordinates are relative to the screen or widget window + + + + + + + + + + + Gets the number of selected regions. +occurred. + + The number of selected regions, or -1 if a failure + + + + + Gets the offset of the character located at coordinates @x and @y. @x and @y +are interpreted as being relative to the screen or this widget's window +depending on @coords. +the specified @x and @y coordinates. + + the offset to the character which is located at + + + + + screen x-position of character + + + + screen y-position of character + + + + specify whether coordinates are relative to the screen or widget window + + + + + + Get the bounding box for text within the specified range. + + + + + + The offset of the first text character for which boundary information is required. + + + + The offset of the text character after the last character for which boundary information is required. + + + + Specify whether coordinates are relative to the screen or widget window. + + + + A pointer to a AtkTextRectangle which is filled in by this function. + + + + + + + + + + + + + + + + + + + + + + Gets the text from the specified selection. + + the selected text. + + + + + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + + + + passes back the start position of the selected region + + + + passes back the end position of (e.g. offset immediately past) the selected region + + + + + + Gets the specified text. + + the text from @start_offset up to, but not including @end_offset. + + + + + start position + + + + end position + + + + + + Gets the specified text. +If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character after the +offset is returned. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string +is from the word start after the offset to the next word start. +The returned string will contain the word after the offset if the offset +is inside a word or if the offset is not inside a word. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string +is from the word end at or after the offset to the next work end. +The returned string will contain the word after the offset if the offset +is inside a word and will contain the word after the word after the offset +if the offset is not inside a word. +If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned +string is from the sentence start after the offset to the next sentence +start. +The returned string will contain the sentence after the offset if the offset +is inside a sentence or if the offset is not inside a sentence. +If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string +is from the sentence end at or after the offset to the next sentence end. +The returned string will contain the sentence after the offset if the offset +is inside a sentence and will contain the sentence after the sentence +after the offset if the offset is not inside a sentence. +If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned +string is from the line start after the offset to the next line start. +If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string +is from the line end at or after the offset to the next line start. + + the text after @offset bounded by the specified @boundary_type. + + + + + position + + + + An #AtkTextBoundary + + + + the start offset of the returned string + + + + the offset of the first character after the returned substring + + + + + + Gets the specified text. +If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character at the +offset is returned. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string +is from the word start at or before the offset to the word start after +the offset. +The returned string will contain the word at the offset if the offset +is inside a word and will contain the word before the offset if the +offset is not inside a word. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string +is from the word end before the offset to the word end at or after the +offset. +The returned string will contain the word at the offset if the offset +is inside a word and will contain the word after to the offset if the +offset is not inside a word. +If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned +string is from the sentence start at or before the offset to the sentence +start after the offset. +The returned string will contain the sentence at the offset if the offset +is inside a sentence and will contain the sentence before the offset +if the offset is not inside a sentence. +If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string +is from the sentence end before the offset to the sentence end at or +after the offset. +The returned string will contain the sentence at the offset if the offset +is inside a sentence and will contain the sentence after the offset +if the offset is not inside a sentence. +If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned +string is from the line start at or before the offset to the line +start after the offset. +If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string +is from the line end before the offset to the line end at or after +the offset. + + the text at @offset bounded by the specified @boundary_type. + + + + + position + + + + An #AtkTextBoundary + + + + the start offset of the returned string + + + + the offset of the first character after the returned substring + + + + + + Gets the specified text. +If the boundary_type if ATK_TEXT_BOUNDARY_CHAR the character before the +offset is returned. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_START the returned string +is from the word start before the word start before the offset to +the word start before the offset. +The returned string will contain the word before the offset if the offset +is inside a word and will contain the word before the word before the +offset if the offset is not inside a word. +If the boundary_type is ATK_TEXT_BOUNDARY_WORD_END the returned string +is from the word end before the word end at or before the offset to the +word end at or before the offset. +The returned string will contain the word before the offset if the offset +is inside a word or if the offset is not inside a word. +If the boundary type is ATK_TEXT_BOUNDARY_SENTENCE_START the returned +string is from the sentence start before the sentence start before +the offset to the sentence start before the offset. +The returned string will contain the sentence before the offset if the +offset is inside a sentence and will contain the sentence before the +sentence before the offset if the offset is not inside a sentence. +If the boundary_type is ATK_TEXT_BOUNDARY_SENTENCE_END the returned string +is from the sentence end before the sentence end at or before the offset to +the sentence end at or before the offset. +The returned string will contain the sentence before the offset if the +offset is inside a sentence or if the offset is not inside a sentence. +If the boundary type is ATK_TEXT_BOUNDARY_LINE_START the returned +string is from the line start before the line start ar or before the offset +to the line start ar or before the offset. +If the boundary_type is ATK_TEXT_BOUNDARY_LINE_END the returned string +is from the line end before the line end before the offset to the +line end before the offset. + + the text before @offset bounded by the specified @boundary_type. + + + + + position + + + + An #AtkTextBoundary + + + + the start offset of the returned string + + + + the offset of the first character after the returned substring + + + + + + Removes the specified selection. + + %TRUE if success, %FALSE otherwise + + + + + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + + + + + + Sets the caret (cursor) position to the specified @offset. + + %TRUE if success, %FALSE otherwise. + + + + + position + + + + + + Changes the start and end offset of the specified selection. + + %TRUE if success, %FALSE otherwise + + + + + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + + + + the new start position of the selection + + + + the new end position of (e.g. offset immediately past) the selection + + + + + + + + + + + + + - + - - + + - + - + - - + + @@ -7564,8 +8520,9 @@ by this function will be NULL." - + + the text from @start_offset up to, but not including @end_offset. @@ -7573,17 +8530,20 @@ by this function will be NULL." - + start position + - + end position + - + + the text after @offset bounded by the specified @boundary_type. @@ -7591,27 +8551,28 @@ by this function will be NULL." - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - + + the text at @offset bounded by the specified @boundary_type. @@ -7619,44 +8580,45 @@ by this function will be NULL." - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - - - - + + + + the character at @offset. + - + position + - + + the text before @offset bounded by the specified @boundary_type. @@ -7664,28 +8626,29 @@ by this function will be NULL." - + position + + An #AtkTextBoundary - - + + the start offset of the returned string + - - + + the offset of the first character after the returned substring + - + - + the offset position of the caret (cursor). + @@ -7694,9 +8657,9 @@ by this function will be NULL." - - - + + + @@ -7704,25 +8667,20 @@ by this function will be NULL." - + - - + + - - + + - - - + + + @@ -7733,7 +8691,7 @@ by this function will be NULL." - + @@ -7742,30 +8700,37 @@ by this function will be NULL." - + The offset of the text character for which bounding information is required. + - - + + Pointer for the x cordinate of the bounding box + - - + + Pointer for the y cordinate of the bounding box + - - + + Pointer for the width of the bounding box + - - + + Pointer for the height of the bounding box + + specify whether coordinates are relative to the screen or widget window - + - + the number of characters. + @@ -7775,30 +8740,35 @@ by this function will be NULL." - + - + the offset to the character which is located at + - + screen x-position of character + - + screen y-position of character + + specify whether coordinates are relative to the screen or widget window - + - + The number of selected regions, or -1 if a failure + @@ -7808,8 +8778,9 @@ by this function will be NULL." - + + the selected text. @@ -7817,92 +8788,102 @@ by this function will be NULL." - + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + - - + + passes back the start position of the selected region + - - + + passes back the end position of (e.g. offset immediately past) the selected region + - + - + %TRUE if success, %FALSE otherwise + - + the start position of the selected region + - + the offset of the first character after the selected region. + - + - + %TRUE if success, %FALSE otherwise + - + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + - + - + %TRUE if success, %FALSE otherwise + - + The selection number. The selected regions are assigned numbers that correspond to how far the region is from the start of the text. The selected region closest to the beginning of the text region is assigned the number 0, etc. Note that adding, moving or deleting a selected region can change the numbering. + - + the new start position of the selection + - + the new end position of (e.g. offset immediately past) the selection + - + - + %TRUE if success, %FALSE otherwise. + - + position + - + @@ -7911,16 +8892,16 @@ by this function will be NULL." - + - + - + @@ -7929,14 +8910,13 @@ by this function will be NULL." - + - + @@ -7948,8 +8928,7 @@ by this function will be NULL." - + @@ -7961,7 +8940,7 @@ by this function will be NULL." - + @@ -7970,23 +8949,28 @@ by this function will be NULL." - + The offset of the first text character for which boundary information is required. + - + The offset of the text character after the last character for which boundary information is required. + + Specify whether coordinates are relative to the screen or widget window. + A pointer to a AtkTextRectangle which is filled in by this function. - - - + + + + Array of AtkTextRange. The last element of the array returned @@ -7994,15 +8978,19 @@ by this function will be NULL." + An AtkTextRectagle giving the dimensions of the bounding box. + Specify whether coordinates are relative to the screen or widget window. + Specify the horizontal clip type. + Specify the vertical clip type. @@ -8012,39 +9000,38 @@ by this function will be NULL." - + + A structure used to describe a text range. - + - + - + + A structure used to store a rectangle used by AtkText. - + - + - + - + - - + + - + @@ -8078,63 +9064,60 @@ by this function will be NULL." - + - + - - + + - + - + - + - + - + - - - + + + - + - + @@ -8142,120 +9125,141 @@ by this function will be NULL." + Gets the value of this object. + a #GValue representing the current accessible value + Gets the maximum value of this object. - - - - - - - - - - - - - - - - - - - - + a #GValue representing the maximum accessible value + invoker="get_minimum_increment" + version="1.12"> + Gets the minimum increment by which the value of this object may be changed. If zero, +the minimum increment is undefined, which may mean that it is limited only by the +floating point precision of the platform. + a #GValue representing the minimum increment by which the accessible value may be changed + + + + + + Gets the minimum value of this object. + + + + + + a #GValue representing the minimum accessible value + + + + + + Sets the value of this object. + + %TRUE if new value is successfully set, %FALSE otherwise. + + + + + a #GValue which is the desired new accessible value. + c:identifier="atk_value_get_current_value"> + Gets the value of this object. + a #GValue representing the current accessible value + c:identifier="atk_value_get_maximum_value"> + Gets the maximum value of this object. - - - - - - - - - - - - - - - - - - - - + a #GValue representing the maximum accessible value + Gets the minimum increment by which the value of this object may be changed. If zero, +the minimum increment is undefined, which may mean that it is limited only by the +floating point precision of the platform. + a #GValue representing the minimum increment by which the accessible value may be changed + + + + + + Gets the minimum value of this object. + + + + + + a #GValue representing the minimum accessible value + + + + + + Sets the value of this object. + + %TRUE if new value is successfully set, %FALSE otherwise. + + + + + a #GValue which is the desired new accessible value. @@ -8268,7 +9272,7 @@ floating point precision of the platform." - + @@ -8277,13 +9281,14 @@ floating point precision of the platform." + a #GValue representing the current accessible value - + @@ -8292,13 +9297,14 @@ floating point precision of the platform." + a #GValue representing the maximum accessible value - + @@ -8307,28 +9313,31 @@ floating point precision of the platform." + a #GValue representing the minimum accessible value - + - + %TRUE if new value is successfully set, %FALSE otherwise. + + a #GValue which is the desired new accessible value. - + @@ -8337,6 +9346,7 @@ floating point precision of the platform." + a #GValue representing the minimum increment by which the accessible value may be changed @@ -8346,333 +9356,440 @@ floating point precision of the platform." + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + introspectable="0"> + Adds the specified function to the list of functions to be called +when an object receives focus. - + added focus tracker id, or 0 on failure. + - + + Function to be added to the list of functions to be called when an object receives focus. + introspectable="0"> + Adds the specified function to the list of functions to be called +when an event of type event_type occurs. - + added event listener id, or 0 on failure. + - + + the listener to notify + the type of event for which notification is requested + Adds the specified function to the list of functions to be called when a key event occurs. The @data element will be passed to the -#AtkKeySnoopFunc (@listener) as the @func_data param, on notification."> +#AtkKeySnoopFunc (@listener) as the @func_data param, on notification. - + added event listener id, or 0 on failure. + - + + the listener to notify - + a #gpointer that points to a block of data that should be sent to the registered listeners, along with the event notification, when it occurs. + - + + Frees the memory used by an #AtkAttributeSet, including all its +#AtkAttributes. + The #AtkAttributeSet to free + Specifies the function to be called for focus tracker initialization. This function should be called by an implementation of the ATK interface if any specific work needs to be done to enable -focus tracking."> +focus tracking. - + + Function to be called for focus tracker initialization + c:identifier="atk_focus_tracker_notify"> + Cause the focus tracker functions which have been specified to be +executed for the object. + an #AtkObject - + c:identifier="atk_get_default_registry" + introspectable="0"> + - + version="1.6" + introspectable="0"> + Gets the currently focused object. + + the currently focused object for the current application - - + + Gets the root accessible container for the current application. + + the root accessible container for the current application - + + Gets name string for the GUI toolkit implementing ATK for this application. + name string for the GUI toolkit implementing ATK for this application + c:identifier="atk_get_toolkit_version"> + Gets version string for the GUI toolkit implementing ATK for this application. + version string for the GUI toolkit implementing ATK for this application - + + Gets the current version for ATK. + version string for ATK + + Get the #AtkRelationType type corresponding to a relation name. +or #ATK_RELATION_NULL if no matching relation type is found. + + the #AtkRelationType enumerated type corresponding to the specified name, + + + + + a string which is the (non-localized) name of an ATK relation type. + + + + + + Gets the description string describing the #AtkRelationType @type. + + the string describing the AtkRelationType + + + + + The #AtkRelationType whose name is required + + + + + + Associate @name with a new #AtkRelationType + + an #AtkRelationType associated with @name + + + + + a name string + + + + + c:identifier="atk_remove_focus_tracker"> + Removes the specified focus tracker from the list of functions +to be called when any object receives focus. - + the id of the focus tracker to remove + + c:identifier="atk_remove_global_event_listener"> + Removes the specified event listener - + the id of the event listener to remove + + c:identifier="atk_remove_key_event_listener"> + Removes the specified event listener - + the id of the event listener to remove + - - + + Get the #AtkRole type corresponding to a rolew name. +or #ATK_ROLE_INVALID if no matching role is found. + + the #AtkRole enumerated type corresponding to the specified - + + a string which is the (non-localized) name of an ATK role. + c:identifier="atk_role_get_localized_name"> + Gets the localized description string describing the #AtkRole @role. + the localized string describing the AtkRole + The #AtkRole whose localized name is required - + + Gets the description string describing the #AtkRole @role. + the string describing the AtkRole + The #AtkRole whose name is required - - + + Registers the role specified by @name. + + an #AtkRole for the new role. + a character string describing the new role. - + c:identifier="atk_state_type_for_name"> + Gets the #AtkStateType corresponding to the description string @name. + + an #AtkStateType corresponding to @name + a character string state name + c:identifier="atk_state_type_get_name"> + Gets the description string describing the #AtkStateType @type. + the string describing the AtkStateType + The #AtkStateType whose name is required - + c:identifier="atk_state_type_register"> + Register a new object state. + + an #AtkState value for the new state. + a character string describing the new state. - + c:identifier="atk_text_attribute_for_name"> + Get the #AtkTextAttribute type corresponding to a text attribute name. +or #ATK_TEXT_ATTRIBUTE_INVALID if no matching text attribute is found. + + the #AtkTextAttribute enumerated type corresponding to the specified - + + a string which is the (non-localized) name of an ATK text attribute. + c:identifier="atk_text_attribute_get_name"> + Gets the name corresponding to the #AtkTextAttribute + a string containing the name; this string should not be freed + The #AtkTextAttribute whose name is required + c:identifier="atk_text_attribute_get_value"> + Gets the value for the index of the #AtkTextAttribute +NULL is returned if there are no values maintained for the attr value. + a string containing the value; this string should not be freed; + The #AtkTextAttribute for which a value is required - + The index of the required value + - + c:identifier="atk_text_attribute_register"> + Associate @name with a new #AtkTextAttribute + + an #AtkTextAttribute associated with @name + a name string + Frees the memory associated with an array of AtkTextRange. It is assumed +that the array was returned by the function atk_text_get_bounded_ranges +and is NULL terminated. + A pointer to an array of #AtkTextRange which is to be freed. diff --git a/basis/atk/ffi/ffi.factor b/basis/atk/ffi/ffi.factor index 67c8362c73..1f2c5b4926 100644 --- a/basis/atk/ffi/ffi.factor +++ b/basis/atk/ffi/ffi.factor @@ -1,10 +1,15 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries alien.syntax combinators kernel -system -gobject-introspection glib.ffi gobject.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: atk.ffi +<< +"gobject.ffi" require +>> + +LIBRARY: atk + << "atk" { { [ os winnt? ] [ "libatk-1.0-0.dll" cdecl add-library ] } @@ -13,11 +18,4 @@ IN: atk.ffi } cond >> -TYPEDEF: guint64 AtkState -TYPEDEF: GSList AtkAttributeSet - -! gir: error -C-TYPE: AtkPropertyValues - GIR: vocab:atk/Atk-1.0.gir - diff --git a/basis/gdk/Gdk-2.0.gir b/basis/gdk/Gdk-2.0.gir deleted file mode 100644 index 1005087db9..0000000000 --- a/basis/gdk/Gdk-2.0.gir +++ /dev/null @@ -1,22284 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/basis/gdk/Gdk-3.0.gir b/basis/gdk/Gdk-3.0.gir new file mode 100644 index 0000000000..cce09d3829 --- /dev/null +++ b/basis/gdk/Gdk-3.0.gir @@ -0,0 +1,19560 @@ + + + + + + + + + + + + + + + + + + + Used to represent native events (<type>XEvent</type>s for the X11 +backend, <type>MSG</type>s for Win32). + + + + + + + + Creates a new #GdkAppLaunchContext. + + a new #GdkAppLaunchContext + + + + + Sets the workspace on which applications will be launched when +using this context when running under a window manager that +supports multiple workspaces, as described in the +<ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended +Window Manager Hints</ulink>. +When the workspace is not specified or @desktop is set to -1, +it is up to the window manager to pick one, typically it will +be the current workspace. + + + + + + the number of a workspace, or -1 + + + + + + Sets the display on which applications will be launched when +using this context. See also gdk_app_launch_context_set_screen(). + + + + + + a #GdkDisplay + + + + + + Sets the icon for applications that are launched with this +context. +Window Managers can use this information when displaying startup +notification. +See also gdk_app_launch_context_set_icon_name(). + + + + + + a #GIcon, or %NULL + + + + + + Sets the icon for applications that are launched with this context. +The @icon_name will be interpreted in the same way as the Icon field +in desktop files. See also gdk_app_launch_context_set_icon(). +If both @icon and @icon_name are set, the @icon_name takes priority. +If neither @icon or @icon_name is set, the icon is taken from either +the file that is passed to launched application or from the #GAppInfo +for the launched application itself. + + + + + + an icon name, or %NULL + + + + + + Sets the screen on which applications will be launched when +using this context. See also gdk_app_launch_context_set_display(). +If both @screen and @display are set, the @screen takes priority. +If neither @screen or @display are set, the default screen and +display are used. + + + + + + a #GdkScreen + + + + + + Sets the timestamp of @context. The timestamp should ideally +be taken from the event that triggered the launch. +Window managers can use this information to avoid moving the +focus to the newly launched application when the user is busy +typing in another window. This is also known as 'focus stealing +prevention'. + + + + + + a timestamp + + + + + + + + + + + + + + + + + + + + + + An enumeration describing the way in which a device +axis (valuator) maps onto the predefined valuator +types that GTK+ understands. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Makes a copy of a color structure. The result +must be freed using gdk_color_free(). + + a copy of @color. + + + + + Compares two colors. + + %TRUE if the two colors compare equal + + + + + another #GdkColor. + + + + + + Frees a color structure created with +gdk_color_copy(). + + + + + + A hash function suitable for using for a hash +table that stores #GdkColor's. + + The hash function applied to @colora + + + + + Returns a textual specification of @color in the hexadecimal form +<literal>&num;rrrrggggbbbb</literal>, where <literal>r</literal>, +<literal>g</literal> and <literal>b</literal> are hex digits +representing the red, green and blue components respectively. + + a newly-allocated text string + + + + + + + Creates a new colormap for the given visual. + + the new #GdkColormap. + + + + + a #GdkVisual. + + + + if %TRUE, the newly created colormap will be a private colormap, and all colors in it will be allocated for the applications use. + + + + + + Gets the system's default colormap for the default screen. (See +gdk_colormap_get_system_for_screen ()) + + the default colormap. + + + + + Allocates a single color from a colormap. + + %TRUE if the allocation succeeded. + + + + + the color to allocate. On return the <structfield>pixel</structfield> field will be filled in if allocation succeeds. + + + + this parameter has no effect, and it's here for mere compatibility. + + + + If %TRUE, GDK will attempt to do matching against existing colors if the color cannot be allocated as requested. + + + + + + Allocates colors from a colormap. +allocated. + + The number of colors that were not successfully + + + + + The color values to allocate. On return, the pixel values for allocated colors will be filled in. + + + + The number of colors in @colors. + + + + this parameter has no effect, and it's here for mere compatibility. + + + + If %TRUE, GDK will attempt to do matching against existing colors if the colors cannot be allocated as requested. + + + + An array of length @ncolors. On return, this indicates whether the corresponding color in @colors was successfully allocated or not. + + + + + + Frees previously allocated colors. + + + + + + the colors to free. + + + + the number of colors in @colors. + + + + + + Gets the screen for which this colormap was created. + + the screen for which this colormap was created. + + + + + Returns the visual for which a given colormap was created. + + the visual of the colormap. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Creates a new cursor from the set of builtin cursors for the default display. +See gdk_cursor_new_for_display(). +To make the cursor invisible, use %GDK_BLANK_CURSOR. + + a new #GdkCursor + + + + + cursor to create + + + + + + Creates a new cursor from the set of builtin cursors. +Some useful ones are: +<itemizedlist> +<listitem><para> +<inlinegraphic format="PNG" fileref="right_ptr.png"></inlinegraphic> #GDK_RIGHT_PTR (right-facing arrow) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="crosshair.png"></inlinegraphic> #GDK_CROSSHAIR (crosshair) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="xterm.png"></inlinegraphic> #GDK_XTERM (I-beam) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="watch.png"></inlinegraphic> #GDK_WATCH (busy) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="fleur.png"></inlinegraphic> #GDK_FLEUR (for moving objects) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="hand1.png"></inlinegraphic> #GDK_HAND1 (a right-pointing hand) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="hand2.png"></inlinegraphic> #GDK_HAND2 (a left-pointing hand) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="left_side.png"></inlinegraphic> #GDK_LEFT_SIDE (resize left side) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="right_side.png"></inlinegraphic> #GDK_RIGHT_SIDE (resize right side) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="top_left_corner.png"></inlinegraphic> #GDK_TOP_LEFT_CORNER (resize northwest corner) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="top_right_corner.png"></inlinegraphic> #GDK_TOP_RIGHT_CORNER (resize northeast corner) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="bottom_left_corner.png"></inlinegraphic> #GDK_BOTTOM_LEFT_CORNER (resize southwest corner) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="bottom_right_corner.png"></inlinegraphic> #GDK_BOTTOM_RIGHT_CORNER (resize southeast corner) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="top_side.png"></inlinegraphic> #GDK_TOP_SIDE (resize top side) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="bottom_side.png"></inlinegraphic> #GDK_BOTTOM_SIDE (resize bottom side) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="sb_h_double_arrow.png"></inlinegraphic> #GDK_SB_H_DOUBLE_ARROW (move vertical splitter) +</para></listitem> +<listitem><para> +<inlinegraphic format="PNG" fileref="sb_v_double_arrow.png"></inlinegraphic> #GDK_SB_V_DOUBLE_ARROW (move horizontal splitter) +</para></listitem> +<listitem><para> +#GDK_BLANK_CURSOR (Blank cursor). Since 2.16 +</para></listitem> +</itemizedlist> + + a new #GdkCursor + + + + + the #GdkDisplay for which the cursor will be created + + + + cursor to create + + + + + + Creates a new cursor by looking up @name in the current cursor +theme. +the given name + + a new #GdkCursor, or %NULL if there is no cursor with + + + + + the #GdkDisplay for which the cursor will be created + + + + the name of the cursor + + + + + + Creates a new cursor from a pixbuf. +Not all GDK backends support RGBA cursors. If they are not +supported, a monochrome approximation will be displayed. +The functions gdk_display_supports_cursor_alpha() and +gdk_display_supports_cursor_color() can be used to determine +whether RGBA cursors are supported; +gdk_display_get_default_cursor_size() and +gdk_display_get_maximal_cursor_size() give information about +cursor sizes. +On the X backend, support for RGBA cursors requires a +sufficently new version of the X Render extension. + + a new #GdkCursor. + + + + + the #GdkDisplay for which the cursor will be created + + + + the #GdkPixbuf containing the cursor image + + + + the horizontal offset of the 'hotspot' of the cursor. + + + + the vertical offset of the 'hotspot' of the cursor. + + + + + + Creates a new cursor from a given pixmap and mask. Both the pixmap and mask +must have a depth of 1 (i.e. each pixel has only 2 values - on or off). +The standard cursor size is 16 by 16 pixels. + + a new #GdkCursor. + + + + + the pixmap specifying the cursor. + + + + the pixmap specifying the mask, which must be the same size as + + + + the foreground color, used for the bits in the source which are 1. The color does not have to be allocated first. + + + + the background color, used for the bits in the source which are 0. The color does not have to be allocated first. + + + + the horizontal offset of the 'hotspot' of the cursor. + + + + the vertical offset of the 'hotspot' of the cursor. + + + + + + Returns the cursor type for this cursor. + + a #GdkCursorType + + + + + + + + + + Returns a #GdkPixbuf with the image used to display the cursor. +Note that depending on the capabilities of the windowing system and +on the cursor, GDK may not be able to obtain the image data. In this +case, %NULL is returned. + + a #GdkPixbuf representing @cursor, or %NULL + + + + + Adds a reference to @cursor. + + Same @cursor that was passed in + + + + + Removes a reference from @cursor, deallocating the cursor +if no references remain. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Frees an array of #GdkTimeCoord that was returned by gdk_device_get_history(). + + + + + + an array of #GdkTimeCoord. + + + + the length of the array. + + + + + + Returns the core pointer device for the default display. +display and should not be freed. +gdk_event_get_device() if a #GdkEvent with pointer device +information is available. + + the core pointer device; this is owned by the + + + + + Determines information about the current keyboard grab. +This is not public API and must not be used by applications. +keyboard grabbed. + + %TRUE if this application currently has the + + + + + the display for which to get the grab information + + + + device to get the grab information from + + + + location to store current grab window + + + + location to store boolean indicating whether the @owner_events flag to gdk_keyboard_grab() or gdk_pointer_grab() was %TRUE. + + + + + + Returns the associated device to @device, if @device is of type +%GDK_DEVICE_TYPE_MASTER, it will return the paired pointer or +keyboard. +If @device is of type %GDK_DEVICE_TYPE_SLAVE, it will return +the master device to which @device is attached to. +If @device is of type %GDK_DEVICE_TYPE_FLOATING, %NULL will be +returned, as there is no associated device. + + The associated device, or %NULL + + + + + Interprets an array of double as axis values for a given device, +and locates the value in the array for a given axis use. + + %TRUE if the given axis use was found, otherwise %FALSE + + + + + pointer to an array of axes + + + + the use to look for + + + + location to store the found value. + + + + + + Returns the axis use for @index_. + + a #GdkAxisUse specifying how the axis is used. + + + + + the index of the axis. + + + + + + Interprets an array of double as axis values for a given device, +and locates the value in the array for a given axis label, as returned +by gdk_device_list_axes() + + %TRUE if the given axis use was found, otherwise %FALSE. + + + + + pointer to an array of axes + + + + #GdkAtom with the axis label. + + + + location to store the found value. + + + + + + Returns the device type for @device. + + the #GdkDeviceType for @device. + + + + + Returns the #GdkDisplay to which @device pertains. +and must not be freed or unreffed. + + a #GdkDisplay. This memory is owned by GTK+, + + + + + Determines whether the pointer follows device motion. + + %TRUE if the pointer follows device motion + + + + + Obtains the motion history for a device; given a starting and +ending timestamp, return all events in the motion history for +the device in the given range of time. Some windowing systems +do not support motion history, in which case, %FALSE will +be returned. (This is not distinguishable from the case where +motion history is supported and no events were found.) +at least one event was found. + + %TRUE if the windowing system supports motion history and + + + + + the window with respect to which which the event coordinates will be reported + + + + starting timestamp for range of events to return + + + + ending timestamp for the range of events to return + + + + location to store a newly-allocated array of #GdkTimeCoord, or %NULL + + + + + + location to store the length of @events, or %NULL + + + + + + If @index_ has a valid keyval, this function will return %TRUE +and fill in @keyval and @modifiers with the keyval settings. + + %TRUE if keyval is set for @index. + + + + + the index of the macro button to get. + + + + return value for the keyval. + + + + return value for modifiers. + + + + + + Determines the mode of the device. + + a #GdkInputSource + + + + + Returns the number of axes the device currently has. + + the number of axes. + + + + + Determines the name of the device. + + a name + + + + + Determines the type of the device. + + a #GdkInputSource + + + + + Gets the current state of a device relative to @window. + + + + + + a #GdkWindow. + + + + an array of doubles to store the values of the axes of @device in, or %NULL. + + + + location to store the modifiers, or %NULL. + + + + + + Grabs the device so that all events coming from this device are passed to +this application until the device is ungrabbed with gdk_device_ungrab(), +or the window becomes unviewable. This overrides any previous grab on the device +by this client. +Device grabs are used for operations which need complete control over the +given device events (either pointer or keyboard). For example in GTK+ this +is used for Drag and Drop operations, popup menus and such. +Note that if the event mask of an X window has selected both button press +and button release events, then a button press event will cause an automatic +pointer grab until the button is released. X does this automatically since +most applications expect to receive button press and release events in pairs. +It is equivalent to a pointer grab on the window with @owner_events set to +%TRUE. +If you set up anything at the time you take the grab that needs to be +cleaned up when the grab ends, you should handle the #GdkEventGrabBroken +events that are emitted when the grab ends unvoluntarily. + + %GDK_GRAB_SUCCESS if the grab was successful. + + + + + the #GdkWindow which will own the grab (the grab window) + + + + specifies the grab ownership. + + + + if %FALSE then all device events are reported with respect to %TRUE then pointer events for this application are reported as normal, but pointer events outside this application are reported with respect to @window and only if selected by + + + + specifies the event mask, which is used in accordance with + + + + the cursor to display while the grab is active if the device is a pointer. If this is %NULL then the normal cursors are used for elsewhere. + + + + the timestamp of the event which led to this pointer grab. This usually comes from the #GdkEvent struct, though %GDK_CURRENT_TIME can be used if the time isn't known. + + + + + + Returns a #GList of #GdkAtom<!-- -->s, containing the labels for +the axes that @device currently has. +A #GList of #GdkAtom<!-- -->s, free with g_list_free(). + + + + + + + + Specifies how an axis of a device is used. + + + + + + the index of the axis + + + + specifies how the axis is used + + + + + + Specifies the X key event to generate when a macro button of a device +is pressed. + + + + + + the index of the macro button to set + + + + the keyval to generate + + + + the modifiers to set + + + + + + Sets a the mode of an input device. The mode controls if the +device is active and whether the device's range is mapped to the +entire screen or to a single window. + + %TRUE if the mode was successfully changed. + + + + + the input mode. + + + + + + Sets the source type for an input device. + + + + + + the source type. + + + + + + Release any grab on @device. + + + + + + a timestap (e.g. %GDK_CURRENT_TIME). + + + + + + Associated pointer or keyboard with this device, if any. Devices of type #GDK_DEVICE_TYPE_MASTER +always come in keyboard/pointer pairs. Other device types will have a %NULL associated device. + + + + The #GdkDeviceManager the #GdkDevice pertains to. + + + + The #GdkDisplay the #GdkDevice pertains to. + + + + Whether the device is represented by a cursor on the screen. Devices of type +%GDK_DEVICE_TYPE_MASTER will have %TRUE here. + + + + Input mode for the device. + + + + Source type for the device. + + + + Number of axes in the device. + + + + The device name. + + + + Device role in the device manager. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The <structname>GdkDeviceAxis</structname> structure contains information +about the range and mapping of a device axis. + + + + + + + + + + + + The <structname>GdkDeviceKey</structname> structure contains information +about the mapping of one device macro button onto a normal X key event. + + + + + + + + + + Returns the client pointer, that is, the master pointer that acts as the core pointer +for this application. In X11, window managers may change this depending on the interaction +pattern under the presence of several pointers. +You should use this function sheldomly, only in code that isn't triggered by a #GdkEvent +and there aren't other means to get a meaningful #GdkDevice to operate on. + + The client pointer. + + + + + Returns the list of devices of type @type currently attached to +#GdkDevice<!-- -->s. The returned list must be +freed with g_list_free (). The list elements are owned by +GTK+ and must not be freed or unreffed. + + a list of + + + + + + + device type to get. + + + + + + Returns the client pointer, that is, the master pointer that acts as the core pointer +for this application. In X11, window managers may change this depending on the interaction +pattern under the presence of several pointers. +You should use this function sheldomly, only in code that isn't triggered by a #GdkEvent +and there aren't other means to get a meaningful #GdkDevice to operate on. + + The client pointer. + + + + + Gets the #GdkDisplay associated to @device_manager. +associated to, or #NULL. + + the #GdkDisplay to which @device_manager is + + + + + Returns the list of devices of type @type currently attached to +#GdkDevice<!-- -->s. The returned list must be +freed with g_list_free (). The list elements are owned by +GTK+ and must not be freed or unreffed. + + a list of + + + + + + + device type to get. + + + + + + + + + + + + + + + The ::device-added signal is emitted either when a new master +pointer is created, or when a slave (Hardware) input device +is plugged in. + + + + + + the newly added #GdkDevice. + + + + + + The ::device-changed signal is emitted either when some +#GdkDevice has changed the number of either axes or keys. +For example In X this will normally happen when the slave +device routing events through the master device changes, +in that case the master device will change to reflect the +new slave device axes and keys. + + + + + + the #GdkDevice that changed. + + + + + + The ::device-removed signal is emitted either when a master +pointer is removed, or when a slave (Hardware) input device +is unplugged. + + + + + + the just removed #GdkDevice. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + a list of + + + + + + + + + + device type to get. + + + + + + + + + The client pointer. + + + + + + + + + + + + + + + + Indicates the device type. See <link linkend="GdkDeviceManager.description">above</link> +for more information about the meaning of these device types. + + + + + + + Gets the default #GdkDisplay. This is a convenience +function for +<literal>gdk_display_manager_get_default_display (gdk_display_manager_get ())</literal>. +display. + + a #GdkDisplay, or %NULL if there is no default + + + + + Opens a display. + + a #GdkDisplay, or %NULL if the display could not be opened. + + + + + the name of the display to open + + + + + + Opens the default display specified by command line arguments or +environment variables, sets it as the default display, and returns +it. gdk_parse_args must have been called first. If the default +display has previously been set, simply returns that. An internal +function that should not be used by applications. +otherwise %NULL. + + the default display, if it could be opened, + + + + + Get the default #GdkScreen for @display. + + the default #GdkScreen object for @display + + + + + + + + + + Gets the number of screen managed by the @display. + + number of screens. + + + + + Returns a screen object for one of the screens of the display. + + the #GdkScreen object + + + + + the screen number + + + + + + Adds a filter to be called when X ClientMessage events are received. +See gdk_window_add_filter() if you are interested in filtering other +types of events. + + + + + + the type of ClientMessage events to receive. This will be checked against the @message_type field of the XClientMessage event struct. + + + + the function to call to process the event. + + + + user data to pass to @func. + + + + + + Emits a short beep on @display + + + + + + Closes the connection to the windowing system for the given display, +and cleans up associated resources. + + + + + + Returns %TRUE if there is an ongoing grab on @device for @display. + + %TRUE if there is a grab in effect for @device. + + + + + a #GdkDevice + + + + + + Flushes any requests queued for the windowing system; this happens automatically +when the main loop blocks waiting for new events, but if your application +is drawing without returning control to the main loop, you may need +to call this function explicitely. A common case where this function +needs to be called is when an application is executing drawing commands +from a thread other than the thread where the main loop is running. +This is most useful for X11. On windowing systems where requests are +handled synchronously, this function will do nothing. + + + + + + Returns the core pointer device for the given display +display and should not be freed. +gdk_event_get_device() if a #GdkEvent with device +information is available. + + the core pointer device; this is owned by the + + + + + Returns the default size to use for cursors on @display. + + the default cursor size. + + + + + Returns the default group leader window for all toplevel windows +on @display. This window is implicitly created by GDK. +See gdk_window_set_group(). + + The default group leader window for @display + + + + + Get the default #GdkScreen for @display. + + the default #GdkScreen object for @display + + + + + Returns the #GdkDeviceManager associated to @display. +owned by GDK and must not be freed or unreferenced. + + A #GdkDeviceManager, or %NULL. This memory is + + + + + Gets the current location and state of @device for a given display. + + + + + + device to query status to. + + + + location to store the #GdkScreen the @device is on, or %NULL. + + + + location to store root window X coordinate of @device, or %NULL. + + + + location to store root window Y coordinate of @device, or %NULL. + + + + location to store current modifier mask for @device, or %NULL. + + + + + + Gets the next #GdkEvent to be processed for @display, fetching events from the +windowing system if necessary. +are pending. The returned #GdkEvent should be freed with gdk_event_free(). + + the next #GdkEvent to be processed, or %NULL if no events + + + + + Gets the maximal size to use for cursors on @display. + + + + + + the return location for the maximal cursor width + + + + the return location for the maximal cursor height + + + + + + Gets the number of screen managed by the @display. + + number of screens. + + + + + Gets the name of the display. +by GDK and should not be modified or freed. + + a string representing the display name. This string is owned + + + + + Gets the current location of the pointer and the current modifier +mask for a given display. + + + + + + location to store the screen that the cursor is on, or %NULL. + + + + location to store root window X coordinate of pointer, or %NULL. + + + + location to store root window Y coordinate of pointer, or %NULL. + + + + location to store current modifier mask, or %NULL + + + + + + Returns a screen object for one of the screens of the display. + + the #GdkScreen object + + + + + the screen number + + + + + + Obtains the window underneath @device, returning the location of the device in @win_x and @win_y. Returns +%NULL if the window tree under @device is not known to GDK (for example, belongs to another application). + + the #GdkWindow under the device position, or %NULL. + + + + + #GdkDevice to query info to. + + + + return location for the X coordinate of the device location, relative to the window origin, or %NULL. + + + + return location for the Y coordinate of the device location, relative to the window origin, or %NULL. + + + + + + Obtains the window underneath the mouse pointer, returning the location +of the pointer in that window in @win_x, @win_y for @screen. Returns %NULL +if the window under the mouse pointer is not known to GDK (for example, +belongs to another application). + + the window under the mouse pointer, or %NULL + + + + + return location for x coordinate of the pointer location relative to the window origin, or %NULL + + + + return location for y coordinate of the pointer location relative + + + + + + Finds out if the display has been closed. + + %TRUE if the display is closed. + + + + + Release any keyboard grab +instead. + + + + + + a timestap (e.g #GDK_CURRENT_TIME). + + + + + + Returns the list of available input devices attached to @display. +The list is statically allocated and should not be freed. +a list of #GdkDevice + + + + + + + + Gets a copy of the first #GdkEvent in the @display's event queue, without +removing the event from the queue. (Note that this function will +not get more events from the windowing system. It only checks the events +that have already been moved to the GDK event queue.) +if no events are in the queue. The returned #GdkEvent should be freed with +gdk_event_free(). + + a copy of the first #GdkEvent on the event queue, or %NULL + + + + + Test if the pointer is grabbed. + + %TRUE if an active X pointer grab is in effect + + + + + Release any pointer grab. +instead. + + + + + + a timestap (e.g. %GDK_CURRENT_TIME). + + + + + + Appends a copy of the given event onto the front of the event +queue for @display. + + + + + + a #GdkEvent. + + + + + + Request #GdkEventOwnerChange events for ownership changes +of the selection named by the given atom. +be sent. + + whether #GdkEventOwnerChange events will + + + + + the #GdkAtom naming the selection for which ownership change notification is requested + + + + + + This function allows for hooking into the operation of getting the current location of any +#GdkDevice on a particular #GdkDisplay. This is only useful for such low-level tools as +an event recorder. Applications should never have any reason to use this facility. + + The previous device hook table. + + + + + a table of pointers to functions for getting quantities related to all devices position, or %NULL to restore the default table. + + + + + + Sets the double click distance (two clicks within this distance +count as a double click and result in a #GDK_2BUTTON_PRESS event). +See also gdk_display_set_double_click_time(). +Applications should <emphasis>not</emphasis> set this, it is a global +user-configured setting. + + + + + + distance in pixels + + + + + + Sets the double click time (two clicks within this time interval +count as a double click and result in a #GDK_2BUTTON_PRESS event). +Applications should <emphasis>not</emphasis> set this, it is a global +user-configured setting. + + + + + + double click time in milliseconds (thousandths of a second) + + + + + + This function allows for hooking into the operation +of getting the current location of the pointer on a particular +display. This is only useful for such low-level tools as an +event recorder. Applications should never have any +reason to use this facility. + + the previous pointer hook table + + + + + a table of pointers to functions for getting quantities related to the current pointer position, or %NULL to restore the default table. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns %TRUE if gdk_window_set_composited() can be used +to redirect drawing on the window using compositing. +Currently this only works on X11 with XComposite and +XDamage extensions available. + + %TRUE if windows may be composited. + + + + + Returns %TRUE if cursors can use an 8bit alpha channel +on @display. Otherwise, cursors are restricted to bilevel +alpha (i.e. a mask). + + whether cursors can have alpha channels. + + + + + Returns %TRUE if multicolored cursors are supported +on @display. Otherwise, cursors have only a forground +and a background color. + + whether cursors can have multiple colors. + + + + + Returns %TRUE if gdk_window_input_shape_combine_mask() can +be used to modify the input shape of windows on @display. + + %TRUE if windows with modified input shape are supported + + + + + Returns whether #GdkEventOwnerChange events will be +sent when the owner of a selection changes. +be sent. + + whether #GdkEventOwnerChange events will + + + + + Returns %TRUE if gdk_window_shape_combine_mask() can +be used to create shaped windows on @display. + + %TRUE if shaped windows are supported + + + + + Flushes any requests queued for the windowing system and waits until all +requests have been handled. This is often used for making sure that the +display is synchronized with the current state of the program. Calling +gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors +generated from earlier requests are handled before the error trap is +removed. +This is most useful for X11. On windowing systems where requests are +handled synchronously, this function will do nothing. + + + + + + Warps @device in @display to the point @x,@y on +the screen @screen, unless the device is confined +to a window by a grab, in which case it will be moved +as far as allowed by the grab. Warping the pointer +creates events as if the user had moved the mouse +instantaneously to the destination. +Note that the pointer should normally be under the +control of the user. This function was added to cover +some rare use cases like keyboard navigation support +for the color picker in the #GtkColorSelectionDialog. + + + + + + a #GdkDevice. + + + + the screen of @display to warp @device to. + + + + the X coordinate of the destination. + + + + the Y coordinate of the destination. + + + + + + Warps the pointer of @display to the point @x,@y on +the screen @screen, unless the pointer is confined +to a window by a grab, in which case it will be moved +as far as allowed by the grab. Warping the pointer +creates events as if the user had moved the mouse +instantaneously to the destination. +Note that the pointer should normally be under the +control of the user. This function was added to cover +some rare use cases like keyboard navigation support +for the color picker in the #GtkColorSelectionDialog. + + + + + + the screen of @display to warp the pointer to + + + + the x coordinate of the destination + + + + the y coordinate of the destination + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The ::closed signal is emitted when the connection to the windowing +system for @display is closed. + + + + + + %TRUE if the display was closed due to an error + + + + + + The ::opened signal is emitted when the connection to the windowing +system for @display is opened. + + + + + + + + + + + + + + + + + + + + + + + + + number of screens. + + + + + + + + + + + + + the #GdkScreen object + + + + + + + + the screen number + + + + + + + + + the default #GdkScreen object for @display + + + + + + + + + + + + + + + + + + + + + + + + + + + A table of pointers to functions for getting quantities related to +the current device position. Each #GdkDisplay has a table of this type, +which can be set using gdk_display_set_device_hooks(). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the singleton #GdkDisplayManager object. +gdk_init(), or gdk_init_check() must have been called first. + + The global #GdkDisplayManager singleton; gdk_parse_pargs(), + + + + + Gets the default #GdkDisplay. +display. + + a #GdkDisplay, or %NULL if there is no default + + + + + List all currently open displays. +#GSList of #GdkDisplay objects. Free this list with g_slist_free() when you +are done with it. + + a newly allocated + + + + + + + Sets @display as the default display. + + + + + + a #GdkDisplay + + + + + + + + + The ::display_opened signal is emitted when a display is opened. + + + + + + the opened display + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Used in #GdkDragContext to indicate what the destination +should do with the dropped data. + + + + + + + + + + Creates a new #GdkDragContext. + + the newly created #GdkDragContext. + + + + + Determines the bitmask of actions proposed by the source if +gdk_drag_context_suggested_action() returns GDK_ACTION_ASK. + + the #GdkDragAction flags + + + + + Returns the #GdkDevice associated to the drag context. + + The #GdkDevice associated to @context. + + + + + Determines the action chosen by the drag destination. + + a #GdkDragAction value + + + + + Returns the #GdkWindow where the DND operation started. + + a #GdkWindow + + + + + Determines the suggested drag action of the context. + + a #GdkDragAction value + + + + + Retrieves the list of targets of the context. + + a #GList of targets + + + + + + + Associates a #GdkDevice to @context, so all Drag and Drop events +for @context are emitted as if they came from this device. + + + + + + a #GdkDevice + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Used in #GdkDragContext to indicate the protocol according to +which DND is done. + + + + + + + + + + + + + + + + + + + + + + + + Computes the region of a drawable that potentially can be written +to by drawing primitives. This region will not take into account +the clip region for the GC, and may also not take into account +other factors such as if the window is obscured by other windows, +but no area outside of this region will be affected by drawing +primitives. +when you are done. + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + Gets the colormap for @drawable, if one is set; returns +%NULL otherwise. + + the colormap, or %NULL + + + + + Obtains the bit depth of the drawable, that is, the number of bits +that make up a pixel in the drawable's visual. Examples are 8 bits +per pixel, 24 bits per pixel, etc. + + number of bits per pixel + + + + + Gets the #GdkScreen associated with a #GdkDrawable. + + the #GdkScreen associated with @drawable + + + + + Fills *@width and *@height with the size of @drawable. +On the X11 platform, if @drawable is a #GdkWindow, the returned +size is the size reported in the most-recently-processed configure +event, rather than the current size on the X server. + + + + + + location to store drawable's width, or %NULL + + + + location to store drawable's height, or %NULL + + + + + + + + + + + Computes the region of a drawable that is potentially visible. +This does not necessarily take into account if the window is +obscured by other windows, but no area outside of this region +is visible. +when you are done. + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + Gets the #GdkVisual describing the pixel format of @drawable. + + a #GdkVisual + + + + + + + + + + + + + + + + + + + + Sets the colormap associated with @drawable. Normally this will +happen automatically when the drawable is created; you only need to +use this function if the drawable-creating function did not have a +way to determine the colormap, and you then use drawable operations +that require a colormap. The colormap for all drawables and +graphics contexts you intend to use together should match. + + + + + + + + + + + Computes the region of a drawable that potentially can be written +to by drawing primitives. This region will not take into account +the clip region for the GC, and may also not take into account +other factors such as if the window is obscured by other windows, +but no area outside of this region will be affected by drawing +primitives. +when you are done. + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + Gets the colormap for @drawable, if one is set; returns +%NULL otherwise. + + the colormap, or %NULL + + + + + Obtains the bit depth of the drawable, that is, the number of bits +that make up a pixel in the drawable's visual. Examples are 8 bits +per pixel, 24 bits per pixel, etc. + + number of bits per pixel + + + + + Gets the #GdkDisplay associated with a #GdkDrawable. + + the #GdkDisplay associated with @drawable + + + + + Gets the #GdkScreen associated with a #GdkDrawable. + + the #GdkScreen associated with @drawable + + + + + Fills *@width and *@height with the size of @drawable. +On the X11 platform, if @drawable is a #GdkWindow, the returned +size is the size reported in the most-recently-processed configure +event, rather than the current size on the X server. + + + + + + location to store drawable's width, or %NULL + + + + location to store drawable's height, or %NULL + + + + + + Computes the region of a drawable that is potentially visible. +This does not necessarily take into account if the window is +obscured by other windows, but no area outside of this region +is visible. +when you are done. + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + Gets the #GdkVisual describing the pixel format of @drawable. + + a #GdkVisual + + + + + Sets the colormap associated with @drawable. Normally this will +happen automatically when the drawable is created; you only need to +use this function if the drawable-creating function did not have a +way to determine the colormap, and you then use drawable operations +that require a colormap. The colormap for all drawables and +graphics contexts you intend to use together should match. + + + + + + a #GdkColormap + + + + + + + + + + + + + + + + number of bits per pixel + + + + + + + + + + + + + + + + + + + + location to store drawable's width, or %NULL + + + + location to store drawable's height, or %NULL + + + + + + + + + + + + + + + + + + + + + + + + the colormap, or %NULL + + + + + + + + + + + + + a #GdkVisual + + + + + + + + + + + + + the #GdkScreen associated with @drawable + + + + + + + + + + + + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + + + + + + + + + a #cairo_region_t. This must be freed with cairo_region_destroy() + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Creates a new event of the given type. All fields are set to 0. +should be freed with gdk_event_free(). + + a newly-allocated #GdkEvent. The returned #GdkEvent + + + + + a #GdkEventType + + + + + + If both events contain X/Y information, this function will return %TRUE +and return in @angle the relative angle from @event1 to @event2. The rotation +direction for positive angles is from the positive X axis towards the positive +Y axis. + + %TRUE if the angle could be calculated. + + + + + second #GdkEvent + + + + return location for the relative angle between both events + + + + + + If both events contain X/Y information, the center of both coordinates +will be returned in @x and @y. + + %TRUE if the center could be calculated. + + + + + second #GdkEvent + + + + return location for the X coordinate of the center + + + + return location for the Y coordinate of the center + + + + + + If both events have X/Y information, the distance between both coordinates +(as in a straight line going from @event1 to @event2) will be returned. + + %TRUE if the distance could be calculated. + + + + + second #GdkEvent + + + + return location for the distance + + + + + + Copies a #GdkEvent, copying or incrementing the reference count of the +resources associated with it (e.g. #GdkWindow's and strings). +gdk_event_free(). + + a copy of @event. The returned #GdkEvent should be freed with + + + + + Frees a #GdkEvent, freeing or decrementing any resources associated with it. +Note that this function should only be called with events returned from +functions such as gdk_event_peek(), gdk_event_get(), gdk_event_copy() +and gdk_event_new(). + + + + + + Extract the axis value for a particular axis use from +an event structure. + + %TRUE if the specified axis was found, otherwise %FALSE + + + + + the axis use to look for + + + + location to store the value found + + + + + + Extract the event window relative x/y coordinates from an event. + + %TRUE if the event delivered event window coordinates + + + + + location to put event window x coordinate + + + + location to put event window y coordinate + + + + + + If the event contains a "device" field, this function will return +it, else it will return %NULL. + + a #GdkDevice, or %NULL. + + + + + Extract the root window relative x/y coordinates from an event. + + %TRUE if the event delivered root window coordinates + + + + + location to put root window x coordinate + + + + location to put root window y coordinate + + + + + + Returns the screen for the event. The screen is +typically the screen for <literal>event->any.window</literal>, but +for events such as mouse events, it is the screen +where the pointer was when the event occurs - +that is, the screen which has the root window +to which <literal>event->motion.x_root</literal> and +<literal>event->motion.y_root</literal> are relative. + + the screen for the event + + + + + If the event contains a "state" field, puts that field in @state. Otherwise +stores an empty state (0). Returns %TRUE if there was a state field +in the event. @event may be %NULL, in which case it's treated +as if the event had no state field. + + %TRUE if there was a state field in the event + + + + + return location for state + + + + + + Returns the time stamp from @event, if there is one; otherwise +returns #GDK_CURRENT_TIME. If @event is %NULL, returns #GDK_CURRENT_TIME. + + time stamp field from @event + + + + + Appends a copy of the given event onto the front of the event +queue for event->any.window's display, or the default event +queue if event->any.window is %NULL. See gdk_display_put_event(). + + + + + + Sends an X ClientMessage event to a given window (which must be +on the default #GdkDisplay.) +This could be used for communicating between different applications, +though the amount of data is limited to 20 bytes. + + non-zero on success. + + + + + the window to send the X ClientMessage event to. + + + + + + Sends an X ClientMessage event to all toplevel windows on the default +#GdkScreen. +Toplevel windows are determined by checking for the WM_STATE property, as +described in the Inter-Client Communication Conventions Manual (ICCCM). +If no windows are found with the WM_STATE property set, the message is sent +to all children of the root window. + + + + + + Sets the device for @event to @device. The event must +have been allocated by GTK+, for instance, by +gdk_event_copy(). + + + + + + a #GdkDevice + + + + + + Sets the screen for @event to @screen. The event must +have been allocated by GTK+, for instance, by +gdk_event_copy(). + + + + + + a #GdkScreen + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + An enumeration used to specify which extension events +are desired for a particular widget. + + + + + + Specifies the type of function used to filter native events before they are +converted to GDK events. +When a filter is called, @event is unpopulated, except for +<literal>event->window</literal>. The filter may translate the native +event to a GDK event and store the result in @event, or handle it without +translation. If the filter translates the event and processing should +continue, it should return %GDK_FILTER_TRANSLATE. + + a #GdkFilterReturn value. + + + + + the native event to filter. + + + + the GDK event to which the X event will be translated. + + + + user data set when the filter was installed. + + + + + + Specifies the result of applying a #GdkFilterFunc to a native event. + + + + + + The #GdkGeometry struct gives the window manager information about +a window's geometry constraints. Normally you would set these on +the GTK+ level using gtk_window_set_geometry_hints(). #GtkWindow +then sets the hints on the #GdkWindow it creates. +gdk_window_set_geometry_hints() expects the hints to be fully valid already +and simply passes them to the window manager; in contrast, +gtk_window_set_geometry_hints() performs some interpretation. For example, +#GtkWindow will apply the hints to the geometry widget instead of the +toplevel window, if you set a geometry widget. Also, the +#GtkWindow will substitute the size request of the window or geometry widget. +If the minimum size hint is not provided, #GtkWindow will use its requisition +as the minimum size. If the minimum size is provided and a geometry widget is +set, #GtkWindow will take the minimum size as the minimum size of the +geometry widget rather than the entire window. The base size is treated +similarly. +The canonical use-case for gtk_window_set_geometry_hints() is to get a +terminal widget to resize properly. Here, the terminal text area should be +the geometry widget; #GtkWindow will then automatically set the base size to +the size of other widgets in the terminal window, such as the menubar and +scrollbar. Then, the @width_inc and @height_inc fields should be set to the +size of one character in the terminal. Finally, the base size should be set +to the size of one character. The net effect is that the minimum size of the +terminal will have a 1x1 character terminal area, and only terminal sizes on +the "character grid" will be allowed. +Here's an example of how the terminal example would be implemented, assuming +a terminal area widget called "terminal" and a toplevel window "toplevel": +<informalexample><programlisting><![CDATA[ +GdkGeometry hints; +hints.base_width = terminal->char_width; +hints.base_height = terminal->char_height; +hints.min_width = terminal->char_width; +hints.min_height = terminal->char_height; +hints.width_inc = terminal->char_width; +hints.height_inc = terminal->char_height; +gtk_window_set_geometry_hints (GTK_WINDOW (toplevel), +GTK_WIDGET (terminal), +&hints, +GDK_HINT_RESIZE_INC | +GDK_HINT_MIN_SIZE | +GDK_HINT_BASE_SIZE); +]]></programlisting></informalexample> +The other useful fields are the @min_aspect and @max_aspect fields; these +contain a width/height ratio as a floating point number. If a geometry widget +is set, the aspect applies to the geometry widget rather than the entire +window. The most common use of these hints is probably to set @min_aspect and +aspect ratio. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Defines how device grabs interact with other devices. + + + + + + + + + + + + + Defines the reference point of a window and the meaning of coordinates +passed to gtk_window_move(). See gtk_window_move() and the "implementation +notes" section of the +<ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended +Window Manager Hints</ulink> specification for more details. + + + + + + + + + + + + + An enumeration that describes the mode of an input device. + + + + + + An enumeration describing the type of an input device in general terms. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Adds virtual modifiers (i.e. Super, Hyper and Meta) which correspond +to the real modifiers (i.e Mod2, Mod3, ...) in @modifiers. +are set in @state to their non-virtual counterparts (i.e. Mod2, +Mod3,...) and set the corresponding bits in @state. +GDK already does this before delivering key events, but for +compatibility reasons, it only sets the first virtual modifier +it finds, whereas this function sets all matching virtual modifiers. +This function is useful when matching key events against +accelerators. + + + + + + pointer to the modifier mask to change + + + + + + Returns whether the Caps Lock modifer is locked. + + %TRUE if Caps Lock is on + + + + + + + + + + Returns the keyvals bound to @hardware_keycode. +The Nth #GdkKeymapKey in @keys is bound to the Nth +keyval in @keyvals. Free the returned arrays with g_free(). +When a keycode is pressed by the user, the keyval from +this list of entries is selected by considering the effective +keyboard group and level. See gdk_keymap_translate_keyboard_state(). + + %TRUE if there were any entries + + + + + a keycode + + + + return location for array of #GdkKeymapKey, or %NULL + + + + return location for array of keyvals, or %NULL + + + + length of @keys and @keyvals + + + + + + Obtains a list of keycode/group/level combinations that will +generate @keyval. Groups and levels are two kinds of keyboard mode; +in general, the level determines whether the top or bottom symbol +on a key is used, and the group determines whether the left or +right symbol is used. On US keyboards, the shift key changes the +keyboard level, and there are no groups. A group switch key might +convert a keyboard between Hebrew to English modes, for example. +#GdkEventKey contains a %group field that indicates the active +keyboard group. The level is computed from the modifier mask. +The returned array should be freed +with g_free(). + + %TRUE if keys were found and returned + + + + + a keyval, such as %GDK_a, %GDK_Up, %GDK_Return, etc. + + + + return location for an array of #GdkKeymapKey + + + + return location for number of elements in returned array + + + + + + Returns whether the Num Lock modifer is locked. + + %TRUE if Num Lock is on + + + + + + + + + + Looks up the keyval mapped to a keycode/group/level triplet. +If no keyval is bound to @key, returns 0. For normal user input, +you want to use gdk_keymap_translate_keyboard_state() instead of +this function, since the effective group/level may not be +the same as the current keyboard state. + + a keyval, or 0 if none was mapped to the given @key + + + + + a #GdkKeymapKey with keycode, group, and level initialized + + + + + + Maps the virtual modifiers (i.e. Super, Hyper and Meta) which +are set in @state to their non-virtual counterparts (i.e. Mod2, +Mod3,...) and set the corresponding bits in @state. +This function is useful when matching key events against +accelerators. +same non-virtual modifier. Note that %FALSE is also returned +if a virtual modifier is mapped to a non-virtual modifier that +was already set in @state. + + %TRUE if no virtual modifiers were mapped to the + + + + + pointer to the modifier state to map + + + + + + Translates the contents of a #GdkEventKey into a keyval, effective +group, and level. Modifiers that affected the translation and +are thus unavailable for application use are returned in +groups and levels. The @effective_group is the group that was +actually used for the translation; some keys such as Enter are not +affected by the active keyboard group. The @level is derived from +keyval, so this function isn't as useful as you might think. +<note><para> +from @state when comparing this key press to a hot key. For +instance, on a US keyboard, the <literal>plus</literal> +symbol is shifted, so when comparing a key press to a +<literal>&lt;Control&gt;plus</literal> accelerator &lt;Shift&gt; should +be masked out. +</para> +<informalexample><programlisting> +&sol;* We want to ignore irrelevant modifiers like ScrollLock *&sol; +&num;define ALL_ACCELS_MASK (GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_MOD1_MASK) +gdk_keymap_translate_keyboard_state (keymap, event->hardware_keycode, +event->state, event->group, +&amp;keyval, NULL, NULL, &amp;consumed); +if (keyval == GDK_PLUS && +(event->state &amp; ~consumed &amp; ALL_ACCELS_MASK) == GDK_CONTROL_MASK) +&sol;* Control was pressed *&sol; +</programlisting></informalexample> +<para> +An older interpretation @consumed_modifiers was that it contained +all modifiers that might affect the translation of the key; +this allowed accelerators to be stored with irrelevant consumed +modifiers, by doing:</para> +<informalexample><programlisting> +&sol;* XXX Don't do this XXX *&sol; +if (keyval == accel_keyval && +(event->state &amp; ~consumed &amp; ALL_ACCELS_MASK) == (accel_mods &amp; ~consumed)) +&sol;* Accelerator was pressed *&sol; +</programlisting></informalexample> +<para> +However, this did not work if multi-modifier combinations were +used in the keymap, since, for instance, <literal>&lt;Control&gt;</literal> +would be masked out even if only <literal>&lt;Control&gt;&lt;Alt&gt;</literal> +was used in the keymap. To support this usage as well as well as +possible, all <emphasis>single modifier</emphasis> combinations +that could affect the key for any combination of modifiers will +be returned in @consumed_modifiers; multi-modifier combinations +are returned only when actually found in @state. When you store +accelerators, you should always store them with consumed modifiers +removed. Store <literal>&lt;Control&gt;plus</literal>, +not <literal>&lt;Control&gt;&lt;Shift&gt;plus</literal>, +</para></note> + + %TRUE if there was a keyval bound to the keycode/state/group + + + + + a keycode + + + + a modifier state + + + + active keyboard group + + + + return location for keyval, or %NULL + + + + return location for effective group, or %NULL + + + + return location for level, or %NULL + + + + return location for modifiers that were used to determine the group or level, or %NULL + + + + + + + + + + + + The ::direction-changed signal gets emitted when the direction of +the keymap changes. + + + + + + The ::keys-changed signal is emitted when the mapping represented by + + + + + + The ::state-changed signal is emitted when the state of the +keyboard changes, e.g when Caps Lock is turned on or off. +See gdk_keymap_get_caps_lock_state(). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A set of bit-flags to indicate the state of modifier keys and mouse buttons +in various event types. Typical modifier keys are Shift, Control, Meta, +Super, Hyper, Alt, Compose, Apple, CapsLock or ShiftLock. +Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons. +Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped +to Mod2 - Mod5, and indicates this by setting %GDK_SUPER_MASK, +%GDK_HYPER_MASK or %GDK_META_MASK in the state field of key events. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Wraps a native window for the default display in a #GdkPixmap. +This may fail if the pixmap has been destroyed. +For example in the X backend, a native pixmap handle is an Xlib +<type>XID</type>. +native pixmap or %NULL if the pixmap has been destroyed. + + the newly-created #GdkPixmap wrapper for the + + + + + a native pixmap handle. + + + + + + Wraps a native pixmap in a #GdkPixmap. +This may fail if the pixmap has been destroyed. +For example in the X backend, a native pixmap handle is an Xlib +<type>XID</type>. +native pixmap or %NULL if the pixmap has been destroyed. + + the newly-created #GdkPixmap wrapper for the + + + + + The #GdkDisplay where @anid is located. + + + + a native pixmap handle. + + + + + + Wraps a native pixmap in a #GdkPixmap. +This may fail if the pixmap has been destroyed. +For example in the X backend, a native pixmap handle is an Xlib +<type>XID</type>. +This function is an alternative to gdk_pixmap_foreign_new_for_display() +for cases where the dimensions of the pixmap are known. For the X +backend, this avoids a roundtrip to the server. +native pixmap or %NULL if the pixmap has been destroyed. + + the newly-created #GdkPixmap wrapper for the + + + + + a #GdkScreen + + + + a native pixmap handle + + + + the width of the pixmap identified by @anid + + + + the height of the pixmap identified by @anid + + + + the depth of the pixmap identified by @anid + + + + + + + + + + + + + + + + + + + + + + + + + Looks up the #GdkPixmap that wraps the given native pixmap handle. +For example in the X backend, a native pixmap handle is an Xlib +<type>XID</type>. +or %NULL if there is none. + + the #GdkPixmap wrapper for the native pixmap, + + + + + a native pixmap handle. + + + + + + Looks up the #GdkPixmap that wraps the given native pixmap handle. +For example in the X backend, a native pixmap handle is an Xlib +<type>XID</type>. +or %NULL if there is none. + + the #GdkPixmap wrapper for the native pixmap, + + + + + the #GdkDisplay associated with @anid + + + + a native pixmap handle. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A table of pointers to functions for getting quantities related to +the current pointer position. GDK has one global table of this type, +which can be set using gdk_set_pointer_hooks(). +This is only useful for such low-level tools as an event recorder. +Applications should never have any reason to use this facility + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the default screen for the default display. (See +gdk_display_get_default ()). + + a #GdkScreen, or %NULL if there is no default display. + + + + + Returns the height of the default screen in pixels. + + the height of the default screen in pixels. + + + + + Returns the height of the default screen in millimeters. +Note that on many X servers this value will not be correct. +though it is not always correct. + + the height of the default screen in millimeters, + + + + + Returns the width of the default screen in pixels. + + the width of the default screen in pixels. + + + + + Returns the width of the default screen in millimeters. +Note that on many X servers this value will not be correct. +though it is not always correct. + + the width of the default screen in millimeters, + + + + + On X11, sends an X ClientMessage event to all toplevel windows on +Toplevel windows are determined by checking for the WM_STATE property, +as described in the Inter-Client Communication Conventions Manual (ICCCM). +If no windows are found with the WM_STATE property set, the message is +sent to all children of the root window. +On Windows, broadcasts a message registered with the name +GDK_WIN32_CLIENT_MESSAGE to all top-level windows. The amount of +data is limited to one long, i.e. four bytes. + + + + + + the #GdkEvent. + + + + + + + + + + + Gets the default colormap for @screen. + + the default #GdkColormap. + + + + + Gets the display to which the @screen belongs. + + the display to which @screen belongs + + + + + Gets any options previously set with gdk_screen_set_font_options(). +font options have been set. + + the current font options, or %NULL if no default + + + + + Gets the height of @screen in pixels + + the height of @screen in pixels. + + + + + Returns the height of @screen in millimeters. +Note that on some X servers this value will not be correct. + + the heigth of @screen in millimeters. + + + + + Returns the monitor number in which the point (@x,@y) is located. +a monitor close to (@x,@y) if the point is not in any monitor. + + the monitor number in which the point (@x,@y) lies, or + + + + + the x coordinate in the virtual screen. + + + + the y coordinate in the virtual screen. + + + + + + Returns the number of the monitor in which the largest area of the +bounding rectangle of @window resides. + + the monitor number in which most of @window is located, or if @window does not intersect any monitors, a monitor, close to @window. + + + + + a #GdkWindow + + + + + + Retrieves the #GdkRectangle representing the size and position of +the individual monitor within the entire screen area. +Note that the size of the entire screen area can be retrieved via +gdk_screen_get_width() and gdk_screen_get_height(). + + + + + + the monitor number, between 0 and gdk_screen_get_n_monitors (screen) + + + + a #GdkRectangle to be filled with the monitor geometry + + + + + + Gets the height in millimeters of the specified monitor. + + the height of the monitor, or -1 if not available + + + + + number of the monitor, between 0 and gdk_screen_get_n_monitors (screen) + + + + + + Returns the output name of the specified monitor. +Usually something like VGA, DVI, or TV, not the actual +product name of the display device. +or %NULL if the name cannot be determined + + a newly-allocated string containing the name of the monitor, + + + + + number of the monitor, between 0 and gdk_screen_get_n_monitors (screen) + + + + + + Gets the width in millimeters of the specified monitor, if available. + + the width of the monitor, or -1 if not available + + + + + number of the monitor, between 0 and gdk_screen_get_n_monitors (screen) + + + + + + Returns the number of monitors which @screen consists of. + + number of monitors which @screen consists of + + + + + Gets the index of @screen among the screens in the display +to which it belongs. (See gdk_screen_get_display()) + + the index + + + + + Gets the primary monitor for @screen. The primary monitor +is considered the monitor where the 'main desktop' lives. +While normal application windows typically allow the window +manager to place the windows, specialized desktop applications +such as panels should place themselves on the primary monitor. +If no primary monitor is configured by the user, the return value +will be 0, defaulting to the first monitor. + + An integer index for the primary monitor, or 0 if none is configured. + + + + + Gets the resolution for font handling on the screen; see +gdk_screen_set_resolution() for full details. +has been set. + + the current resolution, or -1 if no resolution + + + + + Gets a colormap to use for creating windows or pixmaps with an +alpha channel. The windowing system on which GTK+ is running +may not support this capability, in which case %NULL will +be returned. Even if a non-%NULL value is returned, its +possible that the window's alpha channel won't be honored +X an appropriate windowing manager and compositing manager +must be running to provide appropriate display. +This functionality is not implemented in the Windows backend. +For setting an overall opacity for a top-level window, see +gdk_window_set_opacity(). +an alpha channel or %NULL if the capability is not available. + + a colormap to use for windows with + + + + + Gets a visual to use for creating windows or pixmaps with an +alpha channel. See the docs for gdk_screen_get_rgba_colormap() +for caveats. +alpha channel or %NULL if the capability is not available. + + a visual to use for windows with an + + + + + Gets the root window of @screen. + + the root window + + + + + Retrieves a desktop-wide setting such as double-click time +for the #GdkScreen @screen. +FIXME needs a list of valid settings here, or a link to +more information. +in @value, %FALSE otherwise. + + %TRUE if the setting existed and a value was stored + + + + + the name of the setting + + + + location to store the value of the setting + + + + + + Gets the system's default colormap for @screen + + the default colormap for @screen. + + + + + Get the system's default visual for @screen. +This is the visual for the root window of the display. +The return value should not be freed. + + the system visual + + + + + Obtains a list of all toplevel windows known to GDK on the screen @screen. +A toplevel window is a child of the root window (see +gdk_get_default_root_window()). +The returned list should be freed with g_list_free(), but +its elements need not be freed. +list of toplevel windows, free with g_list_free() + + + + + + + + Gets the width of @screen in pixels + + the width of @screen in pixels. + + + + + Gets the width of @screen in millimeters. +Note that on some X servers this value will not be correct. + + the width of @screen in millimeters. + + + + + Returns a #GList of #GdkWindow<!-- -->s representing the current +window stack. +On X11, this is done by inspecting the _NET_CLIENT_LIST_STACKING +property on the root window, as described in the <ulink +url="http://www.freedesktop.org/Standards/wm-spec">Extended Window +Manager Hints</ulink>. If the window manager does not support the +_NET_CLIENT_LIST_STACKING hint, this function returns %NULL. +On other platforms, this function may return %NULL, depending on whether +it is implementable on that platform. +The returned list is newly allocated and owns references to the +windows it contains, so it should be freed using g_list_free() and +its windows unrefed using g_object_unref() when no longer needed. +a list of #GdkWindow<!-- -->s for the current window stack, +or %NULL. + + + + + + + + Returns whether windows with an RGBA visual can reasonably +be expected to have their alpha channel drawn correctly on +the screen. +On X11 this function returns whether a compositing manager is +compositing @screen. +expected to have their alpha channels drawn correctly on the screen. + + Whether windows with RGBA visuals can reasonably be + + + + + Lists the available visuals for the specified @screen. +A visual describes a hardware image data format. +For example, a visual might support 24-bit color, or 8-bit color, +and might expect pixels to be in a certain format. +Call g_list_free() on the return value when you're finished with it. +a list of visuals; the list must be freed, but not its contents + + + + + + + + Determines the name to pass to gdk_display_open() to get +a #GdkDisplay with this screen as the default screen. + + a newly allocated string, free with g_free() + + + + + Sets the default @colormap for @screen. + + + + + + a #GdkColormap + + + + + + Sets the default font options for the screen. These +options will be set on any #PangoContext's newly created +with gdk_pango_context_get_for_screen(). Changing the +default set of font options does not affect contexts that +have already been created. + + + + + + a #cairo_font_options_t, or %NULL to unset any previously set default font options. + + + + + + Sets the resolution for font handling on the screen. This is a +scale factor between points specified in a #PangoFontDescription +and cairo units. The default value is 96, meaning that a 10 point +font will be 13 units high. (10 * 96. / 72. = 13.3). + + + + + + the resolution in "dots per inch". (Physical inches aren't actually involved; the terminology is conventional.) + + + + + + + + + + + + + + + + + + + + + + + + The ::composited-changed signal is emitted when the composited +status of the screen changes + + + + + + The ::monitors-changed signal is emitted when the number, size +or position of the monitors attached to the screen change. +Only for X11 and OS X for now. A future implementation for Win32 +may be a possibility. + + + + + + The ::size-changed signal is emitted when the pixel width or +height of a screen changes. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The #GdkTimeCoord structure stores a single event in a motion history. + + + + + + + + + + + + + + + + + Get the visual with the most available colors for the default +GDK screen. The return value should not be freed. + + best visual + + + + + Get the best available depth for the default GDK screen. "Best" +means "largest," i.e. 32 preferred over 24 preferred over 8 bits +per pixel. + + best available depth + + + + + Return the best available visual type for the default GDK screen. + + best visual type + + + + + Combines gdk_visual_get_best_with_depth() and gdk_visual_get_best_with_type(). + + best visual with both @depth and + + + + + a bit depth + + + + a visual type + + + + + + Get the best visual with depth @depth for the default GDK screen. +Color visuals and visuals with mutable colormaps are preferred +over grayscale or fixed-colormap visuals. The return value should not +be freed. %NULL may be returned if no visual supports @depth. + + best visual for the given depth + + + + + a bit depth + + + + + + Get the best visual of the given @visual_type for the default GDK screen. +Visuals with higher color depths are considered better. The return value +should not be freed. %NULL may be returned if no visual has type + + best visual of the given type + + + + + a visual type + + + + + + Get the system's default visual for the default GDK screen. +This is the visual for the root window of the display. +The return value should not be freed. + + system visual + + + + + Returns the number of significant bits per red, green and blue value. + + The number of significant bits per color value for @visual. + + + + + Obtains values that are needed to calculate blue pixel values in TrueColor +and DirectColor. The "mask" is the significant bits within the pixel. +The "shift" is the number of bits left we must shift a primary for it +to be in position (according to the "mask"). Finally, "precision" refers +to how much precision the pixel value contains for a particular primary. + + + + + + A pointer to a #guint32 to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + + + Returns the byte order of this visual. + + A #GdkByteOrder stating the byte order of @visual. + + + + + Returns the size of a colormap for this visual. + + The size of a colormap that is suitable for @visual. + + + + + Returns the bit depth of this visual. + + The bit depth of this visual. + + + + + Obtains values that are needed to calculate green pixel values in TrueColor +and DirectColor. The "mask" is the significant bits within the pixel. +The "shift" is the number of bits left we must shift a primary for it +to be in position (according to the "mask"). Finally, "precision" refers +to how much precision the pixel value contains for a particular primary. + + + + + + A pointer to a #guint32 to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + + + Obtains values that are needed to calculate red pixel values in TrueColor +and DirectColor. The "mask" is the significant bits within the pixel. +The "shift" is the number of bits left we must shift a primary for it +to be in position (according to the "mask"). Finally, "precision" refers +to how much precision the pixel value contains for a particular primary. + + + + + + A pointer to a #guint32 to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + A pointer to a #gint to be filled in, or %NULL. + + + + + + Gets the screen to which this visual belongs + + the screen to which this visual belongs. + + + + + Returns the type of visual this is (PseudoColor, TrueColor, etc). + + A #GdkVisualType stating the type of @visual. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + These are hints originally defined by the Motif toolkit. +The window manager can use them when determining how to decorate +the window. The hint must be set before mapping the window. + + + + + + + + + + These are hints originally defined by the Motif toolkit. The window manager +can use them when determining the functions to offer for the window. The +hint must be set before mapping the window. + + + + + + + + + An opaque structure representing an onscreen drawable. Pointers to structures +of type #GdkPixmap, #GdkBitmap, and #GdkWindow can often be used +interchangeably. The type #GdkDrawable refers generically to any of these +types. + + Adds an event filter to @window, allowing you to intercept events +before they reach GDK. This is a low-level operation and makes it +easy to break GDK and/or GTK+, so you have to know what you're +doing. Pass %NULL for @window to get all events for all windows, +instead of events for a specific window. +See gdk_display_add_client_message_filter() if you are interested +in X ClientMessage events. + + + + + + filter callback + + + + data to pass to filter callback + + + + + + Emits a short beep associated to @window in the appropriate +display, if supported. Otherwise, emits a short beep on +the display just as gdk_display_beep(). + + + + + + Begins a window move operation (for a toplevel window). You might +use this function to implement a "window move grip," for +example. The function works best with window managers that support +the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended +Window Manager Hints</ulink>, but has a fallback implementation for +other window managers. + + + + + + the button being used to drag + + + + root window X coordinate of mouse click that began the drag + + + + root window Y coordinate of mouse click that began the drag + + + + timestamp of mouse click that began the drag + + + + + + A convenience wrapper around gdk_window_begin_paint_region() which +creates a rectangular region for you. See +gdk_window_begin_paint_region() for details. + + + + + + rectangle you intend to draw to + + + + + + Indicates that you are beginning the process of redrawing @region. +A backing store (offscreen buffer) large enough to contain @region +will be created. The backing store will be initialized with the +background color or background pixmap for @window. Then, all +drawing operations performed on @window will be diverted to the +backing store. When you call gdk_window_end_paint(), the backing +store will be copied to @window, making it visible onscreen. Only +the part of @window contained in @region will be modified; that is, +drawing operations are clipped to @region. +The net result of all this is to remove flicker, because the user +sees the finished product appear all at once when you call +gdk_window_end_paint(). If you draw to @window directly without +calling gdk_window_begin_paint_region(), the user may see flicker +as individual drawing operations are performed in sequence. The +clipping and background-initializing features of +gdk_window_begin_paint_region() are conveniences for the +programmer, so you can avoid doing that work yourself. +When using GTK+, the widget system automatically places calls to +gdk_window_begin_paint_region() and gdk_window_end_paint() around +emissions of the expose_event signal. That is, if you're writing an +expose event handler, you can assume that the exposed area in +#GdkEventExpose has already been cleared to the window background, +is already set as the clip region, and already has a backing store. +Therefore in most cases, application code need not call +gdk_window_begin_paint_region(). (You can disable the automatic +calls around expose events on a widget-by-widget basis by calling +gtk_widget_set_double_buffered().) +If you call this function multiple times before calling the +matching gdk_window_end_paint(), the backing stores are pushed onto +a stack. gdk_window_end_paint() copies the topmost backing store +onscreen, subtracts the topmost region from all other regions in +the stack, and pops the stack. All drawing operations affect only +the topmost backing store in the stack. One matching call to +gdk_window_end_paint() is required for each call to +gdk_window_begin_paint_region(). + + + + + + region you intend to draw to + + + + + + Begins a window resize operation (for a toplevel window). +You might use this function to implement a "window resize grip," for +example; in fact #GtkStatusbar uses it. The function works best +with window managers that support the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended Window Manager Hints</ulink>, but has a +fallback implementation for other window managers. + + + + + + the edge or corner from which the drag is started + + + + the button being used to drag + + + + root window X coordinate of mouse click that began the drag + + + + root window Y coordinate of mouse click that began the drag + + + + timestamp of mouse click that began the drag (use gdk_event_get_time()) + + + + + + Clears an entire @window to the background color or background pixmap. + + + + + + Clears an area of @window to the background color or background pixmap. + + + + + + x coordinate of rectangle to clear + + + + y coordinate of rectangle to clear + + + + width of rectangle to clear + + + + height of rectangle to clear + + + + + + Like gdk_window_clear_area(), but also generates an expose event for +the cleared area. +This function has a stupid name because it dates back to the mists +time, pre-GDK-1.0. + + + + + + x coordinate of rectangle to clear + + + + y coordinate of rectangle to clear + + + + width of rectangle to clear + + + + height of rectangle to clear + + + + + + Signal to the window system that the application has finished +handling Configure events it has received. Window Managers can +use this to better synchronize the frame repaint with the +application. GTK+ applications will automatically call this +function when appropriate. +This function can only be called if gdk_window_enable_synchronized_configure() +was called previously. + + + + + + Transforms window coordinates from a parent window to a child +window, where the parent window is the normal parent as returned by +gdk_window_get_parent() for normal windows, and the window's +embedder as returned by gdk_offscreen_window_get_embedder() for +offscreen windows. +For normal windows, calling this function is equivalent to subtracting +the return values of gdk_window_get_position() from the parent coordinates. +For offscreen windows however (which can be arbitrarily transformed), +the coordinates. +You should always use this function when writing generic code that +walks down a window hierarchy. + + + + + + X coordinate in parent's coordinate system + + + + Y coordinate in parent's coordinate system + + + + return location for X coordinate in child's coordinate system + + + + return location for Y coordinate in child's coordinate system + + + + + + Transforms window coordinates from a child window to its parent +window, where the parent window is the normal parent as returned by +gdk_window_get_parent() for normal windows, and the window's +embedder as returned by gdk_offscreen_window_get_embedder() for +offscreen windows. +For normal windows, calling this function is equivalent to adding +the return values of gdk_window_get_position() to the child coordinates. +For offscreen windows however (which can be arbitrarily transformed), +the coordinates. +You should always use this function when writing generic code that +walks up a window hierarchy. + + + + + + X coordinate in child's coordinate system + + + + Y coordinate in child's coordinate system + + + + return location for X coordinate in parent's coordinate system, or %NULL + + + + return location for Y coordinate in parent's coordinate system, or %NULL + + + + + + Create a new surface that is as compatible as possible with the +given @window. For example the new surface will have the same +fallback resolution and font options as @window. Generally, the new +surface will also use the same backend as @window, unless that is +not possible for some reason. The type of the returned surface may +be examined with cairo_surface_get_type(). +Initially the surface contents are all 0 (transparent if contents +have transparency, black otherwise.) +owns the surface and should call cairo_surface_destroy() when done +with it. +This function always returns a valid pointer, but it will return a +pointer to a "nil" surface if @other is already in an error state +or any other error occurs. + + a pointer to the newly allocated surface. The caller + + + + + the content for the new surface + + + + width of the new surface + + + + height of the new surface + + + + + + Attempt to deiconify (unminimize) @window. On X11 the window manager may +choose to ignore the request to deiconify. When using GTK+, +use gtk_window_deiconify() instead of the #GdkWindow variant. Or better yet, +you probably want to use gtk_window_present(), which raises the window, focuses it, +unminimizes it, and puts it on the current desktop. + + + + + + Destroys the window system resources associated with @window and decrements @window's +reference count. The window system resources for all children of @window are also +destroyed, but the children's reference counts are not decremented. +Note that a window will not be destroyed automatically when its reference count +reaches zero. You must call this function yourself before that happens. + + + + + + + + + + + Indicates that the application will cooperate with the window +system in synchronizing the window repaint with the window +manager during resizing operations. After an application calls +this function, it must call gdk_window_configure_finished() every +time it has finished all processing associated with a set of +Configure events. Toplevel GTK+ windows automatically use this +protocol. +On X, calling this function makes @window participate in the +_NET_WM_SYNC_REQUEST window manager protocol. + + + + + + Indicates that the backing store created by the most recent call to +gdk_window_begin_paint_region() should be copied onscreen and +deleted, leaving the next-most-recent backing store or no backing +store at all as the active paint region. See +gdk_window_begin_paint_region() for full details. It is an error to +call this function without a matching +gdk_window_begin_paint_region() first. + + + + + + Tries to ensure that there is a window-system native window for this +GdkWindow. This may fail in some situations, returning %FALSE. +Offscreen window and children of them can never have native windows. +Some backends may not support native child windows. + + %TRUE if the window has a native window, %FALSE otherwise + + + + + Flush all outstanding cached operations on a window, leaving the +window in a state which reflects all that has been drawn before. +Gdk uses multiple kinds of caching to get better performance and +nicer drawing. For instance, during exposes all paints to a window +using double buffered rendering are keep on a pixmap until the last +window has been exposed. It also delays window moves/scrolls until +as long as possible until next update to avoid tearing when moving +windows. +Normally this should be completely invisible to applications, as +we automatically flush the windows when required, but this might +be needed if you for instance mix direct native drawing with +gdk drawing. For Gtk widgets that don't use double buffering this +will be called automatically before sending the expose event. + + + + + + Sets keyboard focus to @window. In most cases, gtk_window_present() +should be used on a #GtkWindow, rather than calling this function. + + + + + + timestamp of the event triggering the window focus + + + + + + Temporarily freezes a window and all its descendants such that it won't +receive expose events. The window will begin receiving expose events +again when gdk_window_thaw_toplevel_updates_libgtk_only() is called. If +gdk_window_freeze_toplevel_updates_libgtk_only() +has been called more than once, +gdk_window_thaw_toplevel_updates_libgtk_only() must be called +an equal number of times to begin processing exposes. +This function is not part of the GDK public API and is only +for use by GTK+. + + + + + + Temporarily freezes a window such that it won't receive expose +events. The window will begin receiving expose events again when +gdk_window_thaw_updates() is called. If gdk_window_freeze_updates() +has been called more than once, gdk_window_thaw_updates() must be called +an equal number of times to begin processing exposes. + + + + + + Moves the window into fullscreen mode. This means the +window covers the entire screen and is above any panels +or task bars. +If the window was already fullscreen, then this function does nothing. +On X11, asks the window manager to put @window in a fullscreen +state, if the window manager supports this operation. Not all +window managers support this, and some deliberately ignore it or +don't have a concept of "fullscreen"; so you can't rely on the +fullscreenification actually happening. But it will happen with +most standard window managers, and GDK makes a best effort to get +it to happen. + + + + + + This function informs GDK that the geometry of an embedded +offscreen window has changed. This is necessary for GDK to keep +track of which offscreen window the pointer is in. + + + + + + Determines whether or not the desktop environment shuld be hinted that +the window does not want to receive input focus. + + whether or not the window should receive input focus. + + + + + Gets the pattern used to clear the background on @window. If @window +does not have its own background and reuses the parent's, %NULL is +returned and you'll have to query it yourself. +parent's background. + + The pattern to use for the background or %NULL to use the + + + + + Gets the list of children of @window known to GDK. +This function only returns children created via GDK, +so for example it's useless when used with the root window; +it only returns windows an application created itself. +The returned list must be freed, but the elements in the +list need not be. +list of child windows inside @window + + + + + + + + Determines whether @window is composited. +See gdk_window_set_composited(). + + %TRUE if the window is composited. + + + + + Retrieves a #GdkCursor pointer for the cursor currently set on the +specified #GdkWindow, or %NULL. If the return value is %NULL then +there is no custom cursor set on the specified window, and it is +using the cursor for its parent window. +by the #GdkWindow and should not be unreferenced directly. Use +gdk_window_set_cursor() to unset the cursor of the window + + a #GdkCursor, or %NULL. The returned object is owned + + + + + Returns the decorations set on the GdkWindow with +gdk_window_set_decorations(). + + %TRUE if the window has decorations set, %FALSE otherwise. + + + + + The window decorations will be written here + + + + + + Retrieves a #GdkCursor pointer for the @device currently set on the +specified #GdkWindow, or %NULL. If the return value is %NULL then +there is no custom cursor set on the specified window, and it is +using the cursor for its parent window. +by the #GdkWindow and should not be unreferenced directly. Use +gdk_window_set_cursor() to unset the cursor of the window + + a #GdkCursor, or %NULL. The returned object is owned + + + + + a #GdkDevice. + + + + + + Returns the event mask for @window corresponding to an specific device. + + device event mask for @window + + + + + a #GdkDevice. + + + + + + Obtains the current device position and modifier state. +The position is given in coordinates relative to the upper left +corner of @window. +gdk_display_get_window_at_device_position()), or %NULL if the +window is not known to GDK. + + The window underneath @device (as with + + + + + #GdkDevice to query to. + + + + return location for the X coordinate of @device, or %NULL. + + + + return location for the Y coordinate of @device, or %NULL. + + + + return location for the modifier mask, or %NULL. + + + + + + Obtains the parent of @window, as known to GDK. Works like +gdk_window_get_parent() for normal windows, but returns the +window's embedder for offscreen windows. + + effective parent of @window + + + + + Gets the toplevel window that's an ancestor of @window. +Works like gdk_window_get_toplevel(), but treats an offscreen window's +embedder as its parent, using gdk_window_get_effective_parent(). + + the effective toplevel window containing @window + + + + + Gets the event mask for @window for all master input devices. See +gdk_window_set_events(). + + event mask for @window + + + + + Determines whether or not the desktop environment should be hinted that the +window does not want to receive input focus when it is mapped. +it is mapped. + + whether or not the window wants to receive input focus when + + + + + Obtains the bounding box of the window, including window manager +titlebar/borders if any. The frame position is given in root window +coordinates. To get the position of the window itself (rather than +the frame) in root window coordinates, use gdk_window_get_origin(). + + + + + + rectangle to fill with bounding box of the window frame + + + + + + Any of the return location arguments to this function may be %NULL, +if you aren't interested in getting the value of that field. +The X and Y coordinates returned are relative to the parent window +of @window, which for toplevels usually means relative to the +window decorations (titlebar, etc.) rather than relative to the +root window (screen-size background window). +On the X11 platform, the geometry is obtained from the X server, +so reflects the latest position of @window; this may be out-of-sync +with the position of @window delivered in the most-recently-processed +#GdkEventConfigure. gdk_window_get_position() in contrast gets the +position from the most recent configure event. +<note> +If @window is not a toplevel, it is <emphasis>much</emphasis> better +to call gdk_window_get_position() and gdk_drawable_get_size() instead, +because it avoids the roundtrip to the X server and because +gdk_drawable_get_size() supports the full 32-bit coordinate space, +whereas gdk_window_get_geometry() is restricted to the 16-bit +coordinates of X11. +</note> + + + + + + return location for X coordinate of window (relative to its parent) + + + + return location for Y coordinate of window (relative to its parent) + + + + return location for width of window + + + + return location for height of window + + + + return location for bit depth of window + + + + + + Returns the group leader window for @window. See gdk_window_set_group(). + + the group leader window for @window + + + + + If you bypass the GDK layer and use windowing system primitives to +draw directly onto a #GdkWindow, then you need to deal with two +system coordinates, and GDK may have redirected drawing to a offscreen +pixmap as the result of a gdk_window_begin_paint_region() calls. +This function allows retrieving the information you need to compensate +for these effects. +This function exposes details of the GDK implementation, and is thus +likely to change in future releases of GDK. + + + + + + location to store the drawable to which drawing should be done. + + + + location to store the X offset between coordinates in @window, and the underlying window system primitive coordinates for *@real_drawable. + + + + location to store the Y offset between coordinates in @window, and the underlying window system primitive coordinates for *@real_drawable. + + + + + + Determines whether or not the window manager is hinted that @window +has modal behaviour. + + whether or not the window has the modal hint set. + + + + + Obtains the position of a window in root window coordinates. +(Compare with gdk_window_get_position() and +gdk_window_get_geometry() which return the position of a window +relative to its parent window.) + + not meaningful, ignore + + + + + return location for X coordinate + + + + return location for Y coordinate + + + + + + Obtains the parent of @window, as known to GDK. Does not query the +X server; thus this returns the parent as passed to gdk_window_new(), +not the actual parent. This should never matter unless you're using +Xlib calls mixed with GDK calls on the X11 platform. It may also +matter for toplevel windows, because the window manager may choose +to reparent them. +Note that you should use gdk_window_get_effective_parent() when +writing generic code that walks up a window hierarchy, because +gdk_window_get_parent() will most likely not do what you expect if +there are offscreen windows in the hierarchy. + + parent of @window + + + + + Obtains the current pointer position and modifier state. +The position is given in coordinates relative to the upper left +corner of @window. +gdk_window_at_pointer()), or %NULL if the window containing the +pointer isn't known to GDK + + the window containing the pointer (as with + + + + + return location for X coordinate of pointer or %NULL to not return the X coordinate + + + + return location for Y coordinate of pointer or %NULL to not return the Y coordinate + + + + return location for modifier mask or %NULL to not return the modifier mask + + + + + + Obtains the position of the window as reported in the +most-recently-processed #GdkEventConfigure. Contrast with +gdk_window_get_geometry() which queries the X server for the +current window position, regardless of which events have been +received or processed. +The position coordinates are relative to the window's parent window. + + + + + + X coordinate of window + + + + Y coordinate of window + + + + + + Obtains the position of a window position in root +window coordinates. This is similar to +gdk_window_get_origin() but allows you go pass +in any position in the window, not just the origin. + + + + + + X coordinate in window + + + + Y coordinate in window + + + + return location for X coordinate + + + + return location for Y coordinate + + + + + + Obtains the top-left corner of the window manager frame in root +window coordinates. + + + + + + return location for X position of window frame + + + + return location for Y position of window frame + + + + + + Gets the bitwise OR of the currently active window state flags, +from the #GdkWindowState enumeration. + + window state bitfield + + + + + Returns %TRUE if the window is aware of the existence of multiple +devices. + + %TRUE if the window handles multidevice features. + + + + + Gets the toplevel window that's an ancestor of @window. +Any window type but %GDK_WINDOW_CHILD is considered a +toplevel window, as is a %GDK_WINDOW_CHILD window that +has a root window as parent. +Note that you should use gdk_window_get_effective_toplevel() when +you want to get to a window's toplevel as seen on screen, because +gdk_window_get_toplevel() will most likely not do what you expect +if there are offscreen windows in the hierarchy. + + the toplevel window containing @window + + + + + This function returns the type hint set for a window. + + The type hint set for @window + + + + + Transfers ownership of the update area from @window to the caller +of the function. That is, after calling this function, @window will +no longer have an invalid/dirty region; the update area is removed +from @window and handed to you. If a window has no update area, +gdk_window_get_update_area() returns %NULL. You are responsible for +calling cairo_region_destroy() on the returned region if it's non-%NULL. + + the update area for @window + + + + + Retrieves the user data for @window, which is normally the widget +that @window belongs to. See gdk_window_set_user_data(). + + + + + + return location for user data + + + + + + Gets the type of the window. See #GdkWindowType. + + type of window + + + + + Checks whether the window has a native window or not. Note that +you can use gdk_window_ensure_native() if a native window is needed. + + %TRUE if the %window has a native window, %FALSE otherwise. + + + + + For toplevel windows, withdraws them, so they will no longer be +known to the window manager; for all windows, unmaps them, so +they won't be displayed. Normally done automatically as +part of gtk_widget_hide(). + + + + + + Asks to iconify (minimize) @window. The window manager may choose +to ignore the request, but normally will honor it. Using +gtk_window_iconify() is preferred, if you have a #GtkWindow widget. +This function only makes sense when @window is a toplevel window. + + + + + + Like gdk_window_shape_combine_mask(), but the shape applies +only to event handling. Mouse events which happen while +the pointer position corresponds to an unset bit in the +mask will be passed on the window below @window. +An input shape is typically used with RGBA windows. +The alpha channel of the window defines which pixels are +invisible and allows for nicely antialiased borders, +and the input shape controls where the window is +"clickable". +On the X11 platform, this requires version 1.1 of the +shape extension. +On the Win32 platform, this functionality is not present and the +function does nothing. + + + + + + shape mask, or %NULL + + + + X position of shape mask with respect to @window + + + + Y position of shape mask with respect to @window + + + + + + Like gdk_window_shape_combine_region(), but the shape applies +only to event handling. Mouse events which happen while +the pointer position corresponds to an unset bit in the +mask will be passed on the window below @window. +An input shape is typically used with RGBA windows. +The alpha channel of the window defines which pixels are +invisible and allows for nicely antialiased borders, +and the input shape controls where the window is +"clickable". +On the X11 platform, this requires version 1.1 of the +shape extension. +On the Win32 platform, this functionality is not present and the +function does nothing. + + + + + + region of window to be non-transparent + + + + X position of @shape_region in @window coordinates + + + + Y position of @shape_region in @window coordinates + + + + + + Adds @region to the update area for @window. The update area is the +region that needs to be redrawn, or "dirty region." The call +gdk_window_process_updates() sends one or more expose events to the +window, which together cover the entire update area. An +application would normally redraw the contents of @window in +response to those expose events. +GDK will call gdk_window_process_all_updates() on your behalf +whenever your program returns to the main loop and becomes idle, so +normally there's no need to do that manually, you just need to +invalidate regions that you know should be redrawn. +The @child_func parameter controls whether the region of +each child window that intersects @region will also be invalidated. +Only children for which @child_func returns TRUE will have the area +invalidated. + + + + + + a #cairo_region_t + + + + function to use to decide if to recurse to a child, %NULL means never recurse. + + + + data passed to @child_func + + + + + + A convenience wrapper around gdk_window_invalidate_region() which +invalidates a rectangular region. See +gdk_window_invalidate_region() for details. + + + + + + rectangle to invalidate or %NULL to invalidate the whole window + + + + whether to also invalidate child windows + + + + + + Adds @region to the update area for @window. The update area is the +region that needs to be redrawn, or "dirty region." The call +gdk_window_process_updates() sends one or more expose events to the +window, which together cover the entire update area. An +application would normally redraw the contents of @window in +response to those expose events. +GDK will call gdk_window_process_all_updates() on your behalf +whenever your program returns to the main loop and becomes idle, so +normally there's no need to do that manually, you just need to +invalidate regions that you know should be redrawn. +The @invalidate_children parameter controls whether the region of +each child window that intersects @region will also be invalidated. +If %FALSE, then the update area for child windows will remain +unaffected. See gdk_window_invalidate_maybe_recurse if you need +fine grained control over which children are invalidated. + + + + + + a #cairo_region_t + + + + %TRUE to also invalidate child windows + + + + + + Check to see if a window is destroyed.. + + %TRUE if the window is destroyed + + + + + Determines whether or not the window is an input only window. + + %TRUE if @window is input only + + + + + Determines whether or not the window is shaped. + + %TRUE if @window is shaped + + + + + Check if the window and all ancestors of the window are +mapped. (This is not necessarily "viewable" in the X sense, since +we only check as far as we have GDK window parents, not to the root +window.) + + %TRUE if the window is viewable + + + + + Checks whether the window has been mapped (with gdk_window_show() or +gdk_window_show_unraised()). + + %TRUE if the window is mapped + + + + + Lowers @window to the bottom of the Z-order (stacking order), so that +other windows with the same parent window appear above @window. +This is true whether or not the other windows are visible. +If @window is a toplevel, the window manager may choose to deny the +request to move the window in the Z-order, gdk_window_lower() only +requests the restack, does not guarantee it. +Note that gdk_window_show() raises the window again, so don't call this +function before gdk_window_show(). (Try gdk_window_show_unraised().) + + + + + + Maximizes the window. If the window was already maximized, then +this function does nothing. +On X11, asks the window manager to maximize @window, if the window +manager supports this operation. Not all window managers support +this, and some deliberately ignore it or don't have a concept of +"maximized"; so you can't rely on the maximization actually +happening. But it will happen with most standard window managers, +and GDK makes a best effort to get it to happen. +On Windows, reliably maximizes the window. + + + + + + Merges the input shape masks for any child windows into the +input shape mask for @window. i.e. the union of all input masks +for @window and its children will become the new input mask +for @window. See gdk_window_input_shape_combine_mask(). +This function is distinct from gdk_window_set_child_input_shapes() +because it includes @window's input shape mask in the set of +shapes to be merged. + + + + + + Merges the shape masks for any child windows into the +shape mask for @window. i.e. the union of all masks +for @window and its children will become the new mask +for @window. See gdk_window_shape_combine_mask(). +This function is distinct from gdk_window_set_child_shapes() +because it includes @window's shape mask in the set of shapes to +be merged. + + + + + + Repositions a window relative to its parent window. +For toplevel windows, window managers may ignore or modify the move; +you should probably use gtk_window_move() on a #GtkWindow widget +anyway, instead of using GDK functions. For child windows, +the move will reliably succeed. +If you're also planning to resize the window, use gdk_window_move_resize() +to both move and resize simultaneously, for a nicer visual effect. + + + + + + X coordinate relative to window's parent + + + + Y coordinate relative to window's parent + + + + + + Move the part of @window indicated by @region by @dy pixels in the Y +direction and @dx pixels in the X direction. The portions of @region +that not covered by the new position of @region are invalidated. +Child windows are not moved. + + + + + + The #cairo_region_t to move + + + + Amount to move in the X direction + + + + Amount to move in the Y direction + + + + + + Equivalent to calling gdk_window_move() and gdk_window_resize(), +except that both operations are performed at once, avoiding strange +visual effects. (i.e. the user may be able to see the window first +move, then resize, if you don't use gdk_window_move_resize().) + + + + + + new X position relative to window's parent + + + + new Y position relative to window's parent + + + + new width + + + + new height + + + + + + Creates a new #GdkWindow using the attributes from +display, @parent must be specified. + + the new #GdkWindow + + + + + attributes of the new window + + + + mask indicating which fields in @attributes are valid + + + + + + Like gdk_window_get_children(), but does not copy the list of +children, so the list does not need to be freed. +a reference to the list of child windows in @window + + + + + + + + Sends one or more expose events to @window. The areas in each +expose event will cover the entire update area for the window (see +gdk_window_invalidate_region() for details). Normally GDK calls +gdk_window_process_all_updates() on your behalf, so there's no +need to call this function unless you want to force expose events +to be delivered immediately and synchronously (vs. the usual +case, where GDK delivers them in an idle handler). Occasionally +this is useful to produce nicer scrolling behavior, for example. + + + + + + whether to also process updates for child windows + + + + + + Raises @window to the top of the Z-order (stacking order), so that +other windows with the same parent window appear below @window. +This is true whether or not the windows are visible. +If @window is a toplevel, the window manager may choose to deny the +request to move the window in the Z-order, gdk_window_raise() only +requests the restack, does not guarantee it. + + + + + + Redirects drawing into @window so that drawing to the +window in the rectangle specified by @src_x, @src_y, +Only drawing between gdk_window_begin_paint_region() or +gdk_window_begin_paint_rect() and gdk_window_end_paint() is +redirected. +Redirection is active until gdk_window_remove_redirection() +is called. + + + + + + a #GdkDrawable + + + + x position in @window + + + + y position in @window + + + + x position in @drawable + + + + y position in @drawable + + + + width of redirection, or -1 to use the width of @window + + + + height of redirection or -1 to use the height of @window + + + + + + Registers a window as a potential drop destination. + + + + + + Remove a filter previously added with gdk_window_add_filter(). + + + + + + previously-added filter function + + + + user data for previously-added filter function + + + + + + Removes any active redirection started by +gdk_window_redirect_to_drawable(). + + + + + + Reparents @window into the given @new_parent. The window being +reparented will be unmapped as a side effect. + + + + + + new parent to move @window into + + + + X location inside the new parent + + + + Y location inside the new parent + + + + + + Resizes @window; for toplevel windows, asks the window manager to resize +the window. The window manager may not allow the resize. When using GTK+, +use gtk_window_resize() instead of this low-level GDK function. +Windows may not be resized below 1x1. +If you're also planning to move the window, use gdk_window_move_resize() +to both move and resize simultaneously, for a nicer visual effect. + + + + + + new width of the window + + + + new height of the window + + + + + + Changes the position of @window in the Z-order (stacking order), so that +it is above @sibling (if @above is %TRUE) or below @sibling (if @above is +%FALSE). +If @sibling is %NULL, then this either raises (if @above is %TRUE) or +lowers the window. +If @window is a toplevel, the window manager may choose to deny the +request to move the window in the Z-order, gdk_window_restack() only +requests the restack, does not guarantee it. + + + + + + a #GdkWindow that is a sibling of @window, or %NULL + + + + a boolean + + + + + + Scroll the contents of @window, both pixels and children, by the +given amount. @window itself does not move. Portions of the window +that the scroll operation brings in from offscreen areas are +invalidated. The invalidated region may be bigger than what would +strictly be necessary. +For X11, a minimum area will be invalidated if the window has no +subwindows, or if the edges of the window's parent do not extend +beyond the edges of the window. In other cases, a multi-step process +is used to scroll the window which may produce temporary visual +artifacts and unnecessary invalidations. + + + + + + Amount to scroll in the X direction + + + + Amount to scroll in the Y direction + + + + + + Setting @accept_focus to %FALSE hints the desktop environment that the +window doesn't want to receive input focus. +On X, it is the responsibility of the window manager to interpret this +hint. ICCCM-compliant window manager usually respect it. + + + + + + %TRUE if the window should receive input focus + + + + + + Sets the background pixmap of @window. May also be used to set a +background of "None" on @window, by setting a background pixmap +of %NULL. +A background pixmap will be tiled, positioning the first tile at +the origin of @window, or if @parent_relative is %TRUE, the tiling +will be done based on the origin of the parent window (useful to +align tiles in a parent with tiles in a child). +A background pixmap of %NULL means that the window will have no +background. A window with no background will never have its +background filled by the windowing system, instead the window will +contain whatever pixels were already in the corresponding area of +the display. +The windowing system will normally fill a window with its background +when the window is obscured then exposed, and when you call +gdk_window_clear(). + + + + + + a #GdkPixmap, or %NULL + + + + whether the tiling origin is at the origin of + + + + + + Sets the background color of @window. (However, when using GTK+, +set the background of a widget with gtk_widget_modify_bg() - if +you're an application - or gtk_style_set_background() - if you're +implementing a custom widget.) +See also gdk_window_set_background_pixmap(). + + + + + + an allocated #GdkColor + + + + + + Sets the input shape mask of @window to the union of input shape masks +for all children of @window, ignoring the input shape mask of @window +itself. Contrast with gdk_window_merge_child_input_shapes() which includes +the input shape mask of @window in the masks to be merged. + + + + + + Sets the shape mask of @window to the union of shape masks +for all children of @window, ignoring the shape mask of @window +itself. Contrast with gdk_window_merge_child_shapes() which includes +the shape mask of @window in the masks to be merged. + + + + + + Sets a #GdkWindow as composited, or unsets it. Composited +windows do not automatically have their contents drawn to +the screen. Drawing is redirected to an offscreen buffer +and an expose event is emitted on the parent of the composited +window. It is the responsibility of the parent's expose handler +to manually merge the off-screen content onto the screen in +whatever way it sees fit. See <xref linkend="composited-window-example"/> +for an example. +It only makes sense for child windows to be composited; see +gdk_window_set_opacity() if you need translucent toplevel +windows. +An additional effect of this call is that the area of this +window is no longer clipped from regions marked for +invalidation on its parent. Draws done on the parent +window are also no longer clipped by the child. +This call is only supported on some systems (currently, +only X11 with new enough Xcomposite and Xdamage extensions). +You must call gdk_display_supports_composite() to check if +setting a window as composited is supported before +attempting to do so. + + + + + + %TRUE to set the window as composited + + + + + + Sets the default mouse pointer for a #GdkWindow. Use gdk_cursor_new_for_display() +or gdk_cursor_new_from_pixmap() to create the cursor. To make the cursor +invisible, use %GDK_BLANK_CURSOR. Passing %NULL for the @cursor argument +to gdk_window_set_cursor() means that @window will use the cursor of its +parent window. Most windows should use this default. + + + + + + a cursor + + + + + + "Decorations" are the features the window manager adds to a toplevel #GdkWindow. +This function sets the traditional Motif window manager hints that tell the +window manager which decorations you would like your window to have. +Usually you should use gtk_window_set_decorated() on a #GtkWindow instead of +using the GDK function directly. +The @decorations argument is the logical OR of the fields in +the #GdkWMDecoration enumeration. If #GDK_DECOR_ALL is included in the +mask, the other bits indicate which decorations should be turned off. +If #GDK_DECOR_ALL is not included, then the other bits indicate +which decorations should be turned on. +Most window managers honor a decorations hint of 0 to disable all decorations, +but very few honor all possible combinations of bits. + + + + + + decoration hint mask + + + + + + Sets a specific #GdkCursor for a given device when it gets inside @window. +Use gdk_cursor_new_for_display() or gdk_cursor_new_from_pixmap() to create +the cursor. To make the cursor invisible, use %GDK_BLANK_CURSOR. Passing +%NULL for the @cursor argument to gdk_window_set_cursor() means that +use this default. + + + + + + a #GdkDevice + + + + a #GdkCursor + + + + + + Sets the event mask for a given device (Normally a floating device, not +attached to any visible pointer) to @window. For example, an event mask +including #GDK_BUTTON_PRESS_MASK means the window should report button +press events. The event mask is the bitwise OR of values from the +#GdkEventMask enumeration. + + + + + + #GdkDevice to enable events for. + + + + event mask for @window + + + + + + The event mask for a window determines which events will be reported +for that window from all master input devices. For example, an event mask +including #GDK_BUTTON_PRESS_MASK means the window should report button +press events. The event mask is the bitwise OR of values from the +#GdkEventMask enumeration. + + + + + + event mask for @window + + + + + + Setting @focus_on_map to %FALSE hints the desktop environment that the +window doesn't want to receive input focus when it is mapped. +focus_on_map should be turned off for windows that aren't triggered +interactively (such as popups from network activity). +On X, it is the responsibility of the window manager to interpret +this hint. Window managers following the freedesktop.org window +manager extension specification should respect it. + + + + + + %TRUE if the window should receive input focus when mapped + + + + + + Sets hints about the window management functions to make available +via buttons on the window frame. +On the X backend, this function sets the traditional Motif window +manager hint for this purpose. However, few window managers do +anything reliable or interesting with this hint. Many ignore it +entirely. +The @functions argument is the logical OR of values from the +#GdkWMFunction enumeration. If the bitmask includes #GDK_FUNC_ALL, +then the other bits indicate which functions to disable; if +it doesn't include #GDK_FUNC_ALL, it indicates which functions to +enable. + + + + + + bitmask of operations to allow on @window + + + + + + Sets the geometry hints for @window. Hints flagged in @geom_mask +are set, hints not flagged in @geom_mask are unset. +To unset all hints, use a @geom_mask of 0 and a @geometry of %NULL. +This function provides hints to the windowing system about +acceptable sizes for a toplevel window. The purpose of +this is to constrain user resizing, but the windowing system +will typically (but is not required to) also constrain the +current size of the window to the provided values and +constrain programatic resizing via gdk_window_resize() or +gdk_window_move_resize(). +Note that on X11, this effect has no effect on windows +of type %GDK_WINDOW_TEMP or windows where override redirect +has been turned on via gdk_window_set_override_redirect() +since these windows are not resizable by the user. +Since you can't count on the windowing system doing the +constraints for programmatic resizes, you should generally +call gdk_window_constrain_size() yourself to determine +appropriate sizes. + + + + + + geometry hints + + + + bitmask indicating fields of @geometry to pay attention to + + + + + + Sets the group leader window for @window. By default, +GDK sets the group leader for all toplevel windows +to a global window implicitly created by GDK. With this function +you can override this default. +The group leader window allows the window manager to distinguish +all windows that belong to a single application. It may for example +allow users to minimize/unminimize all windows belonging to an +application at once. You should only set a non-default group window +if your application pretends to be multiple applications. + + + + + + group leader window, or %NULL to restore the default group leader window + + + + + + Sets the icon of @window as a pixmap or window. If using GTK+, investigate +gtk_window_set_default_icon_list() first, and then gtk_window_set_icon_list() +and gtk_window_set_icon(). If those don't meet your needs, look at +gdk_window_set_icon_list(). Only if all those are too high-level do you +want to fall back to gdk_window_set_icon(). + + + + + + a #GdkWindow to use for the icon, or %NULL to unset + + + + a #GdkPixmap to use as the icon, or %NULL to unset + + + + a 1-bit pixmap (#GdkBitmap) to use as mask for @pixmap, or %NULL to have none + + + + + + Sets a list of icons for the window. One of these will be used +to represent the window when it has been iconified. The icon is +usually shown in an icon box or some sort of task bar. Which icon +size is shown depends on the window manager. The window manager +can scale the icon but setting several size icons can give better +image quality since the window manager may only need to scale the +icon by a small amount or not at all. + + + + + + A list of pixbufs, of different sizes. + + + + + + + + Windows may have a name used while minimized, distinct from the +name they display in their titlebar. Most of the time this is a bad +idea from a user interface standpoint. But you can set such a name +with this function, if you like. +After calling this with a non-%NULL @name, calls to gdk_window_set_title() +will not update the icon title. +Using %NULL for @name unsets the icon title; further calls to +gdk_window_set_title() will again update the icon title as well. + + + + + + name of window while iconified (minimized) + + + + + + Set if @window must be kept above other windows. If the +window was already above, then this function does nothing. +On X11, asks the window manager to keep @window above, if the window +manager supports this operation. Not all window managers support +this, and some deliberately ignore it or don't have a concept of +"keep above"; so you can't rely on the window being kept above. +But it will happen with most standard window managers, +and GDK makes a best effort to get it to happen. + + + + + + whether to keep @window above other windows + + + + + + Set if @window must be kept below other windows. If the +window was already below, then this function does nothing. +On X11, asks the window manager to keep @window below, if the window +manager supports this operation. Not all window managers support +this, and some deliberately ignore it or don't have a concept of +"keep below"; so you can't rely on the window being kept below. +But it will happen with most standard window managers, +and GDK makes a best effort to get it to happen. + + + + + + whether to keep @window below other windows + + + + + + The application can use this hint to tell the window manager +that a certain window has modal behaviour. The window manager +can use this information to handle modal windows in a special +way. +You should only use this on windows for which you have +previously called gdk_window_set_transient_for() + + + + + + %TRUE if the window is modal, %FALSE otherwise. + + + + + + Request the windowing system to make @window partially transparent, +with opacity 0 being fully transparent and 1 fully opaque. (Values +of the opacity parameter are clamped to the [0,1] range.) +On X11, this works only on X screens with a compositing manager +running. +For setting up per-pixel alpha, see gdk_screen_get_rgba_colormap(). +For making non-toplevel windows translucent, see +gdk_window_set_composited(). + + + + + + opacity + + + + + + An override redirect window is not under the control of the window manager. +This means it won't have a titlebar, won't be minimizable, etc. - it will +be entirely under the control of the application. The window manager +can't see the override redirect window at all. +Override redirect should only be used for short-lived temporary +windows, such as popup menus. #GtkMenu uses an override redirect +window in its implementation, for example. + + + + + + %TRUE if window should be override redirect + + + + + + When using GTK+, typically you should use gtk_window_set_role() instead +of this low-level function. +The window manager and session manager use a window's role to +distinguish it from other kinds of window in the same application. +When an application is restarted after being saved in a previous +session, all windows with the same title and role are treated as +interchangeable. So if you have two windows with the same title +that should be distinguished for session management purposes, you +should set the role on those windows. It doesn't matter what string +you use for the role, as long as you have a different role for each +non-interchangeable kind of window. + + + + + + a string indicating its role + + + + + + Toggles whether a window should appear in a pager (workspace +switcher, or other desktop utility program that displays a small +thumbnail representation of the windows on the desktop). If a +window's semantic type as specified with gdk_window_set_type_hint() +already fully describes the window, this function should +<emphasis>not</emphasis> be called in addition, instead you should +allow the window to be treated according to standard policy for +its semantic type. + + + + + + %TRUE to skip the pager + + + + + + Toggles whether a window should appear in a task list or window +list. If a window's semantic type as specified with +gdk_window_set_type_hint() already fully describes the window, this +function should <emphasis>not</emphasis> be called in addition, +instead you should allow the window to be treated according to +standard policy for its semantic type. + + + + + + %TRUE to skip the taskbar + + + + + + When using GTK+, typically you should use gtk_window_set_startup_id() +instead of this low-level function. + + + + + + a string with startup-notification identifier + + + + + + Set the bit gravity of the given window to static, and flag it so +all children get static subwindow gravity. This is used if you are +implementing scary features that involve deep knowledge of the +windowing system. Don't worry about it unless you have to. + + %TRUE if the server supports static gravity + + + + + %TRUE to turn on static gravity + + + + + + This function will enable multidevice features in @window. +Multidevice aware windows will need to handle properly multiple, +per device enter/leave events, device grabs and grab ownerships. + + + + + + %TRUE to enable multidevice support in @window. + + + + + + Sets the title of a toplevel window, to be displayed in the titlebar. +If you haven't explicitly set the icon name for the window +(using gdk_window_set_icon_name()), the icon name will be set to +user-readable strings in GDK/GTK+). @title may not be %NULL. + + + + + + title of @window + + + + + + Indicates to the window manager that @window is a transient dialog +associated with the application window @parent. This allows the +window manager to do things like center @window on @parent and +keep @window above @parent. +See gtk_window_set_transient_for() if you're using #GtkWindow or +#GtkDialog. + + + + + + another toplevel #GdkWindow + + + + + + The application can use this call to provide a hint to the window +manager about the functionality of a window. The window manager +can use this information when determining the decoration and behaviour +of the window. +The hint must be set before the window is mapped. + + + + + + A hint of the function this window will have + + + + + + Toggles whether a window needs the user's +urgent attention. + + + + + + %TRUE if the window is urgent + + + + + + For most purposes this function is deprecated in favor of +g_object_set_data(). However, for historical reasons GTK+ stores +the #GtkWidget that owns a #GdkWindow as user data on the +#GdkWindow. So, custom widget implementations should use +this function for that. If GTK+ receives an event for a #GdkWindow, +and the user data for the window is non-%NULL, GTK+ will assume the +user data is a #GtkWidget, and forward the event to that widget. + + + + + + user data + + + + + + Applies a shape mask to @window. Pixels in @window corresponding to +set bits in the @mask will be visible; pixels in @window +corresponding to unset bits in the @mask will be transparent. This +gives a non-rectangular window. +If @mask is %NULL, the shape mask will be unset, and the @x/@y +parameters are not used. +On the X11 platform, this uses an X server extension which is +widely available on most common platforms, but not available on +very old X servers, and occasionally the implementation will be +buggy. On servers without the shape extension, this function +will do nothing. +This function works on both toplevel and child windows. + + + + + + shape mask + + + + X position of shape mask with respect to @window + + + + Y position of shape mask with respect to @window + + + + + + Makes pixels in @window outside @shape_region be transparent, +so that the window may be nonrectangular. See also +gdk_window_shape_combine_mask() to use a bitmap as the mask. +If @shape_region is %NULL, the shape will be unset, so the whole +window will be opaque again. @offset_x and @offset_y are ignored +if @shape_region is %NULL. +On the X11 platform, this uses an X server extension which is +widely available on most common platforms, but not available on +very old X servers, and occasionally the implementation will be +buggy. On servers without the shape extension, this function +will do nothing. +This function works on both toplevel and child windows. + + + + + + region of window to be non-transparent + + + + X position of @shape_region in @window coordinates + + + + Y position of @shape_region in @window coordinates + + + + + + Like gdk_window_show_unraised(), but also raises the window to the +top of the window stack (moves the window to the front of the +Z-order). +This function maps a window so it's visible onscreen. Its opposite +is gdk_window_hide(). +When implementing a #GtkWidget, you should call this function on the widget's +#GdkWindow as part of the "map" method. + + + + + + Shows a #GdkWindow onscreen, but does not modify its stacking +order. In contrast, gdk_window_show() will raise the window +to the top of the window stack. +On the X11 platform, in Xlib terms, this function calls +XMapWindow() (it also updates some internal GDK state, which means +that you can't really use XMapWindow() directly on a GDK window). + + + + + + "Pins" a window such that it's on all workspaces and does not scroll +with viewports, for window managers that have scrollable viewports. +(When using #GtkWindow, gtk_window_stick() may be more useful.) +On the X11 platform, this function depends on window manager +support, so may have no effect with many window managers. However, +GDK will do the best it can to convince the window manager to stick +the window. For window managers that don't support this operation, +there's nothing you can do to force it to happen. + + + + + + Thaws a window frozen with +gdk_window_freeze_toplevel_updates_libgtk_only(). +This function is not part of the GDK public API and is only +for use by GTK+. + + + + + + Thaws a window frozen with gdk_window_freeze_updates(). + + + + + + Moves the window out of fullscreen mode. If the window was not +fullscreen, does nothing. +On X11, asks the window manager to move @window out of the fullscreen +state, if the window manager supports this operation. Not all +window managers support this, and some deliberately ignore it or +don't have a concept of "fullscreen"; so you can't rely on the +unfullscreenification actually happening. But it will happen with +most standard window managers, and GDK makes a best effort to get +it to happen. + + + + + + Unmaximizes the window. If the window wasn't maximized, then this +function does nothing. +On X11, asks the window manager to unmaximize @window, if the +window manager supports this operation. Not all window managers +support this, and some deliberately ignore it or don't have a +concept of "maximized"; so you can't rely on the unmaximization +actually happening. But it will happen with most standard window +managers, and GDK makes a best effort to get it to happen. +On Windows, reliably unmaximizes the window. + + + + + + Reverse operation for gdk_window_stick(); see gdk_window_stick(), +and gtk_window_unstick(). + + + + + + Withdraws a window (unmaps it and asks the window manager to forget about it). +This function is not really useful as gdk_window_hide() automatically +withdraws toplevel windows before hiding them. + + + + + + The mouse pointer for a #GdkWindow. See gdk_window_set_cursor() and +gdk_window_get_cursor() for details. + + + + The ::from-embedder signal is emitted to translate coordinates +in the embedder of an offscreen window to the offscreen window. +See also #GtkWindow::to-embedder. + + + + + + x coordinate in the embedder window + + + + y coordinate in the embedder window + + + + return location for the x coordinate in the offscreen window + + + + return location for the y coordinate in the offscreen window + + + + + + The ::pick-embedded-child signal is emitted to find an embedded +child at the given position. + + the #GdkWindow of the embedded child at @x, @y, or %NULL + + + + + x coordinate in the window + + + + y coordinate in the window + + + + + + The ::to-embedder signal is emitted to translate coordinates +in an offscreen window to its embedder. +See also #GtkWindow::from-embedder. + + + + + + x coordinate in the offscreen window + + + + y coordinate in the offscreen window + + + + return location for the x coordinate in the embedder window + + + + return location for the y coordinate in the embedder window + + + + + + + Attributes to use for a newly-created window. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Used to indicate which fields in the #GdkWindowAttr struct should be honored. +For example, if you filled in the "cursor" and "x" fields of #GdkWindowAttr, +pass "@GDK_WA_X | @GDK_WA_CURSOR" to gdk_window_new(). Fields in +#GdkWindowAttr not covered by a bit in this enum are required; for example, +the @width/@height, @wclass, and @window_type fields are required, they have +no corresponding flag in #GdkWindowAttributesType. + + + + + + + + + + + + Such windows receive events and are also displayed on screen. +windows in order to trap or filter the events. You can't draw on + + + + + Determines a window edge or corner. + + + + + + + + + + + Used to indicate which fields of a #GdkGeometry struct should be paid +attention to. Also, the presence/absence of @GDK_HINT_POS, +directly refer to #GdkGeometry fields. @GDK_HINT_USER_POS will be set +automatically by #GtkWindow if you call gtk_window_move(). +specified a size/position using a --geometry command-line argument; +gtk_window_parse_geometry() automatically sets these flags. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Describes the kind of window. + + + + + + + + + These are hints for the window manager that indicate what type of function +the window has. The window manager can use this when determining decoration +and behaviour of the window. The hint must be set before mapping the window. +See the +<ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended +Window Manager Hints</ulink> specification for more details about +window types. + + + + + + + + + + + + + + + + + Adds a filter to the default display to be called when X ClientMessage events +are received. See gdk_display_add_client_message_filter(). + + + + + + the type of ClientMessage events to receive. This will be checked against the <structfield>message_type</structfield> field of the XClientMessage event struct. + + + + the function to call to process the event. + + + + user data to pass to @func. + + + + + + Appends gdk option entries to the passed in option group. This is +not public API and must not be used by applications. + + + + + + An option group. + + + + + + + + + + + + + + + + + + + Finds or creates an atom corresponding to a given string. +Note that this function is identical to gdk_atom_intern() except +that if a new #GdkAtom is created the string itself is used rather +than a copy. This saves memory, but can only be used if the string +will <emphasis>always</emphasis> exist. It can be used with statically +allocated strings in the main program, but not with statically +allocated memory in dynamically loaded modules, if you expect to +ever unload the module again (e.g. do not use this function in +GTK+ theme engines). + + the atom corresponding to @atom_name + + + + + a static string + + + + + + + + + + + + + + + + Emits a short beep on the default display. + + + + + + Creates a Cairo context for drawing to @drawable. +<note><para> +Note that due to double-buffering, Cairo contexts created +in a GTK+ expose event handler cannot be cached and reused +between different expose events. +</para></note> +cairo_destroy() when you are done drawing. + + A newly created Cairo context. Free with + + + + + a #GdkDrawable + + + + + + Adds the given rectangle to the current path of @cr. + + + + + + a #cairo_t + + + + a #GdkRectangle + + + + + + Adds the given region to the current path of @cr. + + + + + + a #cairo_t + + + + a #cairo_region_t + + + + + + Resets the clip region for a Cairo context created by gdk_cairo_create(). +This resets the clip region to the "empty" state for the given drawable. +This is required for non-native windows since a direct call to +cairo_reset_clip() would unset the clip region inherited from the +drawable (i.e. the window clip region), and thus let you e.g. +draw outside your window. +This is rarely needed though, since most code just create a new cairo_t +using gdk_cairo_create() each time they want to draw something. + + + + + + a #cairo_t + + + + a #GdkDrawable + + + + + + Sets the specified #GdkColor as the source color of @cr. + + + + + + a #cairo_t + + + + a #GdkColor + + + + + + Sets the given pixbuf as the source pattern for the Cairo context. +The pattern has an extend mode of %CAIRO_EXTEND_NONE and is aligned +so that the origin of @pixbuf is @pixbuf_x, @pixbuf_y + + + + + + a #Cairo context + + + + a #GdkPixbuf + + + + X coordinate of location to place upper left corner of @pixbuf + + + + Y coordinate of location to place upper left corner of @pixbuf + + + + + + Sets the given pixmap as the source pattern for the Cairo context. +The pattern has an extend mode of %CAIRO_EXTEND_NONE and is aligned +so that the origin of @pixmap is @pixmap_x, @pixmap_y + + + + + + a #Cairo context + + + + a #GdkPixmap + + + + X coordinate of location to place upper left corner of @pixmap + + + + Y coordinate of location to place upper left corner of @pixmap + + + + + + Parses a textual specification of a color and fill in the +<structfield>red</structfield>, <structfield>green</structfield>, +and <structfield>blue</structfield> fields of a #GdkColor +structure. The color is <emphasis>not</emphasis> allocated, you +must call gdk_colormap_alloc_color() yourself. The string can +either one of a large set of standard names. (Taken from the X11 +<filename>rgb.txt</filename> file), or it can be a hex value in the +form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb' or +'&num;rrrrggggbbbb' where 'r', 'g' and 'b' are hex digits of the +red, green, and blue components of the color, respectively. (White +in the four forms is '&num;fff' '&num;ffffff' '&num;fffffffff' and +'&num;ffffffffffff') + + %TRUE if the parsing succeeded. + + + + + the string specifying the color. + + + + the #GdkColor to fill in + + + + + + Returns the list of available input devices for the default display. +The list is statically allocated and should not be freed. + + a list of #GdkDevice + + + + + + + Aborts a drag without dropping. +This function is called by the drag source. + + + + + + a #GdkDragContext. + + + + the timestamp for this operation. + + + + + + Starts a drag and creates a new drag context for it. +This function is called by the drag source. + + a newly created #GdkDragContext. + + + + + the source window for this drag. + + + + the offered targets, as list of #GdkAtom<!-- -->s + + + + + + + + Drops on the current destination. +This function is called by the drag source. + + + + + + a #GdkDragContext. + + + + the timestamp for this operation. + + + + + + Returns whether the dropped data has been successfully +transferred. This function is intended to be used while +handling a %GDK_DROP_FINISHED event, its return value is +meaningless at other times. + + %TRUE if the drop was successful. + + + + + a #GdkDragContext + + + + + + Finds the destination window and DND protocol to use at the +given pointer position. +This function is called by the drag source to obtain the + + + + + + a #GdkDragContext. + + + + a window which may be at the pointer position, but should be ignored, since it is put up by the drag source as an icon. + + + + the x position of the pointer in root coordinates. + + + + the y position of the pointer in root coordinates. + + + + location to store the destination window in. + + + + location to store the DND protocol in. + + + + + + Finds the destination window and DND protocol to use at the +given pointer position. +This function is called by the drag source to obtain the + + + + + + a #GdkDragContext + + + + a window which may be at the pointer position, but should be ignored, since it is put up by the drag source as an icon. + + + + the screen where the destination window is sought. + + + + the x position of the pointer in root coordinates. + + + + the y position of the pointer in root coordinates. + + + + location to store the destination window in. + + + + location to store the DND protocol in. + + + + + + Finds out the DND protocol supported by a window. +the drop should happen. This may be @xid or the id of a proxy +window, or zero if @xid doesn't support Drag and Drop. + + the windowing system specific id for the window where + + + + + the windowing system id of the destination window. + + + + location where the supported DND protocol is returned. + + + + + + Finds out the DND protocol supported by a window. + + the windowing system id of the window where the drop should happen. This may be @xid or the id of a proxy window, or zero if @xid doesn't support Drag and Drop. + + + + + the #GdkDisplay where the destination window resides + + + + the windowing system id of the destination window. + + + + location where the supported DND protocol is returned. + + + + + + Returns the selection atom for the current source window. + + the selection atom. + + + + + a #GdkDragContext. + + + + + + Updates the drag context when the pointer moves or the +set of actions changes. +This function is called by the drag source. + + FIXME + + + + + a #GdkDragContext. + + + + the new destination window, obtained by gdk_drag_find_window(). + + + + the DND protocol in use, obtained by gdk_drag_find_window(). + + + + the x position of the pointer in root coordinates. + + + + the y position of the pointer in root coordinates. + + + + the suggested action. + + + + the possible actions. + + + + the timestamp for this operation. + + + + + + Selects one of the actions offered by the drag source. +This function is called by the drag destination in response to +gdk_drag_motion() called by the drag source. + + + + + + a #GdkDragContext. + + + + the selected action which will be taken when a drop happens, or 0 to indicate that a drop will not be accepted. + + + + the timestamp for this operation. + + + + + + Ends the drag operation after a drop. +This function is called by the drag destination. + + + + + + a #GtkDragContext. + + + + %TRUE if the data was successfully received. + + + + the timestamp for this operation. + + + + + + Accepts or rejects a drop. +This function is called by the drag destination in response +to a drop initiated by the drag source. + + + + + + a #GdkDragContext. + + + + %TRUE if the drop is accepted. + + + + the timestamp for this operation. + + + + + + Enables multidevice support in GDK. This call must happen prior +to gdk_display_open(), gtk_init(), gtk_init_with_args() or +gtk_init_check() in order to take effect. +Note that individual #GdkWindow<!-- -->s still need to explicitly +enable multidevice awareness through gdk_window_set_support_multidevice(). +This function must be called before initializing GDK. + + + + + + Removes an error trap pushed with gdk_error_trap_push(). +May block until an error has been definitively received +or not received from the X server. gdk_error_trap_pop_ignored() +is preferred if you don't need to know whether an error +occurred, because it never has to block. If you don't +need the return value of gdk_error_trap_pop(), use +gdk_error_trap_pop_ignored(). +Prior to GDK 3.0, this function would not automatically +sync for you, so you had to gdk_flush() if your last +call to Xlib was not a blocking round trip. + + X error code or 0 on success + + + + + Removes an error trap pushed with gdk_error_trap_push(), but +without bothering to wait and see whether an error occurred. If an +error arrives later asynchronously that was triggered while the +trap was pushed, that error will be ignored. + + + + + + This function allows X errors to be trapped instead of the normal +behavior of exiting the application. It should only be used if it +is not possible to avoid the X error in any other way. Errors are +ignored on all #GdkDisplay currently known to the +#GdkDisplayManager. If you don't care which error happens and just +want to ignore everything, pop with gdk_error_trap_pop_ignored(). +If you need the error code, use gdk_error_trap_pop() which may have +to block and wait for the error to arrive from the X server. +This API exists on all platforms but only does anything on X. +You can use gdk_x11_display_error_trap_push() to ignore errors +on only a single display. +<example> +<title>Trapping an X error</title> +<programlisting> +gdk_error_trap_push (<!-- -->); +// ... Call the X function which may cause an error here ... +if (gdk_error_trap_pop (<!-- -->)) +{ +// ... Handle the error here ... +} +</programlisting> +</example> + + + + + + Checks all open displays for a #GdkEvent to process,to be processed +on, fetching events from the windowing system if necessary. +See gdk_display_get_event(). +are pending. The returned #GdkEvent should be freed with gdk_event_free(). + + the next #GdkEvent to be processed, or %NULL if no events + + + + + Sets the function to call to handle all events from GDK. +Note that GTK+ uses this to install its own event handler, so it is +usually not useful for GTK+ applications. (Although an application +can call this function then call gtk_main_do_event() to pass +events to GTK+.) + + + + + + the function to call to handle events from GDK. + + + + user data to pass to the function. + + + + the function to call when the handler function is removed, i.e. when gdk_event_handler_set() is called with another event handler. + + + + + + If there is an event waiting in the event queue of some open +display, returns a copy of it. See gdk_display_peek_event(). +events are in any queues. The returned #GdkEvent should be freed with +gdk_event_free(). + + a copy of the first #GdkEvent on some event queue, or %NULL if no + + + + + Request more motion notifies if @event is a motion notify hint event. +This function should be used instead of gdk_window_get_pointer() to +request further motion notifies, because it also works for extension +events where motion notifies are provided for devices other than the +core pointer. Coordinate extraction, processing and requesting more +motion events from a %GDK_MOTION_NOTIFY event usually works like this: +|[ +{ +/&ast; motion_event handler &ast;/ +x = motion_event->x; +y = motion_event->y; +/&ast; handle (x,y) motion &ast;/ +gdk_event_request_motions (motion_event); /&ast; handles is_hint events &ast;/ +} +]| + + + + + + a valid #GdkEvent + + + + + + On X11, sends an X ClientMessage event to a given window. On +Windows, sends a message registered with the name +GDK_WIN32_CLIENT_MESSAGE. +This could be used for communicating between different +applications, though the amount of data is limited to 20 bytes on +X11, and to just four bytes on Windows. + + non-zero on success. + + + + + the #GdkDisplay for the window where the message is to be sent. + + + + the #GdkEvent to send, which should be a #GdkEventClient. + + + + the window to send the client message to. + + + + + + Checks if any events are ready to be processed for any display. + + %TRUE if any events are pending. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Obtains the root window (parent all other windows are inside) +for the default display and screen. + + the default root window + + + + + + + + + + + + + + + + + + + + Gets whether event debugging output is enabled. + + %TRUE if event debugging output is enabled. + + + + + + + + + + + + + + + + + + + + Initialize the library for use. +Arguments: +"argc" is the number of arguments. +"argv" is an array of strings. +Results: +"argc" and "argv" are modified to reflect any arguments +which were not handled. (Such arguments should either +be handled by the application or dismissed). If initialization +fails, returns FALSE, otherwise TRUE. +Side effects: +The library is initialized. +-------------------------------------------------------------- + + + + + + + + + + + + + + + + Turns extension events on or off for a particular window, +and specifies the event mask for extension events. + + + + + + a #GdkWindow. + + + + the event mask + + + + the type of extension events that are desired. + + + + + + Grabs the keyboard so that all events are passed to this +application until the keyboard is ungrabbed with gdk_keyboard_ungrab(). +This overrides any previous keyboard grab by this client. +If you set up anything at the time you take the grab that needs to be cleaned +up when the grab ends, you should handle the #GdkEventGrabBroken events that +are emitted when the grab ends unvoluntarily. + + %GDK_GRAB_SUCCESS if the grab was successful. + + + + + the #GdkWindow which will own the grab (the grab window). + + + + if %FALSE then all keyboard events are reported with respect to reported as normal, but keyboard events outside this application are reported with respect to @window. Both key press and key release events are always reported, independant of the event mask set by the application. + + + + + + + + + Ungrabs the keyboard on the default display, if it is grabbed by this +application. +instead. + + + + + + a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no timestamp is available. + + + + + + Obtains the upper- and lower-case versions of the keyval @symbol. +Examples of keyvals are #GDK_KEY_a, #GDK_KEY_Enter, #GDK_KEY_F1, etc. + + + + + + a keyval + + + + return location for lowercase version of @symbol + + + + return location for uppercase version of @symbol + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Convert from a GDK key symbol to the corresponding ISO10646 (Unicode) +character. +is no corresponding character. + + the corresponding unicode character, or 0 if there + + + + + a GDK key symbol + + + + + + + + + + + + + + + + Lists the available visuals for the default screen. +(See gdk_screen_list_visuals()) +A visual describes a hardware image data format. +For example, a visual might support 24-bit color, or 8-bit color, +and might expect pixels to be in a certain format. +Call g_list_free() on the return value when you're finished with it. +a list of visuals; the list must be freed, but not its contents + + + + + + + + Indicates to the GUI environment that the application has finished +loading. If the applications opens windows, this function is +normally called after opening the application's initial set of +windows. +GTK+ will call this function automatically after opening the first +#GtkWindow unless gtk_window_set_auto_startup_notification() is called +to disable that feature. + + + + + + Indicates to the GUI environment that the application has finished +loading, using a given identifier. +GTK+ will call this function automatically for #GtkWindow with custom +startup-notification identifier unless +gtk_window_set_auto_startup_notification() is called to disable +that feature. + + + + + + a startup-notification identifier, for which notification process should be completed + + + + + + Gets the window that @window is embedded in. +embedded offscreen window + + the embedding #GdkWindow, or %NULL if @window is not an + + + + + a #GdkWindow + + + + + + Gets the offscreen pixmap that an offscreen window renders into. +If you need to keep this around over window resizes, you need to +add a reference to it. + + The offscreen pixmap, or %NULL if not offscreen + + + + + a #GdkWindow + + + + + + Sets @window to be embedded in @embedder. +To fully embed an offscreen window, in addition to calling this +function, it is also necessary to handle the #GdkWindow::pick-embedded-child +signal on the @embedder and the #GdkWindow::to-embedder and +#GdkWindow::from-embedder signals on @window. + + + + + + a #GdkWindow + + + + the #GdkWindow that @window gets embedded in + + + + + + Creates a #PangoContext for the default GDK screen. +The context must be freed when you're finished with it. +When using GTK+, normally you should use gtk_widget_get_pango_context() +instead of this function, to get the appropriate context for +the widget you intend to render text onto. +The newly created context will have the default font options (see +#cairo_font_options_t) for the default screen; if these options +change it will not be updated. Using gtk_widget_get_pango_context() +is more convenient if you want to keep a context around and track +changes to the screen's font rendering settings. + + a new #PangoContext for the default display + + + + + Creates a #PangoContext for @screen. +The context must be freed when you're finished with it. +When using GTK+, normally you should use gtk_widget_get_pango_context() +instead of this function, to get the appropriate context for +the widget you intend to render text onto. +The newly created context will have the default font options +(see #cairo_font_options_t) for the screen; if these options +change it will not be updated. Using gtk_widget_get_pango_context() +is more convenient if you want to keep a context around and track +changes to the screen's font rendering settings. + + a new #PangoContext for @screen + + + + + the #GdkScreen for which the context is to be created. + + + + + + Obtains a clip region which contains the areas where the given ranges +of text would be drawn. @x_origin and @y_origin are the top left point +to center the layout. @index_ranges should contain +ranges of bytes in the layout's text. +Note that the regions returned correspond to logical extents of the text +ranges, not ink extents. So the drawn layout may in fact touch areas out of +the clip region. The clip region is mainly useful for highlightling parts +of text, such as when text is selected. + + a clip region containing the given ranges + + + + + a #PangoLayout + + + + X pixel where you intend to draw the layout with this clip + + + + Y pixel where you intend to draw the layout with this clip + + + + array of byte indexes into the layout, where even members of array are start indexes and odd elements are end indexes + + + + number of ranges in @index_ranges, i.e. half the size of @index_ranges + + + + + + Obtains a clip region which contains the areas where the given +ranges of text would be drawn. @x_origin and @y_origin are the top left +position of the layout. @index_ranges +should contain ranges of bytes in the layout's text. The clip +region will include space to the left or right of the line (to the +layout bounding box) if you have indexes above or below the indexes +contained inside the line. This is to draw the selection all the way +to the side of the layout. However, the clip region is in line coordinates, +not layout coordinates. +Note that the regions returned correspond to logical extents of the text +ranges, not ink extents. So the drawn line may in fact touch areas out of +the clip region. The clip region is mainly useful for highlightling parts +of text, such as when text is selected. + + a clip region containing the given ranges + + + + + a #PangoLayoutLine + + + + X pixel where you intend to draw the layout line with this clip + + + + baseline pixel where you intend to draw the layout line with this clip + + + + array of byte indexes into the layout, where even members of array are start indexes and odd elements are end indexes + + + + number of ranges in @index_ranges, i.e. half the size of @index_ranges + + + + + + Parse command line arguments, and store for future +use by calls to gdk_display_open(). +Any arguments used by GDK are removed from the array and @argc and @argv are +updated accordingly. +You shouldn't call this function explicitely if you are using +gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check(). + + + + + + the number of command line arguments. + + + + the array of command line arguments. + + + + + + Transfers image data from a #GdkDrawable and converts it to an RGB(A) +representation inside a #GdkPixbuf. In other words, copies +image data from a server-side drawable to a client-side RGB(A) buffer. +This allows you to efficiently read individual pixels on the client side. +If the drawable @src has no colormap (gdk_drawable_get_colormap() +returns %NULL), then a suitable colormap must be specified. +Typically a #GdkWindow or a pixmap created by passing a #GdkWindow +to gdk_pixmap_new() will already have a colormap associated with +it. If the drawable has a colormap, the @cmap argument will be +ignored. If the drawable is a bitmap (1 bit per pixel pixmap), +then a colormap is not required; pixels with a value of 1 are +assumed to be white, and pixels with a value of 0 are assumed to be +black. For taking screenshots, gdk_colormap_get_system() returns +the correct colormap to use. +If the specified destination pixbuf @dest is %NULL, then this +function will create an RGB pixbuf with 8 bits per channel and no +alpha, with the same size specified by the @width and @height +arguments. In this case, the @dest_x and @dest_y arguments must be +specified as 0. If the specified destination pixbuf is not %NULL +and it contains alpha information, then the filled pixels will be +set to full opacity (alpha = 255). +If the specified drawable is a pixmap, then the requested source +rectangle must be completely contained within the pixmap, otherwise +the function will return %NULL. For pixmaps only (not for windows) +passing -1 for width or height is allowed to mean the full width +or height of the pixmap. +If the specified drawable is a window, and the window is off the +screen, then there is no image data in the obscured/offscreen +regions to be placed in the pixbuf. The contents of portions of the +pixbuf corresponding to the offscreen region are undefined. +If the window you're obtaining data from is partially obscured by +other windows, then the contents of the pixbuf areas corresponding +to the obscured regions are undefined. +If the target drawable is not mapped (typically because it's +iconified/minimized or not on the current workspace), then %NULL +will be returned. +If memory can't be allocated for the return value, %NULL will be returned +instead. +(In short, there are several ways this function can fail, and if it fails +it returns %NULL; so check the return value.) +pixbuf with a reference count of 1 if no destination pixbuf was specified, or %NULL on error + + The same pixbuf as @dest if it was non-%NULL, or a newly-created + + + + + Destination pixbuf, or %NULL if a new pixbuf should be created. + + + + Source drawable. + + + + A colormap if @src doesn't have one set. + + + + Source X coordinate within drawable. + + + + Source Y coordinate within drawable. + + + + Destination X coordinate in pixbuf, or 0 if @dest is NULL. + + + + Destination Y coordinate in pixbuf, or 0 if @dest is NULL. + + + + Width in pixels of region to get. + + + + Height in pixels of region to get. + + + + + + Transfers image data from a #cairo_surface_t and converts it to an RGB(A) +representation inside a #GdkPixbuf. This allows you to efficiently read individual +pixels from Cairo surfaces. For #GdkWindows, use gdk_pixbuf_get_from_drawable() +instead. +If the specified destination pixbuf @dest is %NULL, then this +function will create an RGB pixbuf with 8 bits per channel. The pixbuf will +contain an alpha channel if the @surface contains one. In this case, the @dest_x +and @dest_y arguments must be specified as 0. +If the specified drawable is a window, and the window is off the +screen, then there is no image data in the obscured/offscreen +regions to be placed in the pixbuf. The contents of portions of the +pixbuf corresponding to the offscreen region are undefined. +If the window you're obtaining data from is partially obscured by +other windows, then the contents of the pixbuf areas corresponding +to the obscured regions are undefined. +If memory can't be allocated for the return value, %NULL will be returned +instead. +(In short, there are several ways this function can fail, and if it fails +it returns %NULL; so check the return value.) +pixbuf with a reference count of 1 if no destination pixbuf was specified, or %NULL on error + + The same pixbuf as @dest if it was non-%NULL, or a newly-created + + + + + Destination pixbuf, or %NULL if a new pixbuf should be created. + + + + surface to copy from + + + + Source X coordinate within drawable. + + + + Source Y coordinate within drawable. + + + + Destination X coordinate in pixbuf, or 0 if @dest is NULL. + + + + Destination Y coordinate in pixbuf, or 0 if @dest is NULL. + + + + Width in pixels of region to get. + + + + Height in pixels of region to get. + + + + + + Creates a pixmap and a mask bitmap which are returned in the @pixmap_return +and @mask_return arguments, respectively, and renders a pixbuf and its +corresponding thresholded alpha mask to them. This is merely a convenience +function; applications that need to render pixbufs with dither offsets or to +given drawables should use Cairo and gdk_pixbuf_render_threshold_alpha(). +The pixmap that is created is created for the colormap returned +by gdk_colormap_get_system(). You normally will want to instead use +the actual colormap for a widget, and use +gdk_pixbuf_render_pixmap_and_mask_for_colormap(). +If the pixbuf does not have an alpha channel, then *@mask_return will be set +to %NULL. + + + + + + A pixbuf. + + + + Location to store a pointer to the created pixmap, or %NULL if the pixmap is not needed. + + + + Location to store a pointer to the created mask, or %NULL if the mask is not needed. + + + + Threshold value for opacity values. + + + + + + Creates a pixmap and a mask bitmap which are returned in the @pixmap_return +and @mask_return arguments, respectively, and renders a pixbuf and its +corresponding tresholded alpha mask to them. This is merely a convenience +function; applications that need to render pixbufs with dither offsets or to +given drawables should use Cairo and gdk_pixbuf_render_threshold_alpha(). +The pixmap that is created uses the #GdkColormap specified by @colormap. +This colormap must match the colormap of the window where the pixmap +will eventually be used or an error will result. +If the pixbuf does not have an alpha channel, then *@mask_return will be set +to %NULL. + + + + + + A pixbuf. + + + + A #GdkColormap + + + + Location to store a pointer to the created pixmap, or %NULL if the pixmap is not needed. + + + + Location to store a pointer to the created mask, or %NULL if the mask is not needed. + + + + Threshold value for opacity values. + + + + + + Takes the opacity values in a rectangular portion of a pixbuf and thresholds +them to produce a bi-level alpha mask that can be used as a clipping mask for +a drawable. + + + + + + A pixbuf. + + + + Bitmap where the bilevel mask will be painted to. + + + + Source X coordinate. + + + + source Y coordinate. + + + + Destination X coordinate. + + + + Destination Y coordinate. + + + + Width of region to threshold, or -1 to use pixbuf width + + + + Height of region to threshold, or -1 to use pixbuf height + + + + Opacity values below this will be painted as zero; all other values will be painted as one. + + + + + + Grabs the pointer (usually a mouse) so that all events are passed to this +application until the pointer is ungrabbed with gdk_pointer_ungrab(), or +the grab window becomes unviewable. +This overrides any previous pointer grab by this client. +Pointer grabs are used for operations which need complete control over mouse +events, even if the mouse leaves the application. +For example in GTK+ it is used for Drag and Drop, for dragging the handle in +the #GtkHPaned and #GtkVPaned widgets, and for resizing columns in #GtkCList +widgets. +Note that if the event mask of an X window has selected both button press and +button release events, then a button press event will cause an automatic +pointer grab until the button is released. +X does this automatically since most applications expect to receive button +press and release events in pairs. +It is equivalent to a pointer grab on the window with @owner_events set to +%TRUE. +If you set up anything at the time you take the grab that needs to be cleaned +up when the grab ends, you should handle the #GdkEventGrabBroken events that +are emitted when the grab ends unvoluntarily. + + %GDK_GRAB_SUCCESS if the grab was successful. + + + + + the #GdkWindow which will own the grab (the grab window). + + + + if %FALSE then all pointer events are reported with respect to events for this application are reported as normal, but pointer events outside this application are reported with respect to @window and only if selected by + + + + specifies the event mask, which is used in accordance with may be selected. + + + + If non-%NULL, the pointer will be confined to this window during the grab. If the pointer is outside @confine_to, it will automatically be moved to the closest edge of @confine_to and enter and leave events will be generated as necessary. + + + + the cursor to display while the grab is active. If this is %NULL then the normal cursors are used for @window and its descendants, and the cursor for @window is used for all other windows. + + + + the timestamp of the event which led to this pointer grab. This usually comes from a #GdkEventButton struct, though %GDK_CURRENT_TIME can be used if the time isn't known. + + + + + + Returns %TRUE if the pointer on the default display is currently +grabbed by this application. +Note that this does not take the inmplicit pointer grab on button +presses into account. + + %TRUE if the pointer is currently grabbed by this application. + + + + + Ungrabs the pointer on the default display, if it is grabbed by this +application. +instead. + + + + + + a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no timestamp is available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + This function returns the available bit depths for the default +screen. It's equivalent to listing the visuals +(gdk_list_visuals()) and then looking at the depth field in each +visual, removing duplicates. +The array returned by this function should not be freed. + + + + + + return location for available depths + + + + + + return location for number of available depths + + + + + + This function returns the available visual types for the default +screen. It's equivalent to listing the visuals +(gdk_list_visuals()) and then looking at the type field in each +visual, removing duplicates. +The array returned by this function should not be freed. + + + + + + return location for the available visual types + + + + return location for the number of available visual types + + + + + + + + + + + Calculates the intersection of two rectangles. It is allowed for +do not intersect, @dest's width and height is set to 0 and its x +and y values are undefined. If you are only interested in whether +the rectangles intersect, but not in the intersecting area itself, +pass %NULL for @dest. + + %TRUE if the rectangles intersect. + + + + + a #GdkRectangle + + + + a #GdkRectangle + + + + return location for the intersection of @src1 and @src2, or %NULL + + + + + + Calculates the union of two rectangles. +The union of rectangles @src1 and @src2 is the smallest rectangle which +includes both @src1 and @src2 within it. +It is allowed for @dest to be the same as either @src1 or @src2. + + + + + + a #GdkRectangle + + + + a #GdkRectangle + + + + return location for the union of @src1 and @src2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Determine the owner of the given selection. +Note that the return value may be owned by a different +process if a foreign window was previously created for that +window, but a new foreign window will never be created by this call. +window known to the current process, the #GdkWindow that owns the +selection, otherwise %NULL. + + if there is a selection owner for this window, and it is a + + + + + a #GdkDisplay. + + + + an atom indentifying a selection. + + + + + + + + + + + + + + + + + + + + + + + + + Sets the #GdkWindow @owner as the current owner of the selection @selection. +otherwise %FALSE. + + %TRUE if the selection owner was successfully changed to owner, + + + + + the #GdkDisplay. + + + + a #GdkWindow or %NULL to indicate that the owner for the given should be unset. + + + + an atom identifying a selection. + + + + timestamp to use when setting the selection. If this is older than the timestamp given last time the owner was set for the given selection, the request will be ignored. + + + + if %TRUE, and the new owner is different from the current owner, the current owner will be sent a SelectionClear event. + + + + + + Retrieves selection data that was stored by the selection +data in response to a call to gdk_selection_convert(). This function +will not be used by applications, who should use the #GtkClipboard +API instead. + + the length of the retrieved data. + + + + + the window on which the data is stored + + + + location to store a pointer to the retrieved data. + + + + location to store the type of the property. + + + + location to store the format of the property. + + + + + + + + + + + + + + + + + + + + + + + + + + + + Send a response to SelectionRequest event. + + + + + + the #GdkDisplay where @requestor is realized + + + + window to which to deliver response. + + + + selection that was requested. + + + + target that was selected. + + + + property in which the selection owner stored the data, or %GDK_NONE to indicate that the request was rejected. + + + + timestamp. + + + + + + Set the double click time for the default display. See +gdk_display_set_double_click_time(). +See also gdk_display_set_double_click_distance(). +Applications should <emphasis>not</emphasis> set this, it is a +global user-configured setting. + + + + + + double click time in milliseconds (thousandths of a second) + + + + + + + + + + + This function allows for hooking into the operation +of getting the current location of the pointer. This +is only useful for such low-level tools as an +event recorder. Applications should never have any +reason to use this facility. +This function is not multihead safe. For multihead operation, +see gdk_display_set_pointer_hooks(). + + the previous pointer hook table + + + + + a table of pointers to functions for getting quantities related to the current pointer position, or %NULL to restore the default table. + + + + + + + + + + + + + + + + Sets whether a trace of received events is output. +Note that GTK+ must be compiled with debugging (that is, +configured using the <option>--enable-debug</option> option) +to use this option. + + + + + + %TRUE to output event debugging information. + + + + + + Sets the <literal>SM_CLIENT_ID</literal> property on the application's leader window so that +the window manager can save the application's state using the X11R6 ICCCM +session management protocol. +See the X Session Management Library documentation for more information on +session management and the Inter-Client Communication Conventions Manual +(ICCCM) for information on the <literal>WM_CLIENT_LEADER</literal> property. +(Both documents are part of the X Window System distribution.) + + + + + + the client id assigned by the session manager when the connection was opened, or %NULL to remove the property. + + + + + + Obtains a desktop-wide setting, such as the double-click time, +for the default screen. See gdk_screen_get_setting(). +in @value, %FALSE otherwise. + + %TRUE if the setting existed and a value was stored + + + + + the name of the setting. + + + + location to store the value of the setting. + + + + + + Like g_spawn_command_line_async(), except the child process is +spawned in such an environment that on calling gdk_display_open() +it would be returned a #GdkDisplay with @screen as the default +screen. +This is useful for applications which wish to launch an application +on a specific screen. + + %TRUE on success, %FALSE if error is set. + + + + + a #GdkScreen + + + + a command line + + + + + + Like g_spawn_async(), except the child process is spawned in such +an environment that on calling gdk_display_open() it would be +returned a #GdkDisplay with @screen as the default screen. +This is useful for applications which wish to launch an application +on a specific screen. + + %TRUE on success, %FALSE if error is set + + + + + a #GdkScreen + + + + child's current working directory, or %NULL to inherit parent's + + + + child's argument vector + + + + child's environment, or %NULL to inherit parent's + + + + flags from #GSpawnFlags + + + + function to run in the child just before exec() + + + + user data for @child_setup + + + + return location for child process ID, or %NULL + + + + + + Like g_spawn_async_with_pipes(), except the child process is +spawned in such an environment that on calling gdk_display_open() +it would be returned a #GdkDisplay with @screen as the default +screen. +This is useful for applications which wish to launch an application +on a specific screen. + + %TRUE on success, %FALSE if an error was set + + + + + a #GdkScreen + + + + child's current working directory, or %NULL to inherit parent's + + + + child's argument vector + + + + child's environment, or %NULL to inherit parent's + + + + flags from #GSpawnFlags + + + + function to run in the child just before exec() + + + + user data for @child_setup + + + + return location for child process ID, or %NULL + + + + return location for file descriptor to write to child's stdin, or %NULL + + + + return location for file descriptor to read child's stdout, or %NULL + + + + return location for file descriptor to read child's stderr, or %NULL + + + + + + + + + + + + + + + + + + + + + + + + + + + + Convert a string from the encoding of the current +locale into a form suitable for storing in a window property. + + 0 upon success, non-zero upon failure. + + + + + the #GdkDisplay where the encoding is defined. + + + + a nul-terminated string. + + + + location to store the encoding atom (to be used as the type for the property). + + + + location to store the format of the property + + + + location to store newly allocated data for the property. + + + + the length of @text, in bytes + + + + + + + + + + + + + + + + + + + + + + This function retrieves a pixel from @window to force the windowing +system to carry out any pending rendering commands. +This function is intended to be used to syncronize with rendering +pipelines, to benchmark windowing system rendering operations. + + + + + + a mapped #GdkWindow + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Convert a text string from the encoding as it is stored +in a property into an array of strings in the encoding of +the current locale. (The elements of the array represent the +nul-separated elements of the original text string.) +if the conversion failed. + + the number of strings stored in list, or 0, + + + + + The #GdkDisplay where the encoding is defined. + + + + an atom representing the encoding. The most common values for this are STRING, or COMPOUND_TEXT. This is value used as the type for the property. + + + + the format of the property. + + + + The text data. + + + + The number of items to transform. + + + + location to store a terminated array of strings in the encoding of the current locale. This array should be freed using gdk_free_text_list(). + + + + + + Convert a text property in the giving encoding to +a list of UTF-8 strings. +list. + + the number of strings in the resulting + + + + + an atom representing the encoding of the text + + + + the format of the property + + + + the text to convert + + + + the length of @text, in bytes + + + + location to store the list of strings or %NULL. The list should be freed with g_strfreev(). + + + + + + Converts a text property in the given encoding to +a list of UTF-8 strings. +list. + + the number of strings in the resulting + + + + + a #GdkDisplay + + + + an atom representing the encoding of the text + + + + the format of the property + + + + the text to convert + + + + the length of @text, in bytes + + + + location to store the list of strings or %NULL. The list should be freed with g_strfreev(). + + + + + + A wrapper for the common usage of gdk_threads_add_idle_full() +assigning the default priority, #G_PRIORITY_DEFAULT_IDLE. +See gdk_threads_add_idle_full(). + + the ID (greater than 0) of the event source. + + + + + function to call + + + + data to pass to @function + + + + + + Adds a function to be called whenever there are no higher priority +events pending. If the function returns %FALSE it is automatically +removed from the list of event sources and will not be called again. +This variant of g_idle_add_full() calls @function with the GDK lock +held. It can be thought of a MT-safe version for GTK+ widgets for the +following use case, where you have to worry about idle_callback() +running in thread A and accessing @self after it has been finalized +in thread B: +|[ +static gboolean +idle_callback (gpointer data) +{ +/&ast; gdk_threads_enter(); would be needed for g_idle_add() &ast;/ +SomeWidget *self = data; +/&ast; do stuff with self &ast;/ +self->idle_id = 0; +/&ast; gdk_threads_leave(); would be needed for g_idle_add() &ast;/ +return FALSE; +} +static void +some_widget_do_stuff_later (SomeWidget *self) +{ +self->idle_id = gdk_threads_add_idle (idle_callback, self) +/&ast; using g_idle_add() here would require thread protection in the callback &ast;/ +} +static void +some_widget_finalize (GObject *object) +{ +SomeWidget *self = SOME_WIDGET (object); +if (self->idle_id) +g_source_remove (self->idle_id); +G_OBJECT_CLASS (parent_class)->finalize (object); +} +]| + + the ID (greater than 0) of the event source. + + + + + the priority of the idle source. Typically this will be in the range btweeen #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE + + + + function to call + + + + data to pass to @function + + + + function to call when the idle is removed, or %NULL + + + + + + A wrapper for the common usage of gdk_threads_add_timeout_full() +assigning the default priority, #G_PRIORITY_DEFAULT. +See gdk_threads_add_timeout_full(). + + the ID (greater than 0) of the event source. + + + + + the time between calls to the function, in milliseconds (1/1000ths of a second) + + + + function to call + + + + data to pass to @function + + + + + + Sets a function to be called at regular intervals holding the GDK lock, +with the given priority. The function is called repeatedly until it +returns %FALSE, at which point the timeout is automatically destroyed +and the function will not be called again. The @notify function is +called when the timeout is destroyed. The first call to the +function will be at the end of the first @interval. +Note that timeout functions may be delayed, due to the processing of other +event sources. Thus they should not be relied on for precise timing. +After each call to the timeout function, the time of the next +timeout is recalculated based on the current time and the given interval +(it does not try to 'catch up' time lost in delays). +This variant of g_timeout_add_full() can be thought of a MT-safe version +for GTK+ widgets for the following use case: +|[ +static gboolean timeout_callback (gpointer data) +{ +SomeWidget *self = data; +/&ast; do stuff with self &ast;/ +self->timeout_id = 0; +return FALSE; +} +static void some_widget_do_stuff_later (SomeWidget *self) +{ +self->timeout_id = g_timeout_add (timeout_callback, self) +} +static void some_widget_finalize (GObject *object) +{ +SomeWidget *self = SOME_WIDGET (object); +if (self->timeout_id) +g_source_remove (self->timeout_id); +G_OBJECT_CLASS (parent_class)->finalize (object); +} +]| + + the ID (greater than 0) of the event source. + + + + + the priority of the timeout source. Typically this will be in the range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE. + + + + the time between calls to the function, in milliseconds (1/1000ths of a second) + + + + function to call + + + + data to pass to @function + + + + function to call when the timeout is removed, or %NULL + + + + + + A wrapper for the common usage of gdk_threads_add_timeout_seconds_full() +assigning the default priority, #G_PRIORITY_DEFAULT. +For details, see gdk_threads_add_timeout_full(). + + the ID (greater than 0) of the event source. + + + + + the time between calls to the function, in seconds + + + + function to call + + + + data to pass to @function + + + + + + A variant of gdk_threads_add_timout_full() with second-granularity. +See g_timeout_add_seconds_full() for a discussion of why it is +a good idea to use this function if you don't need finer granularity. + + the ID (greater than 0) of the event source. + + + + + the priority of the timeout source. Typically this will be in the range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE. + + + + the time between calls to the function, in seconds + + + + function to call + + + + data to pass to @function + + + + function to call when the timeout is removed, or %NULL + + + + + + + + + + + Initializes GDK so that it can be used from multiple threads +in conjunction with gdk_threads_enter() and gdk_threads_leave(). +g_thread_init() must be called previous to this function. +This call must be made before any use of the main loop from +GTK+; to be safe, call it before gtk_init(). + + + + + + + + + + + Allows the application to replace the standard method that +GDK uses to protect its data structures. Normally, GDK +creates a single #GMutex that is locked by gdk_threads_enter(), +and released by gdk_threads_leave(); using this function an +application provides, instead, a function @enter_fn that is +called by gdk_threads_enter() and a function @leave_fn that is +called by gdk_threads_leave(). +The functions must provide at least same locking functionality +as the default implementation, but can also do extra application +specific processing. +As an example, consider an application that has its own recursive +lock that when held, holds the GTK+ lock as well. When GTK+ unlocks +the GTK+ lock when entering a recursive main loop, the application +must temporarily release its lock as well. +Most threaded GTK+ apps won't need to use this method. +This method must be called before gdk_threads_init(), and cannot +be called multiple times. + + + + + + function called to guard GDK + + + + function called to release the guard + + + + + + Convert from a ISO10646 character to a key symbol. +or, if there is no corresponding symbol, +wc | 0x01000000 + + the corresponding GDK key symbol, if one exists. + + + + + a ISO10646 encoded character + + + + + + Convert from UTF-8 to compound text. +false. + + %TRUE if the conversion succeeded, otherwise + + + + + a UTF-8 string + + + + location to store resulting encoding + + + + location to store format of the result + + + + location to store the data of the result + + + + location to store the length of the data stored in @ctext + + + + + + Converts from UTF-8 to compound text. +%FALSE. + + %TRUE if the conversion succeeded, otherwise + + + + + a #GdkDisplay + + + + a UTF-8 string + + + + location to store resulting encoding + + + + location to store format of the result + + + + location to store the data of the result + + + + location to store the length of the data stored in @ctext + + + + + + Converts an UTF-8 string into the best possible representation +as a STRING. The representation of characters not in STRING +is not specified; it may be as pseudo-escape sequences +\x{ABCD}, or it may be in some other form of approximation. +conversion failed. (It should not fail for +any properly formed UTF-8 string unless system +limits like memory or file descriptors are exceeded.) + + the newly-allocated string, or %NULL if the + + + + + a UTF-8 string + + + + + + Obtains the window underneath the mouse pointer, returning the +location of that window in @win_x, @win_y. Returns %NULL if the +window under the mouse pointer is not known to GDK (if the window +belongs to another application and a #GdkWindow hasn't been created +for it with gdk_window_foreign_new()) +gdk_display_get_window_at_pointer() instead. + + window under the mouse pointer + + + + + return location for origin of the window under the pointer + + + + return location for origin of the window under the pointer + + + + + + Constrains a desired width and height according to a +set of geometry hints (such as minimum and maximum size). + + + + + + a #GdkGeometry structure + + + + a mask indicating what portions of @geometry are set + + + + desired width of window + + + + desired height of the window + + + + location to store resulting width + + + + location to store resulting height + + + + + + Wraps a native window for the default display in a #GdkWindow. +This may fail if the window has been destroyed. +For example in the X backend, a native window handle is an Xlib +<type>XID</type>. +native window or %NULL if the window has been destroyed. + + the newly-created #GdkWindow wrapper for the + + + + + a native window handle. + + + + + + Wraps a native window in a #GdkWindow. +This may fail if the window has been destroyed. If the window +was already known to GDK, a new reference to the existing +#GdkWindow is returned. +For example in the X backend, a native window handle is an Xlib +<type>XID</type>. +%NULL if the window has been destroyed. The wrapper will be +newly created, if one doesn't exist already. + + a #GdkWindow wrapper for the native window or + + + + + the #GdkDisplay where the window handle comes from. + + + + a native window handle. + + + + + + Looks up the #GdkWindow that wraps the given native window handle. +For example in the X backend, a native window handle is an Xlib +<type>XID</type>. +or %NULL if there is none. + + the #GdkWindow wrapper for the native window, + + + + + a native window handle. + + + + + + Looks up the #GdkWindow that wraps the given native window handle. +For example in the X backend, a native window handle is an Xlib +<type>XID</type>. +or %NULL if there is none. + + the #GdkWindow wrapper for the native window, + + + + + the #GdkDisplay corresponding to the window handle + + + + a native window handle. + + + + + + Calls gdk_window_process_updates() for all windows (see #GdkWindow) +in the application. + + + + + + With update debugging enabled, calls to +gdk_window_invalidate_region() clear the invalidated region of the +screen to a noticeable color, and GDK pauses for a short time +before sending exposes to windows during +gdk_window_process_updates(). The net effect is that you can see +the invalid region for each window and watch redraws as they +occur. This allows you to diagnose inefficiencies in your application. +In essence, because the GDK rendering model prevents all flicker, +if you are redrawing the same region 400 times you may never +notice, aside from noticing a speed problem. Enabling update +debugging causes GTK to flicker slowly and noticeably, so you can +see exactly what's being redrawn when, in what order. +The --gtk-debug=updates command line option passed to GTK+ programs +enables this debug option at application startup time. That's +usually more useful than calling gdk_window_set_debug_updates() +yourself, though you might want to use this function to enable +updates sometime after application startup time. + + + + + + %TRUE to turn on update debugging + + + + + + diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 28a9f7be37..1e779befa6 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -1,11 +1,17 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.destructors alien.syntax -alien.libraries cairo.ffi combinators kernel system -gobject-introspection gdk.pixbuf.ffi gio.ffi glib.ffi gmodule.ffi -gobject.ffi pango.ffi ; +USING: alien alien.c-types alien.destructors alien.libraries +alien.syntax cairo.ffi classes.struct combinators +gobject-introspection kernel system vocabs.loader ; IN: gdk.ffi +<< +"pango.ffi" require +"gdk.pixbuf.ffi" require +>> + +LIBRARY: gdk + << "gdk" { { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" cdecl add-library ] } @@ -14,12 +20,6 @@ IN: gdk.ffi } cond >> -TYPEDEF: guint32 GdkNativeWindow -TYPEDEF: guint32 GdkWChar -C-TYPE: GdkXEvent - -REPLACE-C-TYPE: any gpointer - IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty @@ -27,7 +27,21 @@ GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient GdkEventNoExpose GdkEventWindowState GdkEventSetting GdkEventOwnerChange GdkEventGrabBroken GdkRectangle ; -GIR: vocab:gdk/Gdk-2.0.gir +! + +FOREIGN-RECORD-TYPE: cairo.RectangleInt cairo_rectangle_int_t +FOREIGN-RECORD-TYPE: cairo.Region cairo_region_t +FOREIGN-RECORD-TYPE: cairo.FontOptions cairo_font_options_t +FOREIGN-RECORD-TYPE: cairo.Surface cairo_surface_t +FOREIGN-RECORD-TYPE: cairo.Pattern cairo_pattern_t +FOREIGN-RECORD-TYPE: cairo.Context cairo_t +FOREIGN-ENUM-TYPE: cairo.Content cairo_content_t + +GIR: vocab:gdk/Gdk-3.0.gir DESTRUCTOR: gdk_cursor_unref - diff --git a/basis/gdk/gl/GdkGL-1.0.gir b/basis/gdk/gl/GdkGLExt-1.0.gir similarity index 51% rename from basis/gdk/gl/GdkGL-1.0.gir rename to basis/gdk/gl/GdkGLExt-1.0.gir index 32e7b324bc..bc18af698f 100644 --- a/basis/gdk/gl/GdkGL-1.0.gir +++ b/basis/gdk/gl/GdkGLExt-1.0.gir @@ -2,39 +2,28 @@ - - + - - + - - + c:identifier-prefixes="GdkGL,Gdk" + c:symbol-prefixes="gdk_gl,gdk"> + + - - - - - - - - - - - - - @@ -71,162 +60,261 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_ACCUM_BUFFER_BIT" glib:nick="accum-buffer-bit"/> - + glib:type-struct="ConfigClass"> + Returns an OpenGL frame buffer configuration that match the specified +attributes. +attrib_list is a int array that contains the attribute/value pairs. +GDK_GL_USE_GL, GDK_GL_BUFFER_SIZE, GDK_GL_LEVEL, GDK_GL_RGBA, +GDK_GL_DOUBLEBUFFER, GDK_GL_STEREO, GDK_GL_AUX_BUFFERS, +GDK_GL_RED_SIZE, GDK_GL_GREEN_SIZE, GDK_GL_BLUE_SIZE, GDK_GL_ALPHA_SIZE, +GDK_GL_DEPTH_SIZE, GDK_GL_STENCIL_SIZE, GDK_GL_ACCUM_RED_SIZE, +GDK_GL_ACCUM_GREEN_SIZE, GDK_GL_ACCUM_BLUE_SIZE, GDK_GL_ACCUM_ALPHA_SIZE. - + the new #GdkGLConfig. + - - + + a list of attribute/value pairs. The last attribute must be GDK_GL_ATTRIB_LIST_NONE. + + + + Returns an OpenGL frame buffer configuration that match the specified +display mode. - + the new #GdkGLConfig. + - + display mode bit mask. + - + + Returns an OpenGL frame buffer configuration that match the specified +display mode. - + the new #GdkGLConfig. + - + + + target screen. + + + + display mode bit mask. + + + + + + Returns an OpenGL frame buffer configuration that match the specified +attributes. + + the new #GdkGLConfig. + + + + + target screen. + + + + a list of attribute/value pairs. The last attribute must be GDK_GL_ATTRIB_LIST_NONE. + + + + + + + Gets information about a OpenGL frame buffer configuration. - + TRUE if it succeeded, FALSE otherwise. + - + the attribute to be returned. + - - + + returns the requested value. + - + Gets the #GdkColormap that is appropriate for the OpenGL frame buffer +configuration. + + the appropriate #GdkColormap. - - - - - + Gets the color depth of the OpenGL-capable visual. - + number of bits per pixel + + Gets the layer plane (level) of the frame buffer. +Zero is the default frame buffer. +Positive layer planes correspond to frame buffers that overlay the default +buffer, and negative layer planes correspond to frame buffers that underlie +the default frame buffer. - + layer plane. + + Gets the number of auxiliary color buffers. - + number of auxiliary color buffers. + + Gets the number of multisample buffers. - + number of multisample buffers. + - + + Gets #GdkScreen. - + the #GdkScreen. + - + + Gets the #GdkVisual that is appropriate for the OpenGL frame buffer +configuration. - - - - - - - - - - - - - - - - - - - - - + the appropriate #GdkVisual. + + Returns whether the configured frame buffer has accumulation buffer. +otherwise. - + TRUE if the frame buffer has accumulation buffer, FALSE + + + + + Returns whether the configured color buffer has alpha bits. + + TRUE if the color buffer has alpha bits, FALSE otherwise. + + + + + Returns whether the configured frame buffer has depth buffer. + + TRUE if the frame buffer has depth buffer, FALSE otherwise. + + + + + Returns whether the configured frame buffer has stencil buffer. + + TRUE if the frame buffer has stencil buffer, FALSE otherwise. + + + + + Returns whether the configuration supports the double-buffered visual. +otherwise. + + TRUE if the double-buffered visual is supported, FALSE + + + + + Returns whether the configured frame buffer is RGBA mode. +otherwise. + + TRUE if the configured frame buffer is RGBA mode, FALSE + + + + + Returns whether the configuration supports the stereo visual. + + TRUE if the stereo visual is supported, FALSE otherwise. + - + - + - + - + - + - + - + - + - + - + - + - @@ -375,7 +463,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_SAMPLES" glib:nick="samples"/> - @@ -396,14 +484,14 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_NON_CONFORMANT_CONFIG" glib:nick="non-conformant-config"/> - + glib:is-gtype-struct-for="Config"> - @@ -436,7 +524,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_BAD_ENUM" glib:nick="bad-enum"/> - @@ -485,255 +573,224 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_MODE_MULTISAMPLE" glib:nick="multisample"/> - + glib:type-struct="ContextClass"> + Creates a new OpenGL rendering context. - + the new #GdkGLContext. + - + a #GdkGLDrawable. + - - + + the #GdkGLContext with which to share display lists and texture objects. NULL indicates that no sharing is to take place. + - + whether rendering is to be done with a direct connection to the graphics system. + - + GDK_GL_RGBA_TYPE or GDK_GL_COLOR_INDEX_TYPE (currently not used). + - - + Returns the current #GdkGLContext. +context. + + the current #GdkGLContext or NULL if there is no current + - - - - - + Copy state from @src rendering context to @glcontext. +the glPushAttrib() function. You can use GL_ALL_ATTRIB_BITS to copy all the +rendering state information. - + FALSE if it fails, TRUE otherwise. + - + the source context. + - + which portions of @src state are to be copied to @glcontext. + + + Gets #GdkGLConfig with which the @glcontext is configured. + + the #GdkGLConfig. + + + - - - - - - - - - - - - - - - + Gets #GdkGLDrawable to which the @glcontext is bound. - + the #GdkGLDrawable or NULL if no #GdkGLDrawable is bound. + + Gets render_type of the @glcontext. - + GDK_GL_RGBA_TYPE or GDK_GL_COLOR_INDEX_TYPE. + + + + + Gets #GdkGLContext with which the @glcontext shares the display lists and +texture objects. + + the #GdkGLContext. + + + + + Returns whether the @glcontext is a direct rendering context. + + TRUE if the @glcontext is a direct rendering contest. + - + glib:is-gtype-struct-for="Context"> - + + + + - - - - - - - - - - - - - - - - - - + glib:get-type="gdk_gl_drawable_get_type"> + + Gets #GdkGLConfig with which the @gldrawable is configured. - + the #GdkGLConfig. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Fills *width and *height with the size of GL drawable. +width or height can be NULL if you only want the other one. - - + + location to store drawable's width, or NULL. + - - + + location to store drawable's height, or NULL. + - - + + + Delimits the begining of the OpenGL execution. - + TRUE if it is successful, FALSE otherwise. + - + a #GdkGLContext. + + + Delimits the end of the OpenGL execution. + + + + + Returns whether the @gldrawable supports the double-buffered visual. +FALSE otherwise. - + TRUE if the double-buffered visual is supported, + + + Attach an OpenGL rendering context to a @gldrawable. + + TRUE if it is successful, FALSE otherwise. + + + + + a #GdkGLContext. + + + + - - - - - + Exchange front and back buffers. + Complete GDK drawing execution prior to subsequent OpenGL calls. - - - - - - - - - - - + + Complete OpenGL execution prior to subsequent GDK drawing calls. - - - - - - - - - - - - - - - - - - - @@ -758,161 +815,159 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_EVENT_MASK" glib:nick="event-mask"/> - - + + - - - - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - - + + + + - + - + - + - - + + - - + + - @@ -925,7 +980,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_PBUFFER" glib:nick="pbuffer"/> - @@ -942,7 +997,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_PBUFFER_BIT" glib:nick="pbuffer-bit"/> - @@ -951,7 +1006,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_PBUFFER_CLOBBER_MASK" glib:nick="mask"/> - @@ -964,7 +1019,10 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_SAVED" glib:nick="saved"/> - + + + @@ -985,37 +1043,116 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_PBUFFER_WIDTH" glib:nick="width"/> - + glib:type-struct="PixmapClass"> + Creates an off-screen rendering area. +attrib_list is currently unused. This must be set to NULL or empty +(first attribute of None). See GLX 1.3 spec. - + the new #GdkGLPixmap. + - + a #GdkGLConfig. + + the #GdkPixmap to be used as the rendering area. - + transfer-ownership="none" + allow-none="1"> + this must be set to NULL or empty (first attribute of None). + + + - + + Returns the #GdkGLPixmap held by the @pixmap. + + the #GdkGLPixmap. + + + + + a #GdkPixmap. + + + + + + Returns whether the @pixmap is OpenGL-capable. + + TRUE if the @pixmap is OpenGL-capable, FALSE otherwise. + + + + + a #GdkPixmap. + + + + + + Set the OpenGL-capability to the @pixmap. +This function creates a new #GdkGLPixmap held by the @pixmap. +attrib_list is currently unused. This must be set to NULL or empty +(first attribute of None). +NULL otherwise. + + the #GdkGLPixmap used by the @pixmap if it is successful, + + + + + the #GdkPixmap to be used as the rendering area. + + + + a #GdkGLConfig. + + + + this must be set to NULL or empty (first attribute of None). + + + + + + + + Unset the OpenGL-capability of the @pixmap. +This function destroys the #GdkGLPixmap held by the @pixmap. - + + + a #GdkPixmap. + + + + - + Returns the #GdkPixmap associated with @glpixmap. +Notice that #GdkGLPixmap is not #GdkPixmap, but another +#GdkDrawable which have an associated #GdkPixmap. + + the #GdkPixmap associated with @glpixmap. @@ -1026,19 +1163,19 @@ and/or use gtk-doc annotations. --> - + glib:is-gtype-struct-for="Pixmap"> - + - @@ -1051,7 +1188,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_COLOR_INDEX_TYPE" glib:nick="color-index-type"/> - @@ -1064,7 +1201,10 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_COLOR_INDEX_BIT" glib:nick="color-index-bit"/> - + + + @@ -1081,7 +1221,7 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_TRANSPARENT_INDEX" glib:nick="index"/> - @@ -1114,37 +1254,116 @@ and/or use gtk-doc annotations. --> c:identifier="GDK_GL_STATIC_GRAY" glib:nick="static-gray"/> - + glib:type-struct="WindowClass"> + Creates an on-screen rendering area. +attrib_list is currently unused. This must be set to NULL or empty +(first attribute of None). See GLX 1.3 spec. - + the new #GdkGLWindow. + - + a #GdkGLConfig. + + the #GdkWindow to be used as the rendering area. - + transfer-ownership="none" + allow-none="1"> + this must be set to NULL or empty (first attribute of None). + + + - + + Returns the #GdkGLWindow held by the @window. + + the #GdkGLWindow. + + + + + a #GdkWindow. + + + + + + Returns whether the @window is OpenGL-capable. + + TRUE if the @window is OpenGL-capable, FALSE otherwise. + + + + + a #GdkWindow. + + + + + + Set the OpenGL-capability to the @window. +This function creates a new #GdkGLWindow held by the @window. +attrib_list is currently unused. This must be set to NULL or empty +(first attribute of None). +NULL otherwise. + + the #GdkGLWindow used by the @window if it is successful, + + + + + the #GdkWindow to be used as the rendering area. + + + + a #GdkGLConfig. + + + + this must be set to NULL or empty (first attribute of None). + + + + + + + + Unset the OpenGL-capability of the @window. +This function destroys the #GdkGLWindow held by the @window. - + + + a #GdkWindow. + + + + - + Returns the #GdkWindow associated with @glwindow. +Notice that #GdkGLWindow is not #GdkWindow, but another +#GdkDrawable which have an associated #GdkWindow. + + the #GdkWindow associated with @glwindow. @@ -1155,372 +1374,226 @@ and/or use gtk-doc annotations. --> - + glib:is-gtype-struct-for="Window"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns the current #GdkGLDrawable. + + the current #GdkGLDrawable or NULL if there is no current drawable. + - - - + + Returns the GtkGLExt library binary age. + + The binary age of the GtkGLExt library. + - - - - - - - - - - - - - - - - - + + Returns the GtkGLExt library interface age. + + The interface age of the GtkGLExt library. + + + + + Returns the GtkGLExt library major version number. + + The major version number of the GtkGLExt library. + + + + + Returns the GtkGLExt library micro version number. + + The micro version number of the GtkGLExt library. + + + + + Returns the GtkGLExt library minor version number. + + The minor version number of the GtkGLExt library. + + + + + Returns the address of the OpenGL, GLU, or GLX function. + + the address of the function named by @proc_name. + + function name. - + + Call this function before using any other GdkGLExt functions in your +applications. It will initialize everything needed to operate the +library and parses some standard command line options. @argc and +standard arguments. +<note><para>This function will terminate your program if it was +unable to initialize the library for some reason. If you want your +program to fall back to a textual interface you want to call +gdk_gl_init_check() instead.</para></note> - - + + Address of the <parameter>argc</parameter> parameter of your main() function. Changed if any arguments were handled. + - - + + Address of the <parameter>argv</parameter> parameter of main(). Any parameters understood by gdk_gl_init() are stripped before return. + + + - + + This function does the same work as gdk_gl_init() with only +initialized. Instead it returns %FALSE on failure. +This way the application can fall back to some other means of communication +with the user - for example a curses or command line interface. +%FALSE otherwise. - + %TRUE if the GUI has been successfully initialized, + - - + + Address of the <parameter>argc</parameter> parameter of your <function>main()</function> function. Changed if any arguments were handled. + - - + + Address of the <parameter>argv</parameter> parameter of <function>main()</function>. Any parameters understood by gdk_gl_init() are stripped before return. + + + - + + Indicates whether the window system supports the OpenGL extension +(GLX, WGL, etc.). - + TRUE if OpenGL is supported, FALSE otherwise. + + + + + Indicates whether the window system supports the OpenGL extension +(GLX, WGL, etc.). + + TRUE if OpenGL is supported, FALSE otherwise. + - - - - - + + the #GdkDisplay where the query is sent to. + - - - - - - + Determines whether a given OpenGL extension is supported. +There must be a valid current rendering context to call +gdk_gl_query_gl_extension(). +gdk_gl_query_gl_extension() returns information about OpenGL extensions +only. This means that window system dependent extensions (for example, +GLX extensions) are not reported by gdk_gl_query_gl_extension(). +supported. - + TRUE if the OpenGL extension is supported, FALSE if not + + name of OpenGL extension. - + + Returns the version numbers of the OpenGL extension to the window system. +In the X Window System, it returns the GLX version. +In the Microsoft Windows, it returns the Windows version. - + FALSE if it fails, TRUE otherwise. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + caller-allocates="0" + transfer-ownership="full"> + returns the major version number of the OpenGL extension. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + caller-allocates="0" + transfer-ownership="full"> + returns the minor version number of the OpenGL extension. + - + + Returns the version numbers of the OpenGL extension to the window system. +In the X Window System, it returns the GLX version. +In the Microsoft Windows, it returns the Windows version. - + FALSE if it fails, TRUE otherwise. + - - + + the #GdkDisplay where the query is sent to. + + + + returns the major version number of the OpenGL extension. + + + + returns the minor version number of the OpenGL extension. + diff --git a/basis/gdk/gl/ffi/ffi.factor b/basis/gdk/gl/ffi/ffi.factor index 74fa46a3b7..27ea883919 100644 --- a/basis/gdk/gl/ffi/ffi.factor +++ b/basis/gdk/gl/ffi/ffi.factor @@ -1,11 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system vocabs.parser words -gobject-introspection gdk.ffi gdk.pixbuf.ffi gio.ffi glib.ffi -gmodule.ffi gobject.ffi pango.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gdk.gl.ffi +<< +"gdk.ffi" require +>> + +LIBRARY: gdk.gl + << "gdk.gl" { { [ os winnt? ] [ drop ] } @@ -14,7 +18,4 @@ IN: gdk.gl.ffi } cond >> -<< ulong "unsigned long" current-vocab create typedef >> - -GIR: vocab:gdk/gl/GdkGL-1.0.gir - +GIR: vocab:gdk/gl/GdkGLExt-1.0.gir diff --git a/basis/gdk/pixbuf/GdkPixbuf-2.0.gir b/basis/gdk/pixbuf/GdkPixbuf-2.0.gir index 4c73110402..7775a9130a 100644 --- a/basis/gdk/pixbuf/GdkPixbuf-2.0.gir +++ b/basis/gdk/pixbuf/GdkPixbuf-2.0.gir @@ -2,7 +2,7 @@ - @@ -13,7 +13,8 @@ and/or use gtk-doc annotations. --> + c:identifier-prefixes="Gdk" + c:symbol-prefixes="gdk"> c:identifier="GDK_COLORSPACE_RGB" glib:nick="rgb"/> - - - c:identifier="GDK_INTERP_HYPER" glib:nick="hyper"/> - - + + - - + + - - + + - - + + + + + + + + - + - + Creates a new #GdkPixbuf structure and allocates a buffer for it. The buffer has an optimal rowstride. Note that the buffer is not cleared; you will have to fill it completely yourself. -%NULL if not enough memory could be allocated for the image buffer."> +%NULL if not enough memory could be allocated for the image buffer. + A newly-created #GdkPixbuf with a reference count of 1, or + Color space for image - + Whether the image should have transparency information + - + Number of bits per color sample + - + Width of image in pixels, must be > 0 + - + Height of image in pixels, must be > 0 + - + + Creates a new #GdkPixbuf out of in-memory image data. Currently only RGB +images with 8 bits per sample are supported. + A newly-created #GdkPixbuf structure with a reference count of 1. - - + + Image data in 8-bit/sample packed format + - - + + Colorspace for the image data + - - + + Whether the data has an opacity channel + + + + Number of bits per sample + - + Width of the image in pixels, must be > 0 + - + Height of the image in pixels, must be > 0 + + + + Distance in bytes between row starts + + + + Function used to free the data when the pixbuf's reference count drops to zero, or %NULL if the data should not be freed + + + + Closure data to pass to the destroy notification function + + Creates a new pixbuf by loading an image from a file. The file format is detected automatically. If %NULL is returned, then @error will be set. Possible errors are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains. -there was no loader for the file's format, there was not enough memory to -allocate the image buffer, or the image file contained invalid data." - throws="1"> +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data. + A newly-created pixbuf with a reference count of 1, or %NULL if + Name of file to load, in the GLib file name encoding - - - - - - - - - - - - - - - - + Creates a new pixbuf by loading an image from a file. The file format is detected automatically. If %NULL is returned, then @error will be set. Possible errors are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains. The image will be scaled to fit in the requested size, optionally preserving -the image's aspect ratio. +the image's aspect ratio. When preserving the aspect ratio, a @width of -1 will cause the image to be scaled to the exact given height, and a @height of -1 will cause the image to be scaled to the exact given width. When not preserving -aspect ratio, a @width or @height of -1 means to not scale the image -at all in that dimension. Negative values for @width and @height are +aspect ratio, a @width or @height of -1 means to not scale the image +at all in that dimension. Negative values for @width and @height are allowed since 2.8. -there was no loader for the file's format, there was not enough memory to -allocate the image buffer, or the image file contained invalid data." - version="2.6" - throws="1"> +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data. + A newly-created pixbuf with a reference count of 1, or %NULL + Name of file to load, in the GLib file name encoding - + The width the image should have or -1 to not constrain the width + - + The height the image should have or -1 to not constrain the height + - + %TRUE to preserve the image's aspect ratio + - + + Creates a new pixbuf by loading an image from a file. +The file format is detected automatically. If %NULL is returned, then +#G_FILE_ERROR domains. +The image will be scaled to fit in the requested size, preserving +the image's aspect ratio. Note that the returned pixbuf may be smaller +than @width x @height, if the aspect ratio requires it. To load +and image at the requested size, regardless of aspect ratio, use +gdk_pixbuf_new_from_file_at_scale(). +%NULL if any of several error conditions occurred: the file could not +be opened, there was no loader for the file's format, there was not +enough memory to allocate the image buffer, or the image file contained +invalid data. + A newly-created pixbuf with a reference count of 1, or - - - - - - - - - - - - - + + Name of file to load, in the GLib file name encoding + - + The width the image should have or -1 to not constrain the width + - - - - - - - - - - - - - - - - - - - - - - + The height the image should have or -1 to not constrain the height + + Create a #GdkPixbuf from a flat representation that is suitable for storing as inline data in a program. This is useful if you want to -ship a program with images, but don't want to depend on any +ship a program with images, but don't want to depend on any external files. -GTK+ ships with a program called <command>gdk-pixbuf-csource</command> +gdk-pixbuf ships with a program called <command>gdk-pixbuf-csource</command> which allows for conversion of #GdkPixbufs into such a inline representation. In almost all cases, you should pass the <option>--raw</option> flag to <command>gdk-pixbuf-csource</command>. A sample invocation would be: @@ -276,264 +263,674 @@ In almost all cases, you should pass the <option>--raw</option> flag gdk-pixbuf-csource --raw --name=myimage_inline myimage.png </programlisting></informalexample> For the typical case where the inline pixbuf is read-only static data, -you don't need to copy the pixel data unless you intend to write to -it, so you can pass %FALSE for @copy_pixels. (If you pass -<option>--rle</option> to <command>gdk-pixbuf-csource</command>, a copy -will be made even if @copy_pixels is %FALSE, so using this option is +you don't need to copy the pixel data unless you intend to write to +it, so you can pass %FALSE for @copy_pixels. (If you pass +<option>--rle</option> to <command>gdk-pixbuf-csource</command>, a copy +will be made even if @copy_pixels is %FALSE, so using this option is generally a bad idea.) If you create a pixbuf from const inline data compiled into your -program, it's probably safe to ignore errors and disable length checks, +program, it's probably safe to ignore errors and disable length checks, since things will always succeed: <informalexample><programlisting> pixbuf = gdk_pixbuf_new_from_inline (-1, myimage_inline, FALSE, NULL); </programlisting></informalexample> -For non-const inline data, you could get out of memory. For untrusted -inline data located at runtime, you could have corrupt inline data in +For non-const inline data, you could get out of memory. For untrusted +inline data located at runtime, you could have corrupt inline data in addition. -count of 1, or %NULL if an error occurred." - throws="1"> +count of 1, or %NULL if an error occurred. + A newly-created #GdkPixbuf structure with a reference, - + Length in bytes of the @data argument or -1 to disable length checks + - - - + Byte data containing a serialized #GdkPixdata structure + - + Whether to copy the pixel data, or use direct pointers + + Creates a new pixbuf by loading an image from an input stream. +The file format is detected automatically. If %NULL is returned, then +from another thread. If the operation was cancelled, the error +%GIO_ERROR_CANCELLED will be returned. Other possible errors are in +the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains. +The stream is not closed. +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled. + A newly-created pixbuf, or %NULL if any of several error + a #GInputStream to load the pixbuf from + optional #GCancellable object, %NULL to ignore + Creates a new pixbuf by loading an image from an input stream. +The file format is detected automatically. If %NULL is returned, then +from another thread. If the operation was cancelled, the error +%GIO_ERROR_CANCELLED will be returned. Other possible errors are in +the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains. +The image will be scaled to fit in the requested size, optionally +preserving the image's aspect ratio. When preserving the aspect ratio, +a @width of -1 will cause the image to be scaled to the exact given +height, and a @height of -1 will cause the image to be scaled to the +exact given width. When not preserving aspect ratio, a @width or +The stream is not closed. +not supported, there was not enough memory to allocate the image buffer, +the stream contained invalid data, or the operation was cancelled. + A newly-created pixbuf, or %NULL if any of several error + a #GInputStream to load the pixbuf from - + The width the image should have or -1 to not constrain the width + - + The height the image should have or -1 to not constrain the height + - + %TRUE to preserve the image's aspect ratio + + optional #GCancellable object, %NULL to ignore - + + Creates a new pixbuf by parsing XPM data in memory. This data is commonly +the result of including an XPM file into a program's C source. - - - - - - + A newly-created pixbuf with a reference count of 1. + - - - - - - - - + + Pointer to inline XPM data. + - + - + Converts a #GdkPixdata to a #GdkPixbuf. If @copy_pixels is %TRUE or +if the pixel data is run-length-encoded, the pixel data is copied into +newly-allocated memory; otherwise it is reused. + + a new #GdkPixbuf. + a #GdkPixdata to convert into a #GdkPixbuf. - + whether to copy raw pixel data; run-length encoded pixel data is always copied. + - + + Parses an image file far enough to determine its format and size. +or %NULL if the image format wasn't recognized. The return value +is owned by GdkPixbuf and should not be freed. + A #GdkPixbufFormat describing the image format of the file + + + + + The name of the file to identify. + + + + Return location for the width of the image, or %NULL + + + + Return location for the height of the image, or %NULL + + + + + + Obtains the available information about the image formats supported +by GdkPixbuf. +#GdkPixbufFormat<!-- -->s describing the supported +image formats. The list should be freed when it is no longer needed, +but the structures themselves are owned by #GdkPixbuf and should not be +freed. + + A list of + + + + + + + + + + + + + + + + + Takes an existing pixbuf and adds an alpha channel to it. +If the existing pixbuf already had an alpha channel, the channel +values are copied from the original; otherwise, the alpha channel +is initialized to 255 (full opacity). +If @substitute_color is %TRUE, then the color specified by (@r, @g, @b) will be +assigned zero opacity. That is, if you pass (255, 255, 255) for the +substitute color, all white pixels will become fully transparent. + + A newly-created pixbuf with a reference count of 1. + + + + + Whether to set a color to zero opacity. If this is %FALSE, then the (@r, @g, @b) arguments will be ignored. + + + + Red value to substitute. + + + + Green value to substitute. + + + + Blue value to substitute. + + + + + + Takes an existing pixbuf and checks for the presence of an +associated "orientation" option, which may be provided by the +jpeg loader (which reads the exif orientation tag) or the +tiff loader (which reads the tiff orientation tag, and +compensates it for the partial transforms performed by +libtiff). If an orientation option/tag is present, the +appropriate transform will be performed so that the pixbuf +is oriented correctly. +input pixbuf (with an increased reference count). + + A newly-created pixbuf, or a reference to the - + + Creates a transformation of the source image @src by scaling by +This gives an image in the coordinates of the destination pixbuf. +The rectangle (@dest_x, @dest_y, @dest_width, @dest_height) +is then composited onto the corresponding rectangle of the +original destination image. +When the destination rectangle contains parts not in the source +image, the data at the edges of the source image is replicated +to infinity. +<figure id="pixbuf-composite-diagram"> +<title>Compositing of pixbufs</title> +<graphic fileref="composite.png" format="PNG"/> +</figure> + + + the #GdkPixbuf into which to render the results + + + + the left coordinate for region to render + + + + the top coordinate for region to render + + + + the width of the region to render + + + + the height of the region to render + + + + the offset in the X direction (currently rounded to an integer) + + + + the offset in the Y direction (currently rounded to an integer) + + + + the scale factor in the X direction + + + + the scale factor in the Y direction + + + + the interpolation type for the transformation. + + + + overall alpha for source image (0..255) + + + - + + Creates a transformation of the source image @src by scaling by +then composites the rectangle (@dest_x ,@dest_y, @dest_width, +colors @color1 and @color2 and renders it onto the destination +image. +See gdk_pixbuf_composite_color_simple() for a simpler variant of this +function suitable for many tasks. + + + + + + the #GdkPixbuf into which to render the results + + + + the left coordinate for region to render + + + + the top coordinate for region to render + + + + the width of the region to render + + + + the height of the region to render + + + + the offset in the X direction (currently rounded to an integer) + + + + the offset in the Y direction (currently rounded to an integer) + + + + the scale factor in the X direction + + + + the scale factor in the Y direction + + + + the interpolation type for the transformation. + + + + overall alpha for source image (0..255) + + + + the X offset for the checkboard (origin of checkboard is at -@check_x, -@check_y) + + + + the Y offset for the checkboard + + + + the size of checks in the checkboard (must be a power of two) + + + + the color of check at upper left + + + + the color of the other check + + + + + + Creates a new #GdkPixbuf by scaling @src to @dest_width x +allocated for it. - + the new #GdkPixbuf, or %NULL if not enough memory could be + + + + the width of destination image + + + + the height of destination image + + + + the interpolation type for the transformation. + + + + overall alpha for source image (0..255) + + + + the size of checks in the checkboard (must be a power of two) + + + + the color of check at upper left + + + + the color of the other check + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Creates a new #GdkPixbuf with a copy of the information in the specified +not enough memory could be allocated. + A newly-created pixbuf with a reference count of 1, or %NULL if - + + Copies a rectangular area from @src_pixbuf to @dest_pixbuf. Conversion of +pixbuf formats is done automatically. +If the source rectangle overlaps the destination rectangle on the +same pixbuf, it will be overwritten during the copy operation. +Therefore, you can not use this function to scroll a pixbuf. + + + + + + Source X coordinate within @src_pixbuf. + + + + Source Y coordinate within @src_pixbuf. + + + + Width of the area to copy. + + + + Height of the area to copy. + + + + Destination pixbuf. + + + + X coordinate within @dest_pixbuf. + + + + Y coordinate within @dest_pixbuf. + + + + + + Clears a pixbuf to the given RGBA value, converting the RGBA value into +the pixbuf's pixel format. The alpha will be ignored if the pixbuf +doesn't have an alpha channel. - + RGBA pixel to clear to (0xffffffff is opaque white, 0x00000000 transparent black) + - + Flips a pixbuf horizontally or vertically and returns the +result in a new pixbuf. +allocated for it. + + the new #GdkPixbuf, or %NULL if not enough memory could be + + + + + %TRUE to flip horizontally, %FALSE to flip vertically + + + + + + Queries the number of bits per color sample in a pixbuf. + + Number of bits per color sample. + + + + + Queries the color space of a pixbuf. + + Color space. + + + + + Queries whether a pixbuf has an alpha channel (opacity information). + + %TRUE if it has an alpha channel, %FALSE otherwise. + + + + + Queries the height of a pixbuf. + + Height in pixels. + + + + + Queries the number of channels of a pixbuf. + + Number of channels. + + + + + Looks up @key in the list of options that may have been attached to the +function using gdk_pixbuf_set_option(). +For instance, the ANI loader provides "Title" and "Artist" options. +The ICO, XBM, and XPM loaders provide "x_hot" and "y_hot" hot-spot +options for cursor definitions. The PNG loader provides the tEXt ancillary +chunk key/value pairs as options. Since 2.12, the TIFF and JPEG loaders +return an "orientation" option string that corresponds to the embedded +TIFF/Exif orientation tag (if present). +string that should not be freed or %NULL if @key was not found. + + the value associated with @key. This is a nul-terminated + + + + + a nul-terminated string. + + + + + + Queries a pointer to the pixel data of a pixbuf. +for information about how the pixel data is stored in +memory. + + A pointer to the pixbuf's pixel data. Please see <xref linkend="image-data"/> + + + + + Queries the rowstride of a pixbuf, which is the number of bytes between the start of a row +and the start of the next row. + + Distance between row starts. + + + + + Queries the width of a pixbuf. + + Width in pixels. + + + + + Creates a new pixbuf which represents a sub-region of +original pixbuf, so writing to one affects both. +The new pixbuf holds a reference to @src_pixbuf, so +is finalized. + + a new pixbuf + + + + + X coord in @src_pixbuf + + + + Y coord in @src_pixbuf + + + + width of region in @src_pixbuf + + + + height of region in @src_pixbuf + + + + + + Adds a reference to a pixbuf. + + The same as the @pixbuf argument. + + + + + Rotates a pixbuf by a multiple of 90 degrees, and returns the +result in a new pixbuf. +allocated for it. + + the new #GdkPixbuf, or %NULL if not enough memory could be + + + + + the angle to rotate by + + + + + + Modifies saturation and optionally pixelates @src, placing the result in +saturation is reduced (the image turns toward grayscale); if greater than +1.0, saturation is increased (the image gets more vivid colors). If @pixelate +is %TRUE, then pixels are faded in a checkerboard pattern to create a +pixelated image. @src and @dest must have the same image format, size, and +rowstride. + + + + + + place to write modified version of @src + + + + saturation factor + + + + whether to pixelate + + + + + + Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico" +and "bmp" are possible file formats to save in, but more formats may be +installed. The list of all writable formats can be determined in the following way: |[ void add_if_writable (GdkPixbufFormat *data, GSList **list) @@ -546,55 +943,56 @@ GSList *writable_formats = NULL; g_slist_foreach (formats, add_if_writable, &writable_formats); g_slist_free (formats); ]| -If @error is set, %FALSE will be returned. Possible errors include +If @error is set, %FALSE will be returned. Possible errors include those in the #GDK_PIXBUF_ERROR domain and those in the #G_FILE_ERROR domain. The variable argument list should be %NULL-terminated; if not empty, it should contain pairs of strings that modify the save parameters. For example: <informalexample><programlisting> -gdk_pixbuf_save (pixbuf, handle, "jpeg", &amp;error, -"quality", "100", NULL); +gdk_pixbuf_save (pixbuf, handle, "jpeg", &amp;error, +"quality", "100", NULL); </programlisting></informalexample> Currently only few parameters exist. JPEG images can be saved with a -"quality" parameter; its value should be in the range [0,100]. +"quality" parameter; its value should be in the range [0,100]. Text chunks can be attached to PNG images by specifying parameters of -the form "tEXt::key", where key is an ASCII string of length 1-79. +the form "tEXt::key", where key is an ASCII string of length 1-79. The values are UTF-8 encoded strings. The PNG compression level can -be specified using the "compression" parameter; it's value is in an +be specified using the "compression" parameter; it's value is in an integer in the range of [0,9]. ICC color profiles can also be embedded into PNG and TIFF images. -The "icc-profile" value should be the complete ICC profile encoded +The "icc-profile" value should be the complete ICC profile encoded into base64. <informalexample><programlisting> gchar *contents; gchar *contents_encode; gsize length; -g_file_get_contents ("/home/hughsie/.color/icc/L225W.icm", &contents, &length, NULL); +g_file_get_contents ("/home/hughsie/.color/icc/L225W.icm", &contents, &length, NULL); contents_encode = g_base64_encode ((const guchar *) contents, length); -gdk_pixbuf_save (pixbuf, handle, "png", &amp;error, -"icc-profile", contents_encode, +gdk_pixbuf_save (pixbuf, handle, "png", &amp;error, +"icc-profile", contents_encode, NULL); </programlisting></informalexample> -TIFF images recognize a "compression" option which acceps an integer value. +TIFF images recognize a "compression" option which acceps an integer value. Among the codecs are 1 None, 2 Huffman, 5 LZW, 7 JPEG and 8 Deflate, see the libtiff documentation and tiff.h for all supported codec values. -ICO images can be saved in depth 16, 24, or 32, by using the "depth" -parameter. When the ICO saver is given "x_hot" and "y_hot" parameters, -it produces a CUR instead of an ICO."> +ICO images can be saved in depth 16, 24, or 32, by using the "depth" +parameter. When the ICO saver is given "x_hot" and "y_hot" parameters, +it produces a CUR instead of an ICO. - + whether an error was set + + name of file to save. + name of file format. - + + return location for error, or %NULL @@ -603,141 +1001,37 @@ it produces a CUR instead of an ICO."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Saves pixbuf to a new buffer in format @type, which is currently "jpeg", +"png", "tiff", "ico" or "bmp". This is a convenience function that uses +gdk_pixbuf_save_to_callback() to do the real work. Note that the buffer is not nul-terminated and may contain embedded nuls. If @error is set, %FALSE will be returned and @buffer will be set to %NULL. Possible errors include those in the #GDK_PIXBUF_ERROR domain. -See gdk_pixbuf_save() for more details." - version="2.4"> +See gdk_pixbuf_save() for more details. - + whether an error was set + - - - + location to receive a pointer to the new buffer. + - - + + location to receive the size of the new buffer. + + name of file format. - + + return location for error, or %NULL @@ -748,43 +1042,121 @@ See gdk_pixbuf_save() for more details." + Saves pixbuf to a new buffer in format @type, which is currently "jpeg", +"tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer() +for more details. - + whether an error was set + - - - + location to receive a pointer to the new buffer. + - - + + location to receive the size of the new buffer. + + name of file format. - - - + name of options to set, %NULL-terminated + - - - + values for named options + - + + Saves pixbuf in format @type by feeding the produced data to a +callback. Can be used when you want to store the image to something +other than a file, such as an in-memory buffer or a socket. +If @error is set, %FALSE will be returned. Possible errors +include those in the #GDK_PIXBUF_ERROR domain and whatever the save +function generates. +See gdk_pixbuf_save() for more details. - + whether an error was set + + + + + a function that is called to save each block of data that the save routine generates. + + + + user data to pass to the save function. + + + + name of file format. + + + + return location for error, or %NULL + + + + + + + + + + Saves pixbuf to a callback in format @type, which is currently "jpeg", +"png", "tiff", "ico" or "bmp". If @error is set, %FALSE will be returned. See +gdk_pixbuf_save_to_callback () for more details. + + whether an error was set + + + + + a function that is called to save each block of data that the save routine generates. + + + + user data to pass to the save function. + + + + name of file format. + + + + name of options to set, %NULL-terminated + + + + values for named options + + + + + + + @@ -807,292 +1179,91 @@ for more details." - - - - - - - - - - - - - - - - - - - - + + Saves pixbuf to a file in @type, which is currently "jpeg", "png", "tiff", "ico" or "bmp". +If @error is set, %FALSE will be returned. +See gdk_pixbuf_save () for more details. - + whether an error was set + - - + + name of file to save. + - - + + name of file format. + - - + + name of options to set, %NULL-terminated + - - - - - - - - - - - + + values for named options + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a transformation of the source image @src by scaling by then renders the rectangle (@dest_x, @dest_y, @dest_width, replacing the previous contents. Try to use gdk_pixbuf_scale_simple() first, this function is the industrial-strength power tool you can fall back to if -gdk_pixbuf_scale_simple() isn't powerful enough. +gdk_pixbuf_scale_simple() isn't powerful enough. If the source rectangle overlaps the destination rectangle on the same pixbuf, it will be overwritten during the scaling which -results in rendering artifacts."> +results in rendering artifacts. + the #GdkPixbuf into which to render the results - + the left coordinate for region to render + - + the top coordinate for region to render + - + the width of the region to render + - + the height of the region to render + - + the offset in the X direction (currently rounded to an integer) + - + the offset in the Y direction (currently rounded to an integer) + - + the scale factor in the X direction + - + the scale factor in the Y direction + + the interpolation type for the transformation. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Create a new #GdkPixbuf containing a copy of @src scaled to should be #GDK_INTERP_NEAREST if you want maximum speed (but when scaling down #GDK_INTERP_NEAREST is usually unusably ugly). The default @interp_type should be #GDK_INTERP_BILINEAR which offers @@ -1101,137 +1272,111 @@ You can scale a sub-portion of @src by creating a sub-pixbuf pointing into @src; see gdk_pixbuf_new_subpixbuf(). For more complicated scaling/compositing see gdk_pixbuf_scale() and gdk_pixbuf_composite(). -allocated for it."> +allocated for it. + the new #GdkPixbuf, or %NULL if not enough memory could be - + the width of destination image + - + the height of destination image + + the interpolation type for the transformation. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Attaches a key/value pair as an option to a #GdkPixbuf. If %key already +exists in the list of options attached to @pixbuf, the new value is +ignored and %FALSE is returned. - + %TRUE on success. + + a nul-terminated string. + a nul-terminated string. + + Removes a reference from a pixbuf. + + + + - + transfer-ownership="none"> + The number of bits per sample. +Currently only 8 bit per sample are supported. + - - + + - - + + - - + + - + transfer-ownership="none"> + The number of samples per pixel. +Currently, only 3 or 4 samples per pixel are supported. + - - + + + The number of bytes between the start of a row and the start of the next row. This number must (obviously) -be at least as large as the width of the pixbuf."> - +be at least as large as the width of the pixbuf. + - - + + glib:nick="full"/> glib:type-struct="PixbufAnimationClass"> + Creates a new animation by loading it from a file. The file format is +detected automatically. If the file's format does not support multi-frame images, then an animation with a single frame will be created. Possible errors are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains. -there was no loader for the file's format, there was not enough memory to -allocate the image buffer, or the image file contained invalid data." - throws="1"> +there was no loader for the file's format, there was not enough memory to +allocate the image buffer, or the image file contained invalid data. + A newly-created animation with a reference count of 1, or %NULL + Name of file to load, in the GLib file name encoding - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Get an iterator for displaying an animation. The iterator provides the frames that should be displayed at a given time. It should be freed after use with g_object_unref(). marks the beginning of animation playback. After creating an iterator, you should immediately display the pixbuf returned by gdk_pixbuf_animation_iter_get_pixbuf(). Then, you should install a timeout (with g_timeout_add()) or by some other mechanism ensure -that you'll update the image after +that you'll update the image after gdk_pixbuf_animation_iter_get_delay_time() milliseconds. Each time the image is updated, you should reinstall the timeout with the new, possibly-changed delay time. @@ -1376,7 +1436,7 @@ g_get_current_time() will be used automatically. To update the image (i.e. possibly change the result of gdk_pixbuf_animation_iter_get_pixbuf() to a new frame of the animation), call gdk_pixbuf_animation_iter_advance(). -If you're using #GdkPixbufLoader, in addition to updating the image +If you're using #GdkPixbufLoader, in addition to updating the image after the delay time, you should also update it whenever you receive the area_updated signal and gdk_pixbuf_animation_iter_on_currently_loading_frame() returns @@ -1386,15 +1446,150 @@ a frame may also be modified after an area_updated signal, for example if the delay time for a frame is encoded in the data after the frame itself. So your timeout should be reinstalled after any area_updated signal. -A delay time of -1 is possible, indicating "infinite.""> +A delay time of -1 is possible, indicating "infinite." + an iterator to move over the animation + time when the animation starts playing + + + + + + + + + + + + + + + + If an animation is really just a plain image (has only one frame), +this function returns that image. If the animation is an animation, +this function returns a reasonable thing to display as a static +unanimated image, which might be the first frame, or something more +sophisticated. If an animation hasn't loaded any frames yet, this +function will return %NULL. + + unanimated image representing the animation + + + + + If you load a file with gdk_pixbuf_animation_new_from_file() and it turns +out to be a plain, unanimated image, then this function will return +%TRUE. Use gdk_pixbuf_animation_get_static_image() to retrieve +the image. + + %TRUE if the "animation" was really just an image + + + + + Queries the height of the bounding box of a pixbuf animation. + + Height of the bounding box of the animation. + + + + + Get an iterator for displaying an animation. The iterator provides +the frames that should be displayed at a given time. +It should be freed after use with g_object_unref(). +marks the beginning of animation playback. After creating an +iterator, you should immediately display the pixbuf returned by +gdk_pixbuf_animation_iter_get_pixbuf(). Then, you should install a +timeout (with g_timeout_add()) or by some other mechanism ensure +that you'll update the image after +gdk_pixbuf_animation_iter_get_delay_time() milliseconds. Each time +the image is updated, you should reinstall the timeout with the new, +possibly-changed delay time. +As a shortcut, if @start_time is %NULL, the result of +g_get_current_time() will be used automatically. +To update the image (i.e. possibly change the result of +gdk_pixbuf_animation_iter_get_pixbuf() to a new frame of the animation), +call gdk_pixbuf_animation_iter_advance(). +If you're using #GdkPixbufLoader, in addition to updating the image +after the delay time, you should also update it whenever you +receive the area_updated signal and +gdk_pixbuf_animation_iter_on_currently_loading_frame() returns +%TRUE. In this case, the frame currently being fed into the loader +has received new data, so needs to be refreshed. The delay time for +a frame may also be modified after an area_updated signal, for +example if the delay time for a frame is encoded in the data after +the frame itself. So your timeout should be reinstalled after any +area_updated signal. +A delay time of -1 is possible, indicating "infinite." + + an iterator to move over the animation + + + + + time when the animation starts playing + + + + + + If an animation is really just a plain image (has only one frame), +this function returns that image. If the animation is an animation, +this function returns a reasonable thing to display as a static +unanimated image, which might be the first frame, or something more +sophisticated. If an animation hasn't loaded any frames yet, this +function will return %NULL. + + unanimated image representing the animation + + + + + Queries the width of the bounding box of a pixbuf animation. + + Width of the bounding box of the animation. + + + + + If you load a file with gdk_pixbuf_animation_new_from_file() and it turns +out to be a plain, unanimated image, then this function will return +%TRUE. Use gdk_pixbuf_animation_get_static_image() to retrieve +the image. + + %TRUE if the "animation" was really just an image + + + + + Adds a reference to an animation. + + The same as the @animation argument. + + + + + Removes a reference from an animation. + + + @@ -1407,9 +1602,10 @@ A delay time of -1 is possible, indicating "infinite.""> - + - + %TRUE if the "animation" was really just an image + @@ -1419,8 +1615,9 @@ A delay time of -1 is possible, indicating "infinite.""> - - + + + unanimated image representing the animation @@ -1431,7 +1628,7 @@ A delay time of -1 is possible, indicating "infinite.""> - + @@ -1439,18 +1636,19 @@ A delay time of -1 is possible, indicating "infinite.""> - - + + - - + + - + + an iterator to move over the animation @@ -1458,6 +1656,7 @@ A delay time of -1 is possible, indicating "infinite.""> + time when the animation starts playing @@ -1465,100 +1664,144 @@ A delay time of -1 is possible, indicating "infinite.""> - - - - - - - - - - - - - - - + Possibly advances an animation to a new frame. Chooses the frame based +on the start time passed to gdk_pixbuf_animation_get_iter(). +must be greater than or equal to the time passed to +gdk_pixbuf_animation_get_iter(), and must increase or remain +unchanged each time gdk_pixbuf_animation_iter_get_pixbuf() is +called. That is, you can't go backward in time; animations only +play forward. +As a shortcut, pass %NULL for the current time and g_get_current_time() +will be invoked on your behalf. So you only need to explicitly pass +at double speed. +If this function returns %FALSE, there's no need to update the animation +display, assuming the display had been rendered prior to advancing; +if %TRUE, you need to call gdk_animation_iter_get_pixbuf() and update the +display with the new pixbuf. - + %TRUE if the image may need updating + + current time - + Gets the number of milliseconds the current pixbuf should be displayed, or -1 if the current pixbuf should be displayed forever. g_timeout_add() conveniently takes a timeout in milliseconds, so you can use a timeout -to schedule the next update."> +to schedule the next update. - + delay time in milliseconds (thousandths of a second) + - - + Gets the current pixbuf which should be displayed; the pixbuf will be the same size as the animation itself -(gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()). -This pixbuf should be displayed for +(gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()). +This pixbuf should be displayed for gdk_pixbuf_animation_iter_get_delay_time() milliseconds. The caller of this function does not own a reference to the returned pixbuf; the returned pixbuf will become invalid when the iterator advances to the next frame, which may happen anytime you call gdk_pixbuf_animation_iter_advance(). Copy the pixbuf to keep it -(don't just add a reference), as it may get recycled as you advance -the iterator."> - +(don't just add a reference), as it may get recycled as you advance +the iterator. + + the pixbuf to be displayed - - + Used to determine how to respond to the area_updated signal on #GdkPixbufLoader when loading an animation. area_updated is emitted for an area of the frame currently streaming in to the loader. So if -you're on the currently loading frame, you need to redraw the screen for -the updated area."> +you're on the currently loading frame, you need to redraw the screen for +the updated area. - + %TRUE if the frame we're on is partially loaded, or the last frame + - - + Possibly advances an animation to a new frame. Chooses the frame based on the start time passed to gdk_pixbuf_animation_get_iter(). must be greater than or equal to the time passed to gdk_pixbuf_animation_get_iter(), and must increase or remain unchanged each time gdk_pixbuf_animation_iter_get_pixbuf() is -called. That is, you can't go backward in time; animations only +called. That is, you can't go backward in time; animations only play forward. As a shortcut, pass %NULL for the current time and g_get_current_time() will be invoked on your behalf. So you only need to explicitly pass at double speed. -If this function returns %FALSE, there's no need to update the animation +If this function returns %FALSE, there's no need to update the animation display, assuming the display had been rendered prior to advancing; if %TRUE, you need to call gdk_animation_iter_get_pixbuf() and update the -display with the new pixbuf."> +display with the new pixbuf. - + %TRUE if the image may need updating + + current time + + Gets the number of milliseconds the current pixbuf should be displayed, +or -1 if the current pixbuf should be displayed forever. g_timeout_add() +conveniently takes a timeout in milliseconds, so you can use a timeout +to schedule the next update. + + delay time in milliseconds (thousandths of a second) + + + + + Gets the current pixbuf which should be displayed; the pixbuf will +be the same size as the animation itself +(gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()). +This pixbuf should be displayed for +gdk_pixbuf_animation_iter_get_delay_time() milliseconds. The caller +of this function does not own a reference to the returned pixbuf; +the returned pixbuf will become invalid when the iterator advances +to the next frame, which may happen anytime you call +gdk_pixbuf_animation_iter_advance(). Copy the pixbuf to keep it +(don't just add a reference), as it may get recycled as you advance +the iterator. + + the pixbuf to be displayed + + + + + Used to determine how to respond to the area_updated signal on +#GdkPixbufLoader when loading an animation. area_updated is emitted +for an area of the frame currently streaming in to the loader. So if +you're on the currently loading frame, you need to redraw the screen for +the updated area. + + %TRUE if the frame we're on is partially loaded, or the last frame + + + @@ -1570,9 +1813,10 @@ display with the new pixbuf."> - + - + delay time in milliseconds (thousandths of a second) + @@ -1583,8 +1827,9 @@ display with the new pixbuf."> - - + + + the pixbuf to be displayed @@ -1596,10 +1841,10 @@ display with the new pixbuf."> - + - + %TRUE if the frame we're on is partially loaded, or the last frame + @@ -1610,9 +1855,10 @@ display with the new pixbuf."> - + - + %TRUE if the image may need updating + @@ -1620,6 +1866,7 @@ display with the new pixbuf."> c:type="GdkPixbufAnimationIter*"/> + current time @@ -1632,12 +1879,10 @@ display with the new pixbuf."> - - - + - + @@ -1671,7 +1916,11 @@ display with the new pixbuf."> c:identifier="GDK_PIXBUF_ERROR_FAILED" glib:nick="failed"/> - + @@ -1691,108 +1940,132 @@ display with the new pixbuf."> - + - + - + + Creates a copy of @format +gdk_pixbuf_format_free() to free the resources when done - + the newly allocated copy of a #GdkPixbufFormat. Use + + + + + Frees the resources allocated when copying a #GdkPixbufFormat +using gdk_pixbuf_format_copy() + + + Returns a description of the format. + a description of the format. + + + + + Returns the filename extensions typically used for files in the +given format. +freed with g_strfreev() when it is no longer needed. + + a %NULL-terminated array of filename extensions which must be + + + + + + + Returns information about the license of the image loader for the format. The +returned string should be a shorthand for a wellknown license, e.g. "LGPL", +"GPL", "QPL", "GPL/QPL", or "other" to indicate some other license. This +string should be freed with g_free() when it's no longer needed. + + a string describing the license of @format. + Returns the mime types supported by the format. +g_strfreev() when it is no longer needed. + a %NULL-terminated array of mime types which must be freed with - + Returns the name of the format. - - - - - - - - - - - - - + the name of the format. + + Returns whether this image format is disabled. See +gdk_pixbuf_format_set_disabled(). - + whether this image format is disabled. + + + + + Returns whether this image format is scalable. If a file is in a +scalable format, it is preferable to load it at the desired size, +rather than loading it at the default size and scaling the +resulting pixbuf to the desired size. + + whether this image format is scalable. + + + + + Returns whether pixbufs can be saved in the given format. + + whether pixbufs can be saved in the given format. + + Disables or enables an image format. If a format is disabled, +gdk-pixbuf won't use the image loader for this format to load +images. Applications can use this to avoid using image loaders +with an inappropriate license, see gdk_pixbuf_format_get_license(). - + %TRUE to disable the format @format + - - - - - - + + Creates a new pixbuf loader object. + A newly-created pixbuf loader. - - - - - - - - - - + Creates a new pixbuf loader object that always attempts to parse +image data as if it were an image of mime type @mime_type, instead of +identifying the type automatically. Useful if you want an error if +the image isn't the expected mime type, for loading image formats +that can't be reliably identified by looking at the data, or if +the user manually forces a specific mime type. +The list of supported mime types depends on what image loaders +are installed, but typically "image/png", "image/jpeg", "image/gif", +"image/tiff" and "image/x-xpixmap" are among the supported mime types. +To obtain the full list of supported mime types, call +gdk_pixbuf_format_get_mime_types() on each of the #GdkPixbufFormat +structs returned by gdk_pixbuf_get_formats(). + A newly-created pixbuf loader. + the mime type to be loaded - + Creates a new pixbuf loader object that always attempts to parse +image data as if it were an image of type @image_type, instead of +identifying the type automatically. Useful if you want an error if +the image isn't the expected type, for loading image formats +that can't be reliably identified by looking at the data, or if +the user manually forces a specific type. +The list of supported image formats depends on what image loaders +are installed, but typically "png", "jpeg", "gif", "tiff" and +"xpm" are among the supported formats. To obtain the full list of +supported image formats, call gdk_pixbuf_format_get_name() on each +of the #GdkPixbufFormat structs returned by gdk_pixbuf_get_formats(). + + A newly-created pixbuf loader. + + + + + name of the image format to be loaded with the image + + + + + + Informs a pixbuf loader that no further writes with +gdk_pixbuf_loader_write() will occur, so that it can free its +internal loading structures. Also, tries to parse any data that +hasn't yet been parsed; if the remaining data is partial or +corrupt, an error will be returned. If %FALSE is returned, @error +will be set to an error from the #GDK_PIXBUF_ERROR or #G_FILE_ERROR +domains. If you're just cancelling a load rather than expecting it +to be finished, passing %NULL for @error to ignore it is +reasonable. +Remember that this does not unref the loader, so if you plan not to +use it anymore, please g_object_unref() it. + + %TRUE if all image data written so far was successfully + + + + + Queries the #GdkPixbufAnimation that a pixbuf loader is currently creating. +In general it only makes sense to call this function after the "area-prepared" +signal has been emitted by the loader. If the loader doesn't have enough +bytes yet (hasn't emitted the "area-prepared" signal) this function will +return %NULL. + + The #GdkPixbufAnimation that the loader is loading, or %NULL if + + + + - - + Obtains the available information about the format of the +currently loading image file. +by GdkPixbuf and should not be freed. + + A #GdkPixbufFormat or %NULL. The return value is owned + - - - - - - - - - - - - - - - - - - - - - - - - + Queries the #GdkPixbuf that a pixbuf loader is currently creating. In general it only makes sense to call this function after the -"area-prepared" signal has been emitted by the loader; this means +"area-prepared" signal has been emitted by the loader; this means that enough data has been read to know the size of the image that will be allocated. If the loader has not received enough data via gdk_pixbuf_loader_write(), then this function returns %NULL. The returned pixbuf will be the same in all future calls to the loader, so simply calling g_object_ref() should be sufficient to continue using it. Additionally, if the loader is an animation, it will -return the "static image" of the animation +return the "static image" of the animation (see gdk_pixbuf_animation_get_static_image()). -enough data has been read to determine how to create the image buffer."> - +enough data has been read to determine how to create the image buffer. + + The #GdkPixbuf that the loader is creating, or %NULL if not - - - - - - - - - - - - - + Causes the image to be scaled while it is loaded. The desired +image size can be determined relative to the original size of +the image by calling gdk_pixbuf_loader_set_size() from a +signal handler for the ::size-prepared signal. +Attempts to set the desired image size are ignored after the +emission of the ::size-prepared signal. + + + + + The desired width of the image being loaded. + + + + The desired height of the image being loaded. + + + + + + This will cause a pixbuf loader to parse the next @count bytes of +an image. It will return %TRUE if the data was loaded successfully, +and %FALSE if an error occurred. In the latter case, the loader +will be closed, and will not accept further writes. If %FALSE is +returned, @error will be set to an error from the #GDK_PIXBUF_ERROR +or #G_FILE_ERROR domains. +cannot parse the buffer. + + %TRUE if the write was successful, or %FALSE if the loader + + + + + Pointer to image data. + + + + Length of the @buf buffer in bytes. + + + - + - - - + + This signal is emitted when the pixbuf loader has allocated the +pixbuf in the desired size. After this signal is emitted, +applications can call gdk_pixbuf_loader_get_pixbuf() to fetch +the partially-loaded pixbuf. + + - + This signal is emitted when a significant area of the image being loaded has been updated. Normally it means that a complete scanline has been read in, but it could be a different area as well. Applications can use this signal to know when to repaint -areas of an image that is being loaded."> - - +areas of an image that is being loaded. + + - - + + X offset of upper-left corner of the updated area. + - - + + Y offset of upper-left corner of the updated area. + - - + + Width of updated area. + - - + + Height of updated area. + - + This signal is emitted when gdk_pixbuf_loader_close() is called. It can be used by different parts of an application to receive notification when an image loader is closed by the code that -drives it."> - - +drives it. + + - + This signal is emitted when the pixbuf loader has been fed the initial amount of data that is required to figure out the size -of the image that it will create. Applications can call +of the image that it will create. Applications can call gdk_pixbuf_loader_set_size() in response to this signal to set -the desired size to which the image should be scaled."> - - +the desired size to which the image should be scaled. + + - - + + the original width of the image + - - + + the original height of the image + @@ -2042,7 +2328,7 @@ the desired size to which the image should be scaled."> - + @@ -2051,16 +2337,16 @@ the desired size to which the image should be scaled."> - + - + - + @@ -2072,7 +2358,7 @@ the desired size to which the image should be scaled."> - + @@ -2081,22 +2367,22 @@ the desired size to which the image should be scaled."> - + - + - + - + - + @@ -2121,6 +2407,178 @@ the desired size to which the image should be scaled."> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2152,7 +2610,7 @@ the desired size to which the image should be scaled."> - + - + @@ -2177,14 +2635,14 @@ the desired size to which the image should be scaled."> - - + + - - + + - + @@ -2198,30 +2656,30 @@ the desired size to which the image should be scaled."> - + - + - + - + - + - + @@ -2253,24 +2711,25 @@ the desired size to which the image should be scaled."> - + - + - + glib:type-struct="PixbufSimpleAnimClass"> + Creates a new, empty animation. + a newly allocated #GdkPixbufSimpleAnim - + the width of the animation + - + the height of the animation + - + the speed of the animation, in frames per second + + Adds a new frame to @animation. The @pixbuf must +have the dimensions specified when the animation +was constructed. + the pixbuf to add - - - - - - - - - - + Gets whether @animation should loop indefinitely when it reaches the end. - + %TRUE if the animation loops forever, %FALSE otherwise + + + Sets whether @animation should loop indefinitely when it reaches the end. + + + + + + whether to loop the animation + + + + - + transfer-ownership="none"> + Whether the animation should loop when it reaches the end. + - + + A #GdkPixdata contains pixbuf information in a form suitable for +serialization and streaming. - + - + - + - + - + - + - + - - - - - - - - - - - - + Deserializes (reconstruct) a #GdkPixdata structure from a byte stream. The byte stream consists of a straightforward writeout of the #GdkPixdata fields in network byte order, plus the @pixel_data bytes the structure points to. The @pixdata contents are reconstructed byte by byte and are checked for validity. This function may fail with %GDK_PIXBUF_CORRUPT_IMAGE or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE. -%FALSE otherwise." - throws="1"> +%FALSE otherwise. - + Upon successful deserialization %TRUE is returned, + - + length of the stream used for deserialization. + - - - + stream of bytes containing a serialized #GdkPixdata structure. + - - + introspectable="0"> + Converts a #GdkPixbuf to a #GdkPixdata. If @use_rle is %TRUE, the +pixel data is run-length encoded into newly-allocated memory and a +pointer to that memory is returned. +for the run-length encoded pixel data, otherwise %NULL. + + If @ure_rle is %TRUE, a pointer to the newly-allocated memory + + the data to fill @pixdata with. - + whether to use run-length encoding for the pixel data. + + + + + + Serializes a #GdkPixdata structure into a byte stream. +The byte stream consists of a straightforward writeout of the +#GdkPixdata fields in network byte order, plus the @pixel_data +bytes the structure points to. +#GdkPixdata structure. + + A newly-allocated string containing the serialized + + + + + location to store the resulting stream length in. + + Generates C source code suitable for compiling images directly +into programs. +gdk-pixbuf ships with a program called <command>gdk-pixbuf-csource</command> which offers a command line interface to this function. -of @pixdata."> - +of @pixdata. + + a newly-allocated string containing the C source form + used for naming generated data structures or macros. + a #GdkPixdataDumpType determining the kind of C source to be generated. @@ -2481,16 +2949,9 @@ of @pixdata."> value="65536" c:identifier="GDK_PIXDATA_DUMP_RLE_DECODER"/> - + + one for the used colorspace, one for the width of the samples and one +for the encoding of the pixel data. @@ -2516,8 +2977,10 @@ for the encoding of the pixel data." value="251658240" c:identifier="GDK_PIXDATA_ENCODING_MASK"/> - - - + + + + + diff --git a/basis/gdk/pixbuf/ffi/ffi.factor b/basis/gdk/pixbuf/ffi/ffi.factor index a87ca77c3b..ecc73bd5d4 100644 --- a/basis/gdk/pixbuf/ffi/ffi.factor +++ b/basis/gdk/pixbuf/ffi/ffi.factor @@ -1,10 +1,15 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection gio.ffi glib.ffi gmodule.ffi gobject.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gdk.pixbuf.ffi +<< +"gio.ffi" require +>> + +LIBRARY: gdk.pixbuf + << "gdk.pixbuf" { { [ os winnt? ] [ "libgdk_pixbuf-2.0-0.dll" cdecl add-library ] } @@ -14,4 +19,3 @@ IN: gdk.pixbuf.ffi >> GIR: vocab:gdk/pixbuf/GdkPixbuf-2.0.gir - diff --git a/basis/gio/Gio-2.0.gir b/basis/gio/Gio-2.0.gir index 273e6f09be..df74801cb3 100644 --- a/basis/gio/Gio-2.0.gir +++ b/basis/gio/Gio-2.0.gir @@ -2,7 +2,7 @@ - @@ -14,255 +14,1320 @@ and/or use gtk-doc annotations. --> + c:identifier-prefixes="G" + c:symbol-prefixes="g"> + + + Activates the action. +the parameter type given at construction time). If the parameter +type was %NULL then @parameter must also be %NULL. + + + + + + the parameter to the activation + + + + + + Checks if @action is currently enabled. +An action must be enabled in order to be activated or in order to +have its state changed from outside callers. + + whether the action is enabled + + + + + Queries the name of @action. + + the name of the action + + + + + Queries the type of the parameter that must be given when activating +When activating the action using g_action_activate(), the #GVariant +given to that function must be of the type returned by this function. +In the case that this function returns %NULL, you must not give any +#GVariant, but %NULL instead. + + the parameter type + + + + + Queries the current state of @action. +If the action is not stateful then %NULL will be returned. If the +action is stateful then the type of the return value is the type +given by g_action_get_state_type(). +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the current state of the action + + + + + Requests a hint about the valid range of values for the state of +If %NULL is returned it either means that the action is not stateful +or that there is no hint about the valid range of values for the +state of the action. +If a #GVariant array is returned then each item in the array is a +returned then the tuple specifies the inclusive lower and upper bound +of valid values for the state. +In any case, the information is merely a hint. It may be possible to +have a state value outside of the hinted range and setting a value +within the range may fail. +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the state range hint + + + + + Queries the type of the state of @action. +g_action_new_stateful()) then this function returns the #GVariantType +of the state. This is the type of the initial value given as the +state. All calls to g_action_set_state() must give a #GVariant of +this type and g_action_get_state() will return a #GVariant of the +same type. +this function will return %NULL. In that case, g_action_get_state() +will return %NULL and you must not call g_action_set_state(). + + the state type, if the action is stateful + + + + + Request for the state of @action to be changed to @value. +The action must be stateful and @value must be of the correct type. +See g_action_get_state_type(). +This call merely requests a change. The action may refuse to change +its state or may change its state to something other than @value. +See g_action_get_state_hint(). +If the @value GVariant is floating, it is consumed. + + + + + + + + + + + Activates the action. +the parameter type given at construction time). If the parameter +type was %NULL then @parameter must also be %NULL. + + + + + + the parameter to the activation + + + + + + Checks if @action is currently enabled. +An action must be enabled in order to be activated or in order to +have its state changed from outside callers. + + whether the action is enabled + + + + + Queries the name of @action. + + the name of the action + + + + + Queries the type of the parameter that must be given when activating +When activating the action using g_action_activate(), the #GVariant +given to that function must be of the type returned by this function. +In the case that this function returns %NULL, you must not give any +#GVariant, but %NULL instead. + + the parameter type + + + + + Queries the current state of @action. +If the action is not stateful then %NULL will be returned. If the +action is stateful then the type of the return value is the type +given by g_action_get_state_type(). +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the current state of the action + + + + + Requests a hint about the valid range of values for the state of +If %NULL is returned it either means that the action is not stateful +or that there is no hint about the valid range of values for the +state of the action. +If a #GVariant array is returned then each item in the array is a +returned then the tuple specifies the inclusive lower and upper bound +of valid values for the state. +In any case, the information is merely a hint. It may be possible to +have a state value outside of the hinted range and setting a value +within the range may fail. +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the state range hint + + + + + Queries the type of the state of @action. +g_action_new_stateful()) then this function returns the #GVariantType +of the state. This is the type of the initial value given as the +state. All calls to g_action_set_state() must give a #GVariant of +this type and g_action_get_state() will return a #GVariant of the +same type. +this function will return %NULL. In that case, g_action_get_state() +will return %NULL and you must not call g_action_set_state(). + + the state type, if the action is stateful + + + + + Request for the state of @action to be changed to @value. +The action must be stateful and @value must be of the correct type. +See g_action_get_state_type(). +This call merely requests a change. The action may refuse to change +its state or may change its state to something other than @value. +See g_action_get_state_hint(). +If the @value GVariant is floating, it is consumed. + + + + + + the new state + + + + + + If @action is currently enabled. +If the action is disabled then calls to g_action_activate() and +g_action_set_state() have no effect. + + + + The name of the action. This is mostly meaningful for identifying +the action once it has been added to a #GActionGroup. + + + + The type of the parameter that must be given when activating the +action. + + + + The state of the action, or %NULL if the action is stateless. + + + + The #GVariantType of the state that the action has, or %NULL if the +action is stateless. + + + + + + Activate the named action within @action_group. +If the action is expecting a parameter, then the correct type of +parameter must be given as @parameter. If the action is expecting no +parameters then @parameter must be %NULL. See +g_action_group_get_parameter_type(). + + + + + + the name of the action to activate + + + + parameters to the activation + + + + + + Checks if the named action within @action_group is currently enabled. +An action must be enabled in order to be activated or in order to +have its state changed from outside callers. + + whether or not the action is currently enabled + + + + + the name of the action to query + + + + + + Queries the type of the parameter that must be given when activating +the named action within @action_group. +When activating the action using g_action_group_activate(), the +#GVariant given to that function must be of the type returned by this +function. +In the case that this function returns %NULL, you must not give any +#GVariant, but %NULL instead. +The parameter type of a particular action will never change but it is +possible for an action to be removed and for a new action to be added +with the same name but a different parameter type. + + the parameter type + + + + + the name of the action to query + + + + + + Queries the current state of the named action within @action_group. +If the action is not stateful then %NULL will be returned. If the +action is stateful then the type of the return value is the type +given by g_action_group_get_state_type(). +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the current state of the action + + + + + the name of the action to query + + + + + + Requests a hint about the valid range of values for the state of the +named action within @action_group. +If %NULL is returned it either means that the action is not stateful +or that there is no hint about the valid range of values for the +state of the action. +If a #GVariant array is returned then each item in the array is a +returned then the tuple specifies the inclusive lower and upper bound +of valid values for the state. +In any case, the information is merely a hint. It may be possible to +have a state value outside of the hinted range and setting a value +within the range may fail. +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the state range hint + + + + + the name of the action to query + + + + + + Queries the type of the state of the named action within +If the action is stateful then this function returns the +#GVariantType of the state. All calls to g_action_group_set_state() +must give a #GVariant of this type and g_action_group_get_state() +will return a #GVariant of the same type. +If the action is not stateful then this function will return %NULL. +In that case, g_action_group_get_state() will return %NULL and you +must not call g_action_group_set_state(). +The state type of a particular action will never change but it is +possible for an action to be removed and for a new action to be added +with the same name but a different state type. + + the state type, if the action is stateful + + + + + the name of the action to query + + + + + + Checks if the named action exists within @action_group. + + whether the named action exists + + + + + the name of the action to check for + + + + + + Lists the actions contained within @action_group. +The caller is responsible for freeing the list with g_strfreev() when +it is no longer required. +actions in the groupb + + a %NULL-terminated array of the names of the + + + + + + + Request for the state of the named action within @action_group to be +changed to @value. +The action must be stateful and @value must be of the correct type. +See g_action_group_get_state_type(). +This call merely requests a change. The action may refuse to change +its state or may change its state to something other than @value. +See g_action_group_get_state_hint(). +If the @value GVariant is floating, it is consumed. + + + + + + the name of the action to request the change on + + + + the new state + + + + + + Emits the #GActionGroup::action-added signal on @action_group. +This function should only be called by #GActionGroup implementations. + + + + + + the name of an action in the group + + + + + + Emits the #GActionGroup::action-enabled-changed signal on @action_group. +This function should only be called by #GActionGroup implementations. + + + + + + the name of an action in the group + + + + whether or not the action is now enabled + + + + + + Emits the #GActionGroup::action-removed signal on @action_group. +This function should only be called by #GActionGroup implementations. + + + + + + the name of an action in the group + + + + + + Emits the #GActionGroup::action-state-changed signal on @action_group. +This function should only be called by #GActionGroup implementations. + + + + + + the name of an action in the group + + + + the new state of the named action + + + + + + Activate the named action within @action_group. +If the action is expecting a parameter, then the correct type of +parameter must be given as @parameter. If the action is expecting no +parameters then @parameter must be %NULL. See +g_action_group_get_parameter_type(). + + + + + + the name of the action to activate + + + + parameters to the activation + + + + + + Checks if the named action within @action_group is currently enabled. +An action must be enabled in order to be activated or in order to +have its state changed from outside callers. + + whether or not the action is currently enabled + + + + + the name of the action to query + + + + + + Queries the type of the parameter that must be given when activating +the named action within @action_group. +When activating the action using g_action_group_activate(), the +#GVariant given to that function must be of the type returned by this +function. +In the case that this function returns %NULL, you must not give any +#GVariant, but %NULL instead. +The parameter type of a particular action will never change but it is +possible for an action to be removed and for a new action to be added +with the same name but a different parameter type. + + the parameter type + + + + + the name of the action to query + + + + + + Queries the current state of the named action within @action_group. +If the action is not stateful then %NULL will be returned. If the +action is stateful then the type of the return value is the type +given by g_action_group_get_state_type(). +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the current state of the action + + + + + the name of the action to query + + + + + + Requests a hint about the valid range of values for the state of the +named action within @action_group. +If %NULL is returned it either means that the action is not stateful +or that there is no hint about the valid range of values for the +state of the action. +If a #GVariant array is returned then each item in the array is a +returned then the tuple specifies the inclusive lower and upper bound +of valid values for the state. +In any case, the information is merely a hint. It may be possible to +have a state value outside of the hinted range and setting a value +within the range may fail. +The return value (if non-%NULL) should be freed with +g_variant_unref() when it is no longer required. + + the state range hint + + + + + the name of the action to query + + + + + + Queries the type of the state of the named action within +If the action is stateful then this function returns the +#GVariantType of the state. All calls to g_action_group_set_state() +must give a #GVariant of this type and g_action_group_get_state() +will return a #GVariant of the same type. +If the action is not stateful then this function will return %NULL. +In that case, g_action_group_get_state() will return %NULL and you +must not call g_action_group_set_state(). +The state type of a particular action will never change but it is +possible for an action to be removed and for a new action to be added +with the same name but a different state type. + + the state type, if the action is stateful + + + + + the name of the action to query + + + + + + Checks if the named action exists within @action_group. + + whether the named action exists + + + + + the name of the action to check for + + + + + + Lists the actions contained within @action_group. +The caller is responsible for freeing the list with g_strfreev() when +it is no longer required. +actions in the groupb + + a %NULL-terminated array of the names of the + + + + + + + Request for the state of the named action within @action_group to be +changed to @value. +The action must be stateful and @value must be of the correct type. +See g_action_group_get_state_type(). +This call merely requests a change. The action may refuse to change +its state or may change its state to something other than @value. +See g_action_group_get_state_hint(). +If the @value GVariant is floating, it is consumed. + + + + + + the name of the action to request the change on + + + + the new state + + + + + + Signals that a new action was just added to the group. This signal +is emitted after the action has been added and is now visible. + + + + + + the name of the action in @action_group + + + + + + Signals that the enabled status of the named action has changed. + + + + + + the name of the action in @action_group + + + + whether the action is enabled or not + + + + + + Signals that an action is just about to be removed from the group. +This signal is emitted before the action is removed, so the action +is still visible and can be queried from the signal handler. + + + + + + the name of the action in @action_group + + + + + + Signals that the state of the named action has changed. + + + + + + the name of the action in @action_group + + + + the new value of the state + + + + + + + The virtual function table for #GActionGroup. + + + + + + + whether the named action exists + + + + + + + + the name of the action to check for + + + + + + + + + a %NULL-terminated array of the names of the + + + + + + + + + + + + + + + whether or not the action is currently enabled + + + + + + + + the name of the action to query + + + + + + + + + the parameter type + + + + + + + + the name of the action to query + + + + + + + + + the state type, if the action is stateful + + + + + + + + the name of the action to query + + + + + + + + + the state range hint + + + + + + + + the name of the action to query + + + + + + + + + the current state of the action + + + + + + + + the name of the action to query + + + + + + + + + + + + + + + + the name of the action to request the change on + + + + the new state + + + + + + + + + + + + + + + + the name of the action to activate + + + + parameters to the activation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + the name of the action + + + + + + + + + + + + + the parameter type + + + + + + + + + + + + + the state type, if the action is stateful + + + + + + + + + + + + + the state range hint + + + + + + + + + + + + + whether the action is enabled + + + + + + + + + + + + + the current state of the action + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + the parameter to the activation + + + + + + + Information about an installed application and methods to launch +it (with file arguments). + + Adds a content type to the application information to indicate the +application is capable of opening files with the given content type. + + %TRUE on success, %FALSE on error. + + + + + a string. + + + + + + Obtains the information whether the #GAppInfo can be deleted. +See g_app_info_delete(). + + %TRUE if @appinfo can be deleted + + + + + Checks if a supported content type can be removed from an application. +content types from a given @appinfo, %FALSE if not. + + %TRUE if it is possible to remove supported + + + + + Tries to delete a #GAppInfo. +On some platforms, there may be a difference between user-defined +#GAppInfo<!-- -->s which can be deleted, and system-wide ones which +cannot. See g_app_info_can_delete(). + + %TRUE if @appinfo has been deleted + + + + Creates a duplicate of a #GAppInfo. + a duplicate of @appinfo. + Checks if two #GAppInfo<!-- -->s are equal. - + %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. + + the second #GAppInfo. - - - - - - + + Gets the commandline with which the application will be +started. +or %NULL if this information is not available + a string containing the @appinfo's commandline, + Gets a human-readable description of an installed application. +application @appinfo, or %NULL if none. + a string containing a description of the + + + + + Gets the display name of the application. The display name is often more +descriptive to the user than the name itself. +no display name is available. + + the display name of the application for @appinfo, or the name if + Gets the executable's name for the installed application. +binaries name + a string containing the @appinfo's application - + Gets the icon for the application. + + the default #GIcon for @appinfo. - + + Gets the ID of an application. An id is a string that +identifies the application. The exact format of the id is +platform dependent. For instance, on Unix this is the +desktop file id from the xdg menu specification. +Note that the returned ID may be %NULL, depending on how +the @appinfo has been constructed. - + a string containing the application's ID. + + + + + Gets the installed name of the application. + + the name of the application for @appinfo. + + + + + Launches the application. Passes @files to the launched application +as arguments, using the optional @launch_context to get information +about the details of the launcher (like what screen it is on). +On error, @error will be set accordingly. +To launch the application without arguments pass a %NULL @files list. +Note that even if the launch is successful the application launched +can fail to start if it runs into problems during startup. There is +no way to detect this. +Some URIs can be changed when passed through a GFile (for instance +unsupported uris with strange formats like mailto:), so if you have +a textual uri you want to pass in as argument, consider using +g_app_info_launch_uris() instead. +On UNIX, this function sets the <envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar> +environment variable with the path of the launched desktop file and +<envvar>GIO_LAUNCHED_DESKTOP_FILE_PID</envvar> to the process +id of the launched process. This can be used to ignore +<envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar>, should it be inherited +by further processes. The <envvar>DISPLAY</envvar> and +<envvar>DESKTOP_STARTUP_ID</envvar> environment variables are also +set, based on information provided in @launch_context. + + %TRUE on successful launch, %FALSE otherwise. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GAppLaunchContext or %NULL - - + + + Launches the application. Passes @uris to the launched application +as arguments, using the optional @launch_context to get information +about the details of the launcher (like what screen it is on). +On error, @error will be set accordingly. +To lauch the application without arguments pass a %NULL @uris list. +Note that even if the launch is successful the application launched +can fail to start if it runs into problems during startup. There is +no way to detect this. - - - - - - - - - - - + %TRUE on successful launch, %FALSE otherwise. + + a #GList containing URIs to launch. @@ -270,23 +1335,288 @@ it (with file arguments)." + a #GAppLaunchContext or %NULL + + + + + + Removes a supported type from an application, if possible. + + %TRUE on success, %FALSE on error. + + + + + a string. + + + + + + Sets the application as the default handler for the given file extension. + + %TRUE on success, %FALSE on error. + + + + + a string containing the file extension (without the dot). + + + + + + Sets the application as the default handler for a given type. + + %TRUE on success, %FALSE on error. + + + + + the content type. + + + + + + Checks if the application info should be shown in menus that +list available applications. + + %TRUE if the @appinfo should be shown, %FALSE otherwise. + + + + + Checks if the application accepts files as arguments. + + %TRUE if the @appinfo supports files. + + + + + Checks if the application supports reading files and directories from URIs. + + %TRUE if the @appinfo supports URIs. + + + + + Adds a content type to the application information to indicate the +application is capable of opening files with the given content type. + + %TRUE on success, %FALSE on error. + + + + + a string. + + + + + + Obtains the information whether the #GAppInfo can be deleted. +See g_app_info_delete(). + + %TRUE if @appinfo can be deleted + + + + + Checks if a supported content type can be removed from an application. +content types from a given @appinfo, %FALSE if not. + + %TRUE if it is possible to remove supported + + + + + Tries to delete a #GAppInfo. +On some platforms, there may be a difference between user-defined +#GAppInfo<!-- -->s which can be deleted, and system-wide ones which +cannot. See g_app_info_can_delete(). + + %TRUE if @appinfo has been deleted + + + + + Creates a duplicate of a #GAppInfo. + + a duplicate of @appinfo. + + + + + Checks if two #GAppInfo<!-- -->s are equal. + + %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. + + + + + the second #GAppInfo. + + + + + + Gets the commandline with which the application will be +started. +or %NULL if this information is not available + + a string containing the @appinfo's commandline, + + + + + Gets a human-readable description of an installed application. +application @appinfo, or %NULL if none. + + a string containing a description of the + + + + + Gets the display name of the application. The display name is often more +descriptive to the user than the name itself. +no display name is available. + + the display name of the application for @appinfo, or the name if + + + + + Gets the executable's name for the installed application. +binaries name + + a string containing the @appinfo's application + + + + + Gets the icon for the application. + + the default #GIcon for @appinfo. + + + + + Gets the ID of an application. An id is a string that +identifies the application. The exact format of the id is +platform dependent. For instance, on Unix this is the +desktop file id from the xdg menu specification. +Note that the returned ID may be %NULL, depending on how +the @appinfo has been constructed. + + a string containing the application's ID. + + + + + Gets the installed name of the application. + + the name of the application for @appinfo. + + + + + Launches the application. Passes @files to the launched application +as arguments, using the optional @launch_context to get information +about the details of the launcher (like what screen it is on). +On error, @error will be set accordingly. +To launch the application without arguments pass a %NULL @files list. +Note that even if the launch is successful the application launched +can fail to start if it runs into problems during startup. There is +no way to detect this. +Some URIs can be changed when passed through a GFile (for instance +unsupported uris with strange formats like mailto:), so if you have +a textual uri you want to pass in as argument, consider using +g_app_info_launch_uris() instead. +On UNIX, this function sets the <envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar> +environment variable with the path of the launched desktop file and +<envvar>GIO_LAUNCHED_DESKTOP_FILE_PID</envvar> to the process +id of the launched process. This can be used to ignore +<envvar>GIO_LAUNCHED_DESKTOP_FILE</envvar>, should it be inherited +by further processes. The <envvar>DISPLAY</envvar> and +<envvar>DESKTOP_STARTUP_ID</envvar> environment variables are also +set, based on information provided in @launch_context. + + %TRUE on successful launch, %FALSE otherwise. + + + + + a #GList of #GFile objects + + + + + + a #GAppLaunchContext or %NULL - - - - - - + Launches the application. Passes @uris to the launched application +as arguments, using the optional @launch_context to get information +about the details of the launcher (like what screen it is on). +On error, @error will be set accordingly. +To lauch the application without arguments pass a %NULL @uris list. +Note that even if the launch is successful the application launched +can fail to start if it runs into problems during startup. There is +no way to detect this. - + %TRUE on successful launch, %FALSE otherwise. + + + + + a #GList containing URIs to launch. + + + + + + a #GAppLaunchContext or %NULL + + + + + + Removes a supported type from an application, if possible. + + %TRUE on success, %FALSE on error. + + a string. @@ -294,61 +1624,61 @@ it (with file arguments)." + Sets the application as the default handler for the given file extension. - + %TRUE on success, %FALSE on error. + + a string containing the file extension (without the dot). - + Sets the application as the default handler for a given type. - + %TRUE on success, %FALSE on error. + + the content type. - + + Checks if the application info should be shown in menus that +list available applications. - + %TRUE if the @appinfo should be shown, %FALSE otherwise. + - + + Checks if the application accepts files as arguments. - - - - - - - - - - - + %TRUE if the @appinfo supports files. + - + + Checks if the application supports reading files and directories from URIs. - + %TRUE if the @appinfo supports URIs. + + Flags used when creating a #GAppInfo. + + glib:is-gtype-struct-for="AppInfo"> + Application Information interface, for operating system portability. - + + a duplicate of @appinfo. @@ -384,23 +1717,26 @@ Application Information interface, for operating system portability."> - + - + %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. + + the second #GAppInfo. - + + a string containing the application's ID. @@ -411,8 +1747,9 @@ Application Information interface, for operating system portability."> - + + the name of the application for @appinfo. @@ -423,8 +1760,9 @@ Application Information interface, for operating system portability."> - + + a string containing a description of the @@ -435,8 +1773,9 @@ Application Information interface, for operating system portability."> - + + a string containing the @appinfo's application @@ -447,8 +1786,9 @@ Application Information interface, for operating system portability."> - - + + + the default #GIcon for @appinfo. @@ -459,27 +1799,34 @@ Application Information interface, for operating system portability."> - + - + %TRUE on successful launch, %FALSE otherwise. + - + + + - + + a #GAppLaunchContext or %NULL - + - + %TRUE if the @appinfo supports URIs. + @@ -489,9 +1836,10 @@ Application Information interface, for operating system portability."> - + - + %TRUE if the @appinfo supports files. + @@ -501,27 +1849,35 @@ Application Information interface, for operating system portability."> - + - + %TRUE on successful launch, %FALSE otherwise. + - + a #GList containing URIs to launch. + + + - + + a #GAppLaunchContext or %NULL - + - + %TRUE if the @appinfo should be shown, %FALSE otherwise. + @@ -531,61 +1887,61 @@ Application Information interface, for operating system portability."> - + - + %TRUE on success, %FALSE on error. + + the content type. - + - + %TRUE on success, %FALSE on error. + + a string containing the file extension (without the dot). - + - + %TRUE on success, %FALSE on error. + + a string. - + - + %TRUE if it is possible to remove supported + @@ -595,26 +1951,27 @@ Application Information interface, for operating system portability."> - + - + %TRUE on success, %FALSE on error. + + a string. - + - + %TRUE if @appinfo can be deleted + @@ -624,9 +1981,10 @@ Application Information interface, for operating system portability."> - + - + %TRUE if @appinfo has been deleted + @@ -636,8 +1994,9 @@ Application Information interface, for operating system portability."> - + + a string containing the @appinfo's commandline, @@ -648,8 +2007,9 @@ Application Information interface, for operating system portability."> - + + the display name of the application for @appinfo, or the name if @@ -661,91 +2021,141 @@ Application Information interface, for operating system portability."> + Integrating the launch with the launching application. This is used to +handle for instance startup notification and launching the new application +on the same screen as the launching window. + Creates a new application launch context. This is not normally used, +instead you instantiate a subclass of this, such as #GdkAppLaunchContext. + a #GAppLaunchContext. + Gets the display string for the @context. This is used to ensure new +applications are started on the same display as the launching +application, by setting the <envvar>DISPLAY</envvar> environment variable. + a display string for the display. + a #GAppInfo - + a #GList of #GFile objects + + + + Initiates startup notification for the application and returns the +<envvar>DESKTOP_STARTUP_ID</envvar> for the launched operation, +if supported. +Startup notification IDs are defined in the <ulink +url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"> +FreeDesktop.Org Startup Notifications standard</ulink>. +not supported. + a startup notification ID for the application, or %NULL if + a #GAppInfo - + a #GList of of #GFile objects + + + + Called when an application has failed to launch, so that it can cancel +the application startup notification started in g_app_launch_context_get_startup_notify_id(). + the startup notification id that was returned by g_app_launch_context_get_startup_notify_id(). + Gets the display string for the @context. This is used to ensure new +applications are started on the same display as the launching +application, by setting the <envvar>DISPLAY</envvar> environment variable. + a display string for the display. + a #GAppInfo - + a #GList of #GFile objects + + + + Initiates startup notification for the application and returns the +<envvar>DESKTOP_STARTUP_ID</envvar> for the launched operation, +if supported. +Startup notification IDs are defined in the <ulink +url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"> +FreeDesktop.Org Startup Notifications standard</ulink>. +not supported. + a startup notification ID for the application, or %NULL if + a #GAppInfo - + a #GList of of #GFile objects + + + + Called when an application has failed to launch, so that it can cancel +the application startup notification started in g_app_launch_context_get_startup_notify_id(). + the startup notification id that was returned by g_app_launch_context_get_startup_notify_id(). @@ -765,8 +2175,9 @@ on the same screen as the launching window." - + + a display string for the display. @@ -774,17 +2185,22 @@ on the same screen as the launching window." + a #GAppInfo - + a #GList of #GFile objects + + + - + + a startup notification ID for the application, or %NULL if @@ -792,16 +2208,20 @@ on the same screen as the launching window." + a #GAppInfo - + a #GList of of #GFile objects + + + - + @@ -810,56 +2230,630 @@ on the same screen as the launching window." + the startup notification id that was returned by g_app_launch_context_get_startup_notify_id(). - - + + - - + + - - + + - - + + - - + + - + + + + The <structname>GApplication</structname> structure contains private +data and should only be accessed using the provided API + + + Create a new #GApplication. This uses a platform-specific +mechanism to ensure the current process is the unique owner of the +application (as defined by the @appid). If successful, the +#GApplication:is-remote property will be %FALSE, and it is safe to +continue creating other resources such as graphics windows. +If the given @appid is already running in another process, the the +GApplication::activate_with_data signal will be emitted in the +remote process, with the data from @argv and other +platform-specific data available. Subsequently the +#GApplication:default-quit property will be evaluated. If it's +%TRUE, then the current process will terminate. If %FALSE, then +the application remains in the #GApplication:is-remote state, and +you can e.g. call g_application_invoke_action(). Note that proxy +instances should not call g_application_add_action(). +This function may do synchronous I/O to obtain unique ownership +of the application id, and will block the calling thread in this +case. +If the environment does not support the basic functionality of +#GApplication, this function will invoke g_error(), which by +default is a fatal operation. This may arise for example on +UNIX systems using D-Bus when the session bus is not available. +As a convenience, this function is defined to call g_type_init() as +its very first action. + + An application instance + + + + + System-dependent application identifier + + + + Number of arguments in @argv + + + + Argument vector, usually from the <parameter>argv</parameter> parameter of main() + + + + + + + + This function is similar to g_application_new(), but allows for +more graceful fallback if the environment doesn't support the +basic #GApplication functionality. + + An application instance + + + + + System-dependent application identifier + + + + Number of arguments in @argv + + + + Argument vector, usually from the <parameter>argv</parameter> parameter of main() + + + + + + + + This function is similar to g_application_try_new(), but also +sets the GApplication:register property to %FALSE. You can later +call g_application_register() to complete initialization. + + An application instance + + + + + System-dependent application identifier + + + + Number of arguments in @argv + + + + Argument vector, usually from the <parameter>argv</parameter> parameter of main() + + + + + + + + In the normal case where there is exactly one #GApplication instance +in this process, return that instance. If there are multiple, the +first one created will be returned. Otherwise, return %NULL. +or %NULL if none is set + + The primary instance of #GApplication, + + + + + Starts the application. +The default implementation of this virtual function will simply run +a main loop. +It is an error to call this function if @application is a proxy for +a remote application. + + + + + + Adds an action @name to the list of exported actions of @application. +It is an error to call this function if @application is a proxy for +a remote application. +You can invoke an action using g_application_invoke_action(). +The newly added action is enabled by default; you can call +g_application_set_action_enabled() to disable it. + + + + + + the action name + + + + the action description; can be a translatable string + + + + + + Gets the description of the action @name. +It is an error to call this function if @application is a proxy for +a remote application. + + Description for the given action named @name + + + + + Action name + + + + + + Retrieves whether the action @name is enabled or not. +See g_application_set_action_enabled(). +It is an error to call this function if @application is a proxy for +a remote application. + + %TRUE if the action was enabled, and %FALSE otherwise + + + + + the name of the action + + + + + + Retrieves the platform-specific identifier for the #GApplication. +is owned by the #GApplication instance and it should never be +modified or freed + + The platform-specific identifier. The returned string + + + + + Invokes the action @name of the passed #GApplication. +This function has different behavior depending on whether @application +is acting as a proxy for another process. In the normal case where +the current process is hosting the application, and the specified +action exists and is enabled, the #GApplication::action signal will +be emitted. +If @application is a proxy, then the specified action will be invoked +in the remote process. It is not necessary to call +g_application_add_action() in the current process in order to invoke +one remotely. + + + + + + the name of the action to invoke + + + + platform-specific event data + + + + + + Returns whether the object represents a proxy for a remote application. + + %TRUE if this object represents a proxy for a remote application. + + + + + Retrieves the list of action names currently exported by @application. +It is an error to call this function if @application is a proxy for +a remote application. +of strings containing action names; use g_strfreev() to free the +resources used by the returned array + + a newly allocation, %NULL-terminated array + + + + + + + Request that the application quits. +This function has different behavior depending on whether @application +is acting as a proxy for another process. In the normal case where +the current process is hosting the application, the default +implementation will quit the main loop created by g_application_run(). +If @application is a proxy, then the remote process will be asked +to quit. + + %TRUE if the application accepted the request, %FALSE otherwise + + + + + platform-specific data + + + + + + By default, #GApplication ensures process uniqueness when +initialized, but this behavior is controlled by the +GApplication:register property. If it was given as %FALSE at +construction time, this function allows you to later attempt +to ensure uniqueness. Note that the GApplication:default-quit +property no longer applies at this point; if this function returns +%FALSE, platform activation will occur, but the current process +will not be terminated. +It is an error to call this function more than once. It is +also an error to call this function if the GApplication:register +property was %TRUE at construction time. + + %TRUE if registration was successful + + + + + Removes the action @name from the list of exported actions of @application. +It is an error to call this function if @application is a proxy for +a remote application. + + + + + + the name of the action to remove + + + + + + Starts the application. +The default implementation of this virtual function will simply run +a main loop. +It is an error to call this function if @application is a proxy for +a remote application. + + + + + + Sets whether the action @name inside @application should be enabled +or disabled. +It is an error to call this function if @application is a proxy for +a remote application. +Invoking a disabled action will not result in the #GApplication::action +signal being emitted. + + + + + + the name of the application + + + + whether to enable or disable the action @name + + + + + + The unique identifier for this application. See the documentation for +#GApplication for more information about this property. + + + + The argument vector given to this application. It must be a #GVariant +with a type signature "aay". + + + + By default, if the GApplication:register property is %TRUE, and a +different process is running this application, the process will +be exited. Set this property to %FALSE to allow custom +interaction with the remote process. + + + + This property is %TRUE if this application instance represents a proxy +to the instance of this application in another process. + + + + Platform-specific data retrieved from the operating system +environment. It must be a #GVariant with type signature "a{sv}". + + + + If this property is %FALSE, the application construction will not attempt +to ensure process uniqueness, and the application is guaranteed to be in the +remote state. See GApplication:is-remote. + + + + + + + + + + This signal is emitted when an action is activated. The action name +is passed as the first argument, but also as signal detail, so it +is possible to connect to this signal for individual actions. +The signal is never emitted for disabled actions. + + + + + + The name of the activated action + + + + Platform-specific data, or %NULL + + + + + + This signal is emitted when a non-primary process for a given +application is invoked while your application is running; for +example, when a file browser launches your program to open a +file. The raw operating system arguments are passed in the +stored in @platform_data. + + + + + + A #GVariant with the signature "aay" + + + + A #GVariant with the signature "a{sv}", or %NULL + + + + + + This signal is emitted when the Quit action is invoked on the +application. +The default handler for this signal exits the mainloop of the +application. +signal emission + + %TRUE if the signal has been handled, %FALSE to continue + + + + + Platform-specific data, or %NULL + + + + + + + The <structname>GApplicationClass</structname> structure contains +private data only + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #GAskPasswordFlags are used to request specific information from the +user, or to notify the user of their choices in an authentication +situation. - + Interface for asynchronously initializable objects. + + Starts asynchronous initialization of the object implementing the +interface. This must be done before any real use of the object after +initial construction. If the object also implements #GInitable you can +optionally call g_initable_init() instead. +When the initialization is finished, @callback will be called. You can +then call g_async_initable_init_finish() to get the result of the +initialization. +Implementations may also support cancellation. If @cancellable is not +%NULL, then initialization can be cancelled by triggering the cancellable +object from another thread. If the operation was cancelled, the error +%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and +the object doesn't support cancellable initialization, the error +%G_IO_ERROR_NOT_SUPPORTED will be returned. +If this function is not called, or returns with an error, then all +operations on the object should fail, generally returning the +error %G_IO_ERROR_NOT_INITIALIZED. +to this function with the same argument should return the same results. +Only the first call initializes the object; further calls return the result +of the first call. This is so that it's safe to implement the singleton +pattern in the GObject constructor function. +For classes that also support the #GInitable interface, the default +implementation of this method will run the g_initable_init() function +in a thread, so if you want to support asynchronous initialization via +threads, just implement the #GAsyncInitable interface without overriding +any interface methods. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the <link linkend="io-priority">I/O priority</link> of the operation. + + optional #GCancellable object, %NULL to ignore. + closure="3"> + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes asynchronous initialization and returns the result. +See g_async_initable_init_async(). +will return %FALSE and set @error appropriately if present. + + %TRUE if successful. If an error has occurred, this function + + + + + a #GAsyncResult. + + + + + + Starts asynchronous initialization of the object implementing the +interface. This must be done before any real use of the object after +initial construction. If the object also implements #GInitable you can +optionally call g_initable_init() instead. +When the initialization is finished, @callback will be called. You can +then call g_async_initable_init_finish() to get the result of the +initialization. +Implementations may also support cancellation. If @cancellable is not +%NULL, then initialization can be cancelled by triggering the cancellable +object from another thread. If the operation was cancelled, the error +%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and +the object doesn't support cancellable initialization, the error +%G_IO_ERROR_NOT_SUPPORTED will be returned. +If this function is not called, or returns with an error, then all +operations on the object should fail, generally returning the +error %G_IO_ERROR_NOT_INITIALIZED. +to this function with the same argument should return the same results. +Only the first call initializes the object; further calls return the result +of the first call. This is so that it's safe to implement the singleton +pattern in the GObject constructor function. +For classes that also support the #GInitable interface, the default +implementation of this method will run the g_initable_init() function +in a thread, so if you want to support asynchronous initialization via +threads, just implement the #GAsyncInitable interface without overriding +any interface methods. + + + + + + the <link linkend="io-priority">I/O priority</link> of the operation. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Finishes asynchronous initialization and returns the result. +See g_async_initable_init_async(). +will return %FALSE and set @error appropriately if present. - + %TRUE if successful. If an error has occurred, this function + + a #GAsyncResult. + Finishes the async construction for the various g_async_initable_new calls, +returning the created object or %NULL on error. +g_object_unref(). + a newly created #GObject, or %NULL on error. Free with + the #GAsyncResult.from the callback @@ -971,14 +3049,14 @@ situation." + Provides an interface for asynchronous initializing object such that +initialization may fail. - + @@ -987,97 +3065,120 @@ initialization may fail." - + the <link linkend="io-priority">I/O priority</link> of the operation. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if successful. If an error has occurred, this function + + a #GAsyncResult. - + + Type definition for a function that will be called back when an asynchronous +operation within GIO has been completed. + the object the asynchronous operation was started with. + a #GAsyncResult. - + user data passed to the callback. + - - - - - + Holds results information for an asynchronous operation, +usually passed directly to a asynchronous _finish() operation. + Gets the source object from a #GAsyncResult. +or %NULL if there is none. + a new reference to the source object for the @res, - - - + + Gets the user data from a #GAsyncResult. + + the user data for @res. + - + + Gets the source object from a #GAsyncResult. +or %NULL if there is none. + a new reference to the source object for the @res, + + Gets the user data from a #GAsyncResult. + + the user data for @res. + + + + glib:is-gtype-struct-for="AsyncResult"> + Interface definition for #GAsyncResult. - - - + + + the user data for @res. + @@ -1087,8 +3188,9 @@ usually passed directly to a asynchronous _finish() operation." - + + a new reference to the source object for the @res, @@ -1100,208 +3202,323 @@ usually passed directly to a asynchronous _finish() operation." + Implements #GFilterInputStream with a sized input buffer. + Creates a new #GInputStream from the given @base_stream, with +a buffer set to the default size (4 kilobytes). - + a #GInputStream for the given @base_stream. + + a #GInputStream + Creates a new #GBufferedInputStream from the given @base_stream, +with a buffer set to @size. - + a #GInputStream. + + a #GInputStream - + a #gsize + + Tries to read @count bytes from the stream into the buffer. +Will block during this read. +If @count is zero, returns zero and does nothing. A value of @count +larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes read into the buffer is returned. +It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file. Zero is returned on end of file +(or if @count is zero), but never otherwise. +If @count is -1 then the attempted read size is equal to the number of +bytes that are required to fill the buffer. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +On error -1 is returned and @error is set accordingly. +For the asynchronous, non-blocking, version of this function, see +g_buffered_input_stream_fill_async(). +or -1 on error. - + the number of bytes read into @stream's buffer, up to @count, + - + the number of bytes that will be read from the stream + + optional #GCancellable object, %NULL to ignore + Reads data into @stream's buffer asynchronously, up to @count size. +version of this function, see g_buffered_input_stream_fill(). +If @count is -1 then the attempted read size is equal to the number +of bytes that are required to fill the buffer. - + the number of bytes that will be read from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request + + optional #GCancellable object - + + a #GAsyncReadyCallback - - + + a #gpointer + + Finishes an asynchronous read. - + a #gssize of the read stream, or %-1 on an error. + + a #GAsyncResult - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Tries to read @count bytes from the stream into the buffer. +Will block during this read. +If @count is zero, returns zero and does nothing. A value of @count +larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes read into the buffer is returned. +It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file. Zero is returned on end of file +(or if @count is zero), but never otherwise. +If @count is -1 then the attempted read size is equal to the number of +bytes that are required to fill the buffer. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +On error -1 is returned and @error is set accordingly. +For the asynchronous, non-blocking, version of this function, see +g_buffered_input_stream_fill_async(). +or -1 on error. - + the number of bytes read into @stream's buffer, up to @count, + - + the number of bytes that will be read from the stream + + optional #GCancellable object, %NULL to ignore + Reads data into @stream's buffer asynchronously, up to @count size. +version of this function, see g_buffered_input_stream_fill(). +If @count is -1 then the attempted read size is equal to the number +of bytes that are required to fill the buffer. - + the number of bytes that will be read from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request + + optional #GCancellable object + closure="4"> + a #GAsyncReadyCallback - + a #gpointer + + Finishes an asynchronous read. - + a #gssize of the read stream, or %-1 on an error. + + a #GAsyncResult + + Gets the size of the available data within the stream. + + size of the available stream. + + + + + Gets the size of the input buffer. + + the current buffer size. + + + + + Peeks in the buffer, copying data of size @count into @buffer, +offset @offset bytes. + + a #gsize of the number of bytes peeked, or -1 on error. + + + + + a pointer to an allocated chunk of memory + + + + a #gsize + + + + a #gsize + + + + + + Returns the buffer with the currently available bytes. The returned +buffer must not be modified and will become invalid when reading from +the stream or filling the buffer. + + read-only buffer + + + + + a #gsize to get the number of bytes available in the buffer + + + + + Tries to read a single byte from the stream or the buffer. Will block +during this read. +On success, the byte read from the stream is returned. On end of stream +-1 is returned but it's not an exceptional error and @error is not set. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +On error -1 is returned and @error is set accordingly. - + the byte read from the @stream, or -1 on end of stream or error. + + optional #GCancellable object, %NULL to ignore - - + + Sets the size of the internal buffer of @stream to @size, or to the +size of the contents of the buffer. The buffer can never be resized +smaller than its current contents. + + + + + + a #gsize + + + + + + @@ -1318,27 +3535,30 @@ usually passed directly to a asynchronous _finish() operation." - + - + the number of bytes read into @stream's buffer, up to @count, + - + the number of bytes that will be read from the stream + + optional #GCancellable object, %NULL to ignore - + @@ -1347,70 +3567,80 @@ usually passed directly to a asynchronous _finish() operation." - + the number of bytes that will be read from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request + + optional #GCancellable object - + + a #GAsyncReadyCallback - + a #gpointer + - + - + a #gssize of the read stream, or %-1 on an error. + + a #GAsyncResult - - + + - - + + - - + + - - + + - - + + @@ -1418,78 +3648,102 @@ usually passed directly to a asynchronous _finish() operation." + c:type="GBufferedInputStreamPrivate" + disguised="1"> + An implementation of #GFilterOutputStream with a sized buffer. + Creates a new buffered output stream for a base stream. - + a #GOutputStream for the given @base_stream. + + a #GOutputStream. + Creates a new buffered output stream with a given buffer size. - + a #GOutputStream with an internal buffer set to @size. + + a #GOutputStream. - + a #gsize. + - - - - - - - - - - - - - - - + Checks if the buffer automatically grows as data is added. +%FALSE otherwise. - + %TRUE if the @stream's buffer automatically grows, + + + + + Gets the size of the buffer in the @stream. + + the current size of the buffer. + + Sets whether or not the @stream's buffer should automatically grow. +If @auto_grow is true, then each write will just make the buffer +larger, and you must manually flush the buffer to actually write out +the data to the underlying stream. - + a #gboolean. + - - + + Sets the size of the internal buffer to @size. + + + + + + a #gsize. + + + + + + - - + + @@ -1506,15 +3760,15 @@ usually passed directly to a asynchronous _finish() operation." - - + + - - + + @@ -1522,109 +3776,390 @@ usually passed directly to a asynchronous _finish() operation." + c:type="GBufferedOutputStreamPrivate" + disguised="1"> + + Invoked when a connection to a message bus has been obtained. + + + + + + The #GDBusConnection to a message bus. + + + + The name that is requested to be owned. + + + + User data passed to g_bus_own_name(). + + + + + + Invoked when the name is acquired. + + + + + + The #GDBusConnection on which to acquired the name. + + + + The name being owned. + + + + User data passed to g_bus_own_name() or g_bus_own_name_on_connection(). + + + + + + Invoked when the name being watched is known to have to have a owner. + + + + + + The #GDBusConnection the name is being watched on. + + + + The name being watched. + + + + Unique name of the owner of the name being watched. + + + + User data passed to g_bus_watch_name(). + + + + + + Invoked when the name is lost or @connection has been closed. + + + + + + The #GDBusConnection on which to acquire the name or %NULL if the connection was disconnected. + + + + The name being owned. + + + + User data passed to g_bus_own_name() or g_bus_own_name_on_connection(). + + + + + + Flags used in g_bus_own_name(). + + + + + + Invoked when the name being watched is known not to have to have a owner. + + + + + + The #GDBusConnection the name is being watched on. + + + + The name being watched. + + + + User data passed to g_bus_watch_name(). + + + + + + Flags used in g_bus_watch_name(). + + + + + An enumeration for well-known message buses. + + + + + + Allows actions to be cancelled. + Creates a new #GCancellable object. +Applications that want to start one or more operations +that should be cancellable should create a #GCancellable +and pass it to the operations. +One #GCancellable can be used in multiple consecutive +operations, but not in multiple concurrent operations. + a #GCancellable. - + Gets the top cancellable from the stack. +if the stack is empty. + + a #GCancellable from the top of the stack, or %NULL - - - - - - - - - - - - - - - - - - - - - - - - - - + + Will set @cancellable to cancelled, and will emit the +#GCancellable::cancelled signal. (However, see the warning about +race conditions in the documentation for that signal if you are +planning to connect to it.) +This function is thread-safe. In other words, you can safely call +it from a thread other than the one running the operation that was +passed the @cancellable. +The convention within gio is that cancelling an asynchronous +operation causes it to complete asynchronously. That is, if you +cancel the operation from the same thread in which it is running, +then the operation's #GAsyncReadyCallback will not be invoked until +the application returns to the main loop. - + + Convenience function to connect to the #GCancellable::cancelled +signal. Also handles the race condition that may happen +if the cancellable is cancelled right before connecting. +time of the connect if @cancellable is already cancelled, +or when @cancellable is cancelled in some thread. +disconnected, or immediately if the cancellable is already +cancelled. +See #GCancellable::cancelled for details on how to use this. +been cancelled. - - - - - - - - - - - - - - - - + The id of the signal handler or 0 if @cancellable has already + + closure="1" + destroy="2"> + The #GCallback to connect. - + Data to pass to @callback. + + scope="async"> + Free function for @data or %NULL. - + + Disconnects a handler from a cancellable instance similar to +g_signal_handler_disconnect(). Additionally, in the event that a +signal handler is currently running, this call will block until the +handler has finished. Calling this function from a +#GCancellable::cancelled signal handler will therefore result in a +deadlock. +This avoids a race condition where a thread cancels at the +same time as the cancellable operation is finished and the +signal handler is removed. See #GCancellable::cancelled for +details on how to use this. +If @cancellable is %NULL or @handler_id is %0 this function does +nothing. - + Handler id of the handler to be disconnected, or %0. + - + + Gets the file descriptor for a cancellable job. This can be used to +implement cancellable operations on Unix systems. The returned fd will +turn readable when @cancellable is cancelled. +You are not supposed to read from the fd yourself, just check for +readable status. Reading to unset the readable status is done +with g_cancellable_reset(). +After a successful return from this function, you should use +g_cancellable_release_fd() to free up resources allocated for +the returned file descriptor. +See also g_cancellable_make_pollfd(). +is not supported, or on errors. + + A valid file descriptor. %-1 if the file descriptor + + + + + Checks if a cancellable job has been cancelled. +FALSE if called with %NULL or if item is not cancelled. + + %TRUE if @cancellable is cancelled, + + + + + Creates a #GPollFD corresponding to @cancellable; this can be passed +to g_poll() and used to poll for cancellation. This is useful both +for unix systems without a native poll and for portability to +windows. +When this function returns %TRUE, you should use +g_cancellable_release_fd() to free up resources allocated for the +If this function returns %FALSE, either no @cancellable was given or +resource limits prevent this function from allocating the necessary +structures for polling. (On Linux, you will likely have reached +the maximum number of file descriptors.) The suggested way to handle +these cases is to ignore the @cancellable. +You are not supposed to read from the fd yourself, just check for +readable status. Reading to unset the readable status is done +with g_cancellable_reset(). +failure to prepare the cancellable. + + %TRUE if @pollfd was successfully initialized, %FALSE on + + + + + a pointer to a #GPollFD + + + + + + Pops @cancellable off the cancellable stack (verifying that @cancellable +is on the top of the stack). + + Pushes @cancellable onto the cancellable stack. The current +cancllable can then be recieved using g_cancellable_get_current(). +This is useful when implementing cancellable operations in +code that does not allow you to pass down the cancellable object. +This is typically called automatically by e.g. #GFile operations, +so you rarely have to call this yourself. + + + + + + Releases a resources previously allocated by g_cancellable_get_fd() +or g_cancellable_make_pollfd(). +For compatibility reasons with older releases, calling this function +is not strictly required, the resources will be automatically freed +when the @cancellable is finalized. However, the @cancellable will +block scarce file descriptors until it is finalized if this function +is not called. This can cause the application to run out of file +descriptors when many #GCancellables are used at the same time. + + + + + + Resets @cancellable to its uncancelled state. + + + + + + If the @cancellable is cancelled, sets the error to notify +that the operation was cancelled. + + %TRUE if @cancellable was cancelled, %FALSE if it was not. + + + @@ -1632,8 +4167,49 @@ usually passed directly to a asynchronous _finish() operation." - - + Emitted when the operation has been cancelled. +Can be used by implementations of cancellable operations. If the +operation is cancelled from another thread, the signal will be +emitted in the thread that cancelled the operation, not the +thread that is running the operation. +Note that disconnecting from this signal (or any signal) in a +multi-threaded program is prone to race conditions. For instance +it is possible that a signal handler may be invoked even +<emphasis>after</emphasis> a call to +g_signal_handler_disconnect() for that handler has already +returned. +There is also a problem when cancellation happen +right before connecting to the signal. If this happens the +signal will unexpectedly not be emitted, and checking before +connecting to the signal leaves a race condition where this is +still happening. +In order to make it safe and easy to connect handlers there +g_cancellable_disconnect() which protect against problems +like this. +An example of how to us this: +|[ +/<!-- -->* Make sure we don't do any unnecessary work if already cancelled *<!-- -->/ +if (g_cancellable_set_error_if_cancelled (cancellable)) +return; +/<!-- -->* Set up all the data needed to be able to +* handle cancellation of the operation *<!-- -->/ +my_data = my_data_new (...); +id = 0; +if (cancellable) +id = g_cancellable_connect (cancellable, +G_CALLBACK (cancelled_handler) +data, NULL); +/<!-- -->* cancellable operation here... *<!-- -->/ +g_cancellable_disconnect (cancellable, id); +/<!-- -->* cancelled_handler is never called after this, it +* is now safe to free the data *<!-- -->/ +my_data_free (my_data); +]| +Note that the cancelled signal is emitted in the thread that +the user cancelled from, which may be the main thread. So, the +cancellable signal should not do something that can block. + + @@ -1644,111 +4220,136 @@ usually passed directly to a asynchronous _finish() operation." - + - + - - + + - - + + - - + + - - + + - - + + - + + Conversions between character sets. + Creates a new #GCharsetConverter. + a new #GCharsetConverter or %NULL on error. + destination charset + source charset + + Gets the number of fallbacks that @converter has applied so far. + + the number of fallbacks that @converter has applied + + + + + Gets the #GCharsetConverter:use-fallback property. + + %TRUE if fallbacks are used by @converter + + + + c:identifier="g_charset_converter_set_use_fallback" + version="2.24"> + Sets the #GCharsetConverter:use-fallback property. - + %TRUE to use fallbacks + - - - - - - - - - - - - + + - - + + - - + + - - + Seek object for streaming operations. + + This is the main operation used when converting data. It is to be called +multiple times in a loop, and each time it will do some work, i.e. +producing some output (in @outbuf) or consuming some input (from @inbuf) or +both. If its not possible to do any work an error is returned. +Note that a single call may not consume all input (or any input at all). +Also a call may produce output even if given no input, due to state stored +in the converter producing output. +If any data was either produced or consumed, and then an error happens, then +only the successful conversion is reported and the error is returned on the +next call. +A full conversion loop involves calling this method repeatedly, each time +giving it new input and space output space. When there is no more input +data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set. +The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED +each time until all data is consumed and all output is produced, then +%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED +may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance +in a decompression converter where the end of data is detectable from the +data (and there might even be other data after the end of the compressed data). +When some data has successfully been converted @bytes_read and is set to +the number of bytes read from @inbuf, and @bytes_written is set to indicate +how many bytes was written to @outbuf. If there are more data to output +or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then +G_CONVERTER_CONVERTED is returned, and if no more data is to be output +then G_CONVERTER_FINISHED is returned. +On error %G_CONVERTER_ERROR is returned and @error is set accordingly. +Some errors need special handling: +%G_IO_ERROR_NO_SPACE is returned if there is not enough space +to write the resulting converted data, the application should +call the function again with a larger @outbuf to continue. +%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough +input to fully determine what the conversion should produce, +and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for +example with an incomplete multibyte sequence when converting text, +or when a regexp matches up to the end of the input (and may match +further input). It may also happen when @inbuf_size is zero and +there is no more data to produce. +When this happens the application should read more input and then +call the function again. If further input shows that there is no +more data call the function again with the same data but with +the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion +to finish as e.g. in the regexp match case (or, to fail again with +%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the +input is actually partial). +After g_converter_convert() has returned %G_CONVERTER_FINISHED the +converter object is in an invalid state where its not allowed +to call g_converter_convert() anymore. At this time you can only +free the object or call g_converter_reset() to reset it to the +initial state. +If the flag %G_CONVERTER_FLUSH is set then conversion is modified +to try to write out all internal state to the output. The application +has to call the function multiple times with the flag set, and when +the availible input has been consumed and all internal state has +been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if +really at the end) is returned instead of %G_CONVERTER_CONVERTED. +This is somewhat similar to what happens at the end of the input stream, +but done in the middle of the data. +This has different meanings for different conversions. For instance +in a compression converter it would mean that we flush all the +compression state into output such that if you uncompress the +compressed data you get back all the input data. Doing this may +make the final file larger due to padding though. Another example +is a regexp conversion, where if you at the end of the flushed data +have a match, but there is also a potential longer match. In the +non-flushed case we would ask for more input, but when flushing we +treat this as the end of input and do the match. +Flushing is not always possible (like if a charset converter flushes +at a partial multibyte sequence). Converters are supposed to try +to produce as much output as possible and then return an error +(typically %G_IO_ERROR_PARTIAL_INPUT). + + a #GConverterResult, %G_CONVERTER_ERROR on error. - + the buffer containing the data to convert. + - + the number of bytes in @inbuf + - + a buffer to write converted data in. + - + the number of bytes in @outbuf, must be at least one + + a #GConvertFlags controlling the conversion details - - + + will be set to the number of bytes read from @inbuf on success + - - + + will be set to the number of bytes written to @outbuf on success + - + + Resets all internal state in the converter, making it behave +as if it was just created. If the converter has any internal +state that would produce output then that output is lost. - - + + This is the main operation used when converting data. It is to be called +multiple times in a loop, and each time it will do some work, i.e. +producing some output (in @outbuf) or consuming some input (from @inbuf) or +both. If its not possible to do any work an error is returned. +Note that a single call may not consume all input (or any input at all). +Also a call may produce output even if given no input, due to state stored +in the converter producing output. +If any data was either produced or consumed, and then an error happens, then +only the successful conversion is reported and the error is returned on the +next call. +A full conversion loop involves calling this method repeatedly, each time +giving it new input and space output space. When there is no more input +data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set. +The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED +each time until all data is consumed and all output is produced, then +%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED +may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance +in a decompression converter where the end of data is detectable from the +data (and there might even be other data after the end of the compressed data). +When some data has successfully been converted @bytes_read and is set to +the number of bytes read from @inbuf, and @bytes_written is set to indicate +how many bytes was written to @outbuf. If there are more data to output +or consume (i.e. unless the G_CONVERTER_INPUT_AT_END is specified) then +G_CONVERTER_CONVERTED is returned, and if no more data is to be output +then G_CONVERTER_FINISHED is returned. +On error %G_CONVERTER_ERROR is returned and @error is set accordingly. +Some errors need special handling: +%G_IO_ERROR_NO_SPACE is returned if there is not enough space +to write the resulting converted data, the application should +call the function again with a larger @outbuf to continue. +%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough +input to fully determine what the conversion should produce, +and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for +example with an incomplete multibyte sequence when converting text, +or when a regexp matches up to the end of the input (and may match +further input). It may also happen when @inbuf_size is zero and +there is no more data to produce. +When this happens the application should read more input and then +call the function again. If further input shows that there is no +more data call the function again with the same data but with +the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion +to finish as e.g. in the regexp match case (or, to fail again with +%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the +input is actually partial). +After g_converter_convert() has returned %G_CONVERTER_FINISHED the +converter object is in an invalid state where its not allowed +to call g_converter_convert() anymore. At this time you can only +free the object or call g_converter_reset() to reset it to the +initial state. +If the flag %G_CONVERTER_FLUSH is set then conversion is modified +to try to write out all internal state to the output. The application +has to call the function multiple times with the flag set, and when +the availible input has been consumed and all internal state has +been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if +really at the end) is returned instead of %G_CONVERTER_CONVERTED. +This is somewhat similar to what happens at the end of the input stream, +but done in the middle of the data. +This has different meanings for different conversions. For instance +in a compression converter it would mean that we flush all the +compression state into output such that if you uncompress the +compressed data you get back all the input data. Doing this may +make the final file larger due to padding though. Another example +is a regexp conversion, where if you at the end of the flushed data +have a match, but there is also a potential longer match. In the +non-flushed case we would ask for more input, but when flushing we +treat this as the end of input and do the match. +Flushing is not always possible (like if a charset converter flushes +at a partial multibyte sequence). Converters are supposed to try +to produce as much output as possible and then return an error +(typically %G_IO_ERROR_PARTIAL_INPUT). + + a #GConverterResult, %G_CONVERTER_ERROR on error. - + the buffer containing the data to convert. + - + the number of bytes in @inbuf + - + a buffer to write converted data in. + - + the number of bytes in @outbuf, must be at least one + + a #GConvertFlags controlling the conversion details - - + + will be set to the number of bytes read from @inbuf on success + - - + + will be set to the number of bytes written to @outbuf on success + - + + Resets all internal state in the converter, making it behave +as if it was just created. If the converter has any internal +state that would produce output then that output is lost. + Flags used when calling a g_converter_convert(). + Provides an interface for converting data from one type +to another type. The conversion can be stateful +and may fail at any place. - - + + + a #GConverterResult, %G_CONVERTER_ERROR on error. @@ -1879,35 +4642,38 @@ and may fail at any place." - + the buffer containing the data to convert. + - + the number of bytes in @inbuf + - + a buffer to write converted data in. + - + the number of bytes in @outbuf, must be at least one + + a #GConvertFlags controlling the conversion details - - + + will be set to the number of bytes read from @inbuf on success + - - + + will be set to the number of bytes written to @outbuf on success + - + @@ -1920,34 +4686,45 @@ and may fail at any place." + An implementation of #GFilterInputStream that allows data +conversion. + Creates a new converter input stream for the @base_stream. - + a new #GInputStream. + + a #GInputStream + a #GConverter - + c:identifier="g_converter_input_stream_get_converter" + version="2.24"> + Gets the #GConverter that is used by @converter_stream. + + the converter of the converter input stream - - + + @@ -1963,36 +4740,36 @@ conversion." - - + + - - + + - - + + - - + + - - + + @@ -2000,37 +4777,49 @@ conversion." + c:type="GConverterInputStreamPrivate" + disguised="1"> + An implementation of #GFilterOutputStream that allows data +conversion. + Creates a new converter output stream for the @base_stream. - + a new #GOutputStream. + + a #GOutputStream + a #GConverter - + c:identifier="g_converter_output_stream_get_converter" + version="2.24"> + Gets the #GConverter that is used by @converter_stream. + + the converter of the converter output stream - - + + @@ -2047,36 +4836,36 @@ conversion." - - + + - - + + - - + + - - + + - - + + @@ -2084,14 +4873,15 @@ conversion." + c:type="GConverterOutputStreamPrivate" + disguised="1"> + Results returned from g_converter_convert(). - - - - - + + The #GCredentials structure contains only private data and +should only be accessed using the provided API. + + Creates a new #GCredentials object with credentials matching the +the current process. - + A #GCredentials. Free with g_object_unref(). + + + + + Gets a pointer to native credentials of type @native_type from +It is a programming error (which will cause an warning to be +logged) to use this method if there is no #GCredentials support for +the OS or if @native_type isn't supported by the OS. +operation there is no #GCredentials support for the OS or if +data, it is owned by @credentials. + + The pointer to native credentials or %NULL if the + - - + + The type of native credentials to get. + - - + + + Tries to get the UNIX user identifier from @credentials. This +method is only available on UNIX platforms. +This operation can fail if #GCredentials is not supported on the +OS or if the native credentials type does not contain information +about the UNIX user. + + The UNIX user identifier or -1 if @error is set. + + + + + Checks if @credentials and @other_credentials is the same user. +This operation can fail if #GCredentials is not supported on the +the OS. +user, %FALSE otherwise or if @error is set. + + %TRUE if @credentials and @other_credentials has the same + + + + + A #GCredentials. + + + + + + Copies the native credentials of type @native_type from @native +into @credentials. +It is a programming error (which will cause an warning to be +logged) to use this method if there is no #GCredentials support for +the OS or if @native_type isn't supported by the OS. - - + + The type of native credentials to set. + + + + A pointer to native credentials. + - + + Tries to set the UNIX user identifier on @credentials. This method +is only available on UNIX platforms. +This operation can fail if #GCredentials is not supported on the +OS or if the native credentials type does not contain information +about the UNIX user. + + %TRUE if @uid was set, %FALSE if error is set. + + + + + The UNIX user identifier to set. + + + + + + Creates a human-readable textual representation of @credentials +that can be used in logging and debug messages. The format of the +returned string may change in future GLib release. - + A string that should be freed with g_free(). + - + + + Class structure for #GCredentials. + + + Enumeration describing different kinds of native credential types. + + + + + + Information about an annotation. + + + + + + + + + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + Information about an argument for a method or a signal. + + + + + + + + + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + The #GDBusAuthObserver structure contains only private data and +should only be accessed using the provided API. + + Creates a new #GDBusAuthObserver object. + + A #GDBusAuthObserver. Free with g_object_unref(). + + + + + Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer. + + %TRUE if the peer is authorized, %FALSE if not. + + + + + A #GIOStream for the #GDBusConnection. + + + + Credentials received from the peer or %NULL. + + + + + + Emitted to check if a peer that is successfully authenticated +is authorized. + + %TRUE if the peer is authorized, %FALSE if not. + + + + + A #GIOStream for the #GDBusConnection. + + + + Credentials received from the peer or %NULL. + + + + + + + Flags used in g_dbus_connection_call() and similar APIs. + + + + + Capabilities negotiated with the remote peer. + + + + + The #GDBusConnection structure contains only private data and +should only be accessed using the provided API. + + + + Finishes an operation started with g_dbus_connection_new(). + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new(). + + + + + + Finishes an operation started with g_dbus_connection_new_for_address(). + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_new(). + + + + + + Synchronously connects and sets up a D-Bus client connection for +exchanging D-Bus messages with an endpoint specified by @address +which must be in the D-Bus address format. +This constructor can only be used to initiate client-side +connections - use g_dbus_connection_new_sync() if you need to act +as the server. In particular, @flags cannot contain the +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags. +This is a synchronous failable constructor. See +g_dbus_connection_new_for_address() for the asynchronous version. +If @observer is not %NULL it may be used to control the +authentication process. + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A D-Bus address. + + + + Flags describing how to make the connection. + + + + A #GDBusAuthObserver or %NULL. + + + + A #GCancellable or %NULL. + + + + + + Synchronously sets up a D-Bus connection for exchanging D-Bus messages +with the end represented by @stream. +If @observer is not %NULL it may be used to control the +authentication process. +This is a synchronous failable constructor. See +g_dbus_connection_new() for the asynchronous version. + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GIOStream. + + + + The GUID to use if a authenticating as a server or %NULL. + + + + Flags describing how to make the connection. + + + + A #GDBusAuthObserver or %NULL. + + + + A #GCancellable or %NULL. + + + + + + Asynchronously sets up a D-Bus connection for exchanging D-Bus messages +with the end represented by @stream. +If @observer is not %NULL it may be used to control the +authentication process. +When the operation is finished, @callback will be invoked. You can +then call g_dbus_connection_new_finish() to get the result of the +operation. +This is a asynchronous failable constructor. See +g_dbus_connection_new_sync() for the synchronous +version. + + + + + + A #GIOStream. + + + + The GUID to use if a authenticating as a server or %NULL. + + + + Flags describing how to make the connection. + + + + A #GDBusAuthObserver or %NULL. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied. + + + + The data to pass to @callback. + + + + + + Asynchronously connects and sets up a D-Bus client connection for +exchanging D-Bus messages with an endpoint specified by @address +which must be in the D-Bus address format. +This constructor can only be used to initiate client-side +connections - use g_dbus_connection_new() if you need to act as the +server. In particular, @flags cannot contain the +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags. +When the operation is finished, @callback will be invoked. You can +then call g_dbus_connection_new_finish() to get the result of the +operation. +If @observer is not %NULL it may be used to control the +authentication process. +This is a asynchronous failable constructor. See +g_dbus_connection_new_for_address_sync() for the synchronous +version. + + + + + + A D-Bus address. + + + + Flags describing how to make the connection. + + + + A #GDBusAuthObserver or %NULL. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied. + + + + The data to pass to @callback. + + + + + + Adds a message filter. Filters are handlers that are run on all +incoming and outgoing messages, prior to standard dispatch. Filters +are run in the order that they were added. The same handler can be +added as a filter more than once, in which case it will be run more +than once. Filters added during a filter callback won't be run on +the message being processed. Filter functions are allowed to modify +and even drop messages - see the #GDBusMessageFilterResult +enumeration for details. +Note that filters are run in a dedicated message handling thread so +they can't block and, generally, can't do anything but signal a +worker thread. Also note that filters are rarely needed - use API +such as g_dbus_connection_send_message_with_reply(), +g_dbus_connection_signal_subscribe() or +g_dbus_connection_call() instead. +If a filter consumes an incoming message the message is not +dispatched anywhere else - not even the standard dispatch machinery +(that API such as g_dbus_connection_signal_subscribe() and +g_dbus_connection_send_message_with_reply() relies on) will see the +message. Similary, if a filter consumes an outgoing message, the +message will not be sent to the other peer. +g_dbus_connection_remove_filter(). + + A filter identifier that can be used with + + + + + A filter function. + + + + User data to pass to @filter_function. + + + + Function to free @user_data with when filter is removed or %NULL. + + + + + + Asynchronously invokes the @method_name method on the +If @connection is closed then the operation will fail with +%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will +fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value +not compatible with the D-Bus protocol, the operation fails with +%G_IO_ERROR_INVALID_ARGUMENT. +If @reply_type is non-%NULL then the reply will be checked for having this type and an +error will be raised if it does not match. Said another way, if you give a @reply_type +then any non-%NULL return value will be of this type. +If the @parameters #GVariant is floating, it is consumed. This allows +convenient 'inline' use of g_variant_new(), e.g.: +|[ +g_dbus_connection_call (connection, +"org.freedesktop.StringThings", +"/org/freedesktop/StringThings", +"org.freedesktop.StringThings", +"TwoStrings", +g_variant_new ("(ss)", +"Thing One", +"Thing Two"), +NULL, +G_DBUS_CALL_FLAGS_NONE, +-1, +NULL, +(GAsyncReadyCallback) two_strings_done, +NULL); +]| +This is an asynchronous method. When the operation is finished, @callback will be invoked +in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> +of the thread you are calling this method from. You can then call +g_dbus_connection_call_finish() to get the result of the operation. +See g_dbus_connection_call_sync() for the synchronous version of this +function. + + + + + + A unique or well-known bus name or %NULL if @connection is not a message bus connection. + + + + Path of remote object. + + + + D-Bus interface to invoke method on. + + + + The name of the method to invoke. + + + + A #GVariant tuple with parameters for the method or %NULL if not passing parameters. + + + + The expected type of the reply, or %NULL. + + + + Flags from the #GDBusCallFlags enumeration. + + + + The timeout in milliseconds or -1 to use the default timeout. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result of the method invocation. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_connection_call(). +return values. Free with g_variant_unref(). + + %NULL if @error is set. Otherwise a #GVariant tuple with + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call(). + + + + + + Synchronously invokes the @method_name method on the +If @connection is closed then the operation will fail with +%G_IO_ERROR_CLOSED. If @cancellable is canceled, the +operation will fail with %G_IO_ERROR_CANCELLED. If @parameters +contains a value not compatible with the D-Bus protocol, the operation +fails with %G_IO_ERROR_INVALID_ARGUMENT. +If @reply_type is non-%NULL then the reply will be checked for having +this type and an error will be raised if it does not match. Said +another way, if you give a @reply_type then any non-%NULL return +value will be of this type. +If the @parameters #GVariant is floating, it is consumed. +This allows convenient 'inline' use of g_variant_new(), e.g.: +|[ +g_dbus_connection_call_sync (connection, +"org.freedesktop.StringThings", +"/org/freedesktop/StringThings", +"org.freedesktop.StringThings", +"TwoStrings", +g_variant_new ("(ss)", +"Thing One", +"Thing Two"), +NULL, +G_DBUS_CALL_FLAGS_NONE, +-1, +NULL, +&amp;error); +]| +The calling thread is blocked until a reply is received. See +g_dbus_connection_call() for the asynchronous version of +this method. +return values. Free with g_variant_unref(). + + %NULL if @error is set. Otherwise a #GVariant tuple with + + + + + A unique or well-known bus name. + + + + Path of remote object. + + + + D-Bus interface to invoke method on. + + + + The name of the method to invoke. + + + + A #GVariant tuple with parameters for the method or %NULL if not passing parameters. + + + + The expected type of the reply, or %NULL. + + + + Flags from the #GDBusCallFlags enumeration. + + + + The timeout in milliseconds or -1 to use the default timeout. + + + + A #GCancellable or %NULL. + + + + + + Closes @connection. Note that this never causes the process to +exit (this might only happen if the other end of a shared message +bus connection disconnects, see #GDBusConnection:exit-on-close). +Once the connection is closed, operations such as sending a message +will return with the error %G_IO_ERROR_CLOSED. Closing a connection +will not automatically flush the connection so queued messages may +be lost. Use g_dbus_connection_flush() if you need such guarantees. +If @connection is already closed, this method fails with +%G_IO_ERROR_CLOSED. +When @connection has been closed, the #GDBusConnection::closed +signal is emitted in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread that @connection was constructed in. +This is an asynchronous method. When the operation is finished, +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this method from. You can +then call g_dbus_connection_close_finish() to get the result of the +operation. See g_dbus_connection_close_sync() for the synchronous +version. + + + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_connection_close(). + + %TRUE if the operation succeeded, %FALSE if @error is set. + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_close(). + + + + + + Synchronously closees @connection. The calling thread is blocked +until this is done. See g_dbus_connection_close() for the +asynchronous version of this method and more details about what it +does. + + %TRUE if the operation succeeded, %FALSE if @error is set. + + + + + A #GCancellable or %NULL. + + + + + + Emits a signal. +If the parameters GVariant is floating, it is consumed. +This can only fail if @parameters is not compatible with the D-Bus protocol. + + %TRUE unless @error is set. + + + + + The unique bus name for the destination for the signal or %NULL to emit to all listeners. + + + + Path of remote object. + + + + D-Bus interface to emit a signal on. + + + + The name of the signal to emit. + + + + A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. + + + + + + Asynchronously flushes @connection, that is, writes all queued +outgoing message to the transport and then flushes the transport +(using g_output_stream_flush_async()). This is useful in programs +that wants to emit a D-Bus signal and then exit +immediately. Without flushing the connection, there is no guarantee +that the message has been sent to the networking buffers in the OS +kernel. +This is an asynchronous method. When the operation is finished, +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this method from. You can +then call g_dbus_connection_flush_finish() to get the result of the +operation. See g_dbus_connection_flush_sync() for the synchronous +version. + + + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_connection_flush(). + + %TRUE if the operation succeeded, %FALSE if @error is set. + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_flush(). + + + + + + Synchronously flushes @connection. The calling thread is blocked +until this is done. See g_dbus_connection_flush() for the +asynchronous version of this method and more details about what it +does. + + %TRUE if the operation succeeded, %FALSE if @error is set. + + + + + A #GCancellable or %NULL. + + + + + + Gets the capabilities negotiated with the remote peer + + Zero or more flags from the #GDBusCapabilityFlags enumeration. + + + + + Gets whether the process is terminated when @connection is +closed by the remote peer. See +#GDBusConnection:exit-on-close for more details. +closed by the remote peer. + + Whether the process is terminated when @connection is + + + + + The GUID of the peer performing the role of server when +authenticating. See #GDBusConnection:guid for more details. + + The GUID. Do not free this string, it is owned by + + + + + Gets the credentials of the authenticated peer. This will always +return %NULL unless @connection acted as a server +(e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed) +when set up and the client passed credentials as part of the +authentication process. +In a message bus setup, the message bus is always the server and +each application is a client. So this method will always return +%NULL for message bus clients. +this object, it is owned by @connection. + + A #GCredentials or %NULL if not available. Do not free + + + + + Gets the underlying stream used for IO. + + the stream used for IO + + + + + Gets the unique name of @connection as assigned by the message +bus. This can also be used to figure out if @connection is a +message bus connection. +bus connection. Do not free this string, it is owned by + + The unique name or %NULL if @connection is not a message + + + + + Gets whether @connection is closed. + + %TRUE if the connection is closed, %FALSE otherwise. + + + + + Registers callbacks for exported objects at @object_path with the +D-Bus interface that is described in @interface_info. +Calls to functions in @vtable (and @user_data_free_func) will +happen in the <link linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this method from. +Note that all #GVariant values passed to functions in @vtable will match +the signature given in @interface_info - if a remote caller passes +incorrect values, the <literal>org.freedesktop.DBus.Error.InvalidArgs</literal> +is returned to the remote caller. +Additionally, if the remote caller attempts to invoke methods or +access properties not mentioned in @interface_info the +<literal>org.freedesktop.DBus.Error.UnknownMethod</literal> resp. +<literal>org.freedesktop.DBus.Error.InvalidArgs</literal> errors +are returned to the caller. +It is considered a programming error if the +#GDBusInterfaceGetPropertyFunc function in @vtable returns a +#GVariant of incorrect type. +If an existing callback is already registered at @object_path and +GDBus automatically implements the standard D-Bus interfaces +org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable +and org.freedesktop.Peer, so you don't have to implement those for +the objects you export. You <emphasis>can</emphasis> implement +org.freedesktop.DBus.Properties yourself, e.g. to handle getting +and setting of properties asynchronously. +Note that the reference count on @interface_info will be +incremented by 1 (unless allocated statically, e.g. if the +reference count is -1, see g_dbus_interface_info_ref()) for as long +as the object is exported. Also note that @vtable will be copied. +See <xref linkend="gdbus-server"/> for an example of how to use this method. +that can be used with g_dbus_connection_unregister_object() . + + 0 if @error is set, otherwise a registration id (never 0) + + + + + The object path to register at. + + + + Introspection data for the interface. + + + + A #GDBusInterfaceVTable to call into or %NULL. + + + + Data to pass to functions in @vtable. + + + + Function to call when the object path is unregistered. + + + + + + Registers a whole subtree of <quote>dynamic</quote> objects. +The @enumerate and @introspection functions in @vtable are used to +convey, to remote callers, what nodes exist in the subtree rooted +by @object_path. +When handling remote calls into any node in the subtree, first the +or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set +the @introspection function is used to check if the node supports the +requested method. If so, the @dispatch function is used to determine +where to dispatch the call. The collected #GDBusInterfaceVTable and +#gpointer will be used to call into the interface vtable for processing +the request. +All calls into user-provided code will be invoked in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this method from. +If an existing subtree is already registered at @object_path or +then @error is set to #G_IO_ERROR_EXISTS. +Note that it is valid to register regular objects (using +g_dbus_connection_register_object()) in a subtree registered with +g_dbus_connection_register_subtree() - if so, the subtree handler +is tried as the last resort. One way to think about a subtree +handler is to consider it a <quote>fallback handler</quote> +for object paths not registered via g_dbus_connection_register_object() +or other bindings. +Note that @vtable will be copied so you cannot change it after +registration. +See <xref linkend="gdbus-subtree-server"/> for an example of how to use this method. +that can be used with g_dbus_connection_unregister_subtree() . + + 0 if @error is set, otherwise a subtree registration id (never 0) + + + + + The object path to register the subtree at. + + + + A #GDBusSubtreeVTable to enumerate, introspect and dispatch nodes in the subtree. + + + + Flags used to fine tune the behavior of the subtree. + + + + Data to pass to functions in @vtable. + + + + Function to call when the subtree is unregistered. + + + + + + Removes a filter. + + + + + + an identifier obtained from g_dbus_connection_add_filter() + + + + + + Asynchronously sends @message to the peer represented by @connection. +Unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number +will be assigned by @connection and set on @message via +g_dbus_message_set_serial(). If @out_serial is not %NULL, then the +serial number used will be written to this location prior to +submitting the message to the underlying transport. +If @connection is closed then the operation will fail with +%G_IO_ERROR_CLOSED. If @message is not well-formed, +the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. +See <xref linkend="gdbus-server"/> and <xref +linkend="gdbus-unix-fd-client"/> for an example of how to use this +low-level API to send and receive UNIX file descriptors. +Note that @message must be unlocked, unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. +transmission, %FALSE if @error is set. + + %TRUE if the message was well-formed and queued for + + + + + A #GDBusMessage + + + + Flags affecting how the message is sent. + + + + Return location for serial number assigned to @message when sending it or %NULL. + + + + + + Asynchronously sends @message to the peer represented by @connection. +Unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number +will be assigned by @connection and set on @message via +g_dbus_message_set_serial(). If @out_serial is not %NULL, then the +serial number used will be written to this location prior to +submitting the message to the underlying transport. +If @connection is closed then the operation will fail with +%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will +fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed, +the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. +This is an asynchronous method. When the operation is finished, @callback will be invoked +in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> +of the thread you are calling this method from. You can then call +g_dbus_connection_send_message_with_reply_finish() to get the result of the operation. +See g_dbus_connection_send_message_with_reply_sync() for the synchronous version. +Note that @message must be unlocked, unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. +See <xref linkend="gdbus-server"/> and <xref +linkend="gdbus-unix-fd-client"/> for an example of how to use this +low-level API to send and receive UNIX file descriptors. + + + + + + A #GDBusMessage. + + + + Flags affecting how the message is sent. + + + + The timeout in milliseconds or -1 to use the default timeout. + + + + Return location for serial number assigned to @message when sending it or %NULL. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_connection_send_message_with_reply(). +Note that @error is only set if a local in-process error +occured. That is to say that the returned #GDBusMessage object may +be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use +g_dbus_message_to_gerror() to transcode this to a #GError. +See <xref linkend="gdbus-server"/> and <xref +linkend="gdbus-unix-fd-client"/> for an example of how to use this +low-level API to send and receive UNIX file descriptors. + + A locked #GDBusMessage or %NULL if @error is set. + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_send_message_with_reply(). + + + + + + Synchronously sends @message to the peer represented by @connection +and blocks the calling thread until a reply is received or the +timeout is reached. See g_dbus_connection_send_message_with_reply() +for the asynchronous version of this method. +Unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number +will be assigned by @connection and set on @message via +g_dbus_message_set_serial(). If @out_serial is not %NULL, then the +serial number used will be written to this location prior to +submitting the message to the underlying transport. +If @connection is closed then the operation will fail with +%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will +fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed, +the operation fails with %G_IO_ERROR_INVALID_ARGUMENT. +Note that @error is only set if a local in-process error +occured. That is to say that the returned #GDBusMessage object may +be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use +g_dbus_message_to_gerror() to transcode this to a #GError. +See <xref linkend="gdbus-server"/> and <xref +linkend="gdbus-unix-fd-client"/> for an example of how to use this +low-level API to send and receive UNIX file descriptors. +Note that @message must be unlocked, unless @flags contain the +%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag. + + A locked #GDBusMessage that is the reply to @message or %NULL if @error is set. + + + + + A #GDBusMessage. + + + + Flags affecting how the message is sent. + + + + The timeout in milliseconds or -1 to use the default timeout. + + + + Return location for serial number assigned to @message when sending it or %NULL. + + + + A #GCancellable or %NULL. + + + + + + Sets whether the process should be terminated when @connection is +closed by the remote peer. See #GDBusConnection:exit-on-close for +more details. + + + + + + Whether the process should be terminated when @connection is closed by the remote peer. + + + + + + Subscribes to signals on @connection and invokes @callback with a +whenever the signal is received. Note that @callback +will be invoked in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this method from. +If @connection is not a message bus connection, @sender must be +%NULL. +If @sender is a well-known name note that @callback is invoked with +the unique name for the owner of @sender, not the well-known name +as one would expect. This is because the message bus rewrites the +name. As such, to avoid certain race conditions, users should be +tracking the name owner of the well-known name and use that when +processing the received signal. + + A subscription identifier that can be used with g_dbus_connection_signal_unsubscribe(). + + + + + Sender name to match on (unique or well-known name) or %NULL to listen from all senders. + + + + D-Bus interface name to match on or %NULL to match on all interfaces. + + + + D-Bus signal name to match on or %NULL to match on all signals. + + + + Object path to match on or %NULL to match on all object paths. + + + + Contents of first string argument to match on or %NULL to match on all kinds of arguments. + + + + Flags describing how to subscribe to the signal (currently unused). + + + + Callback to invoke when there is a signal matching the requested data. + + + + User data to pass to @callback. + + + + Function to free @user_data with when subscription is removed or %NULL. + + + + + + Unsubscribes from signals. + + + + + + A subscription id obtained from g_dbus_connection_signal_subscribe(). + + + + + + If @connection was created with +%G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method +starts processing messages. Does nothing on if @connection wasn't +created with this flag or if the method has already been called. + + + + + + Unregisters an object. + + %TRUE if the object was unregistered, %FALSE otherwise. + + + + + A registration id obtained from g_dbus_connection_register_object(). + + + + + + Unregisters a subtree. + + %TRUE if the subtree was unregistered, %FALSE otherwise. + + + + + A subtree registration id obtained from g_dbus_connection_register_subtree(). + + + + + + A D-Bus address specifying potential endpoints that can be used +when establishing the connection. + + + + A #GDBusAuthObserver object to assist in the authentication process or %NULL. + + + + Flags from the #GDBusCapabilityFlags enumeration +representing connection features negotiated with the other peer. + + + + A boolean specifying whether the connection has been closed. + + + + A boolean specifying whether the process will be terminated (by +calling <literal>raise(SIGTERM)</literal>) if the connection +is closed by the remote peer. + + + + Flags from the #GDBusConnectionFlags enumeration. + + + + The GUID of the peer performing the role of server when +authenticating. +If you are constructing a #GDBusConnection and pass +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER in the +#GDBusConnection:flags property then you MUST also set this +property to a valid guid. +If you are constructing a #GDBusConnection and pass +%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT in the +#GDBusConnection:flags property you will be able to read the GUID +of the other peer here after the connection has been successfully +initialized. + + + + The underlying #GIOStream used for I/O. + + + + The unique name as assigned by the message bus or %NULL if the +connection is not open or not a message bus connection. + + + + Emitted when the connection is closed. +The cause of this event can be +<itemizedlist> +<listitem><para> +If g_dbus_connection_close() is called. In this case +</para></listitem> +<listitem><para> +If the remote peer closes the connection. In this case +</para></listitem> +<listitem><para> +If the remote peer sends invalid or malformed data. In this +case @remote_peer_vanished is set to %FALSE and @error +is set. +</para></listitem> +</itemizedlist> +Upon receiving this signal, you should give up your reference to +once. + + + + + + %TRUE if @connection is closed because the remote peer closed its end of the connection. + + + + A #GError with more details about the event or %NULL. + + + + + + + Flags used when creating a new #GDBusConnection. + + + + + + + + + A generic error; "something went wrong" - see the error message for +more. +There was not enough memory to complete an operation. +The bus doesn't know how to launch a service to supply the bus name +you wanted. +The bus name you referenced doesn't exist (i.e. no application owns +it). +No reply to a message expecting one, usually means a timeout occurred. +Something went wrong reading or writing to a socket, for example. +A D-Bus bus address was malformed. +Requested operation isn't supported (like ENOSYS on UNIX). +Some limited resource is exhausted. +Security restrictions don't allow doing what you're trying to do. +Authentication didn't work. +Unable to connect to server (probably caused by ECONNREFUSED on a +socket). +Certain timeout errors, possibly ETIMEDOUT on a socket. Note that +%G_DBUS_ERROR_NO_REPLY is used for message reply timeouts. Warning: +this is confusingly-named given that %G_DBUS_ERROR_TIMED_OUT also +exists. We can't fix it for compatibility reasons so just be +careful. +No network access (probably ENETUNREACH on a socket). +Can't bind a socket since its address is in use (i.e. EADDRINUSE). +The connection is disconnected and you're trying to use it. +Invalid arguments passed to a method call. +Missing file. +Existing file and the operation you're using does not silently overwrite. +Method name you invoked isn't known by the object you invoked it on. +confusingly-named given that %G_DBUS_ERROR_TIMEOUT also exists. We +can't fix it for compatibility reasons so just be careful. +Tried to remove or modify a match rule that didn't exist. +The match rule isn't syntactically valid. +While starting a new process, the exec() call failed. +While starting a new process, the fork() call failed. +While starting a new process, the child exited with a status code. +While starting a new process, the child exited on a signal. +While starting a new process, something went wrong. +We failed to setup the environment correctly. +We failed to setup the config parser correctly. +Bus name was not valid. +Service file not found in system-services directory. +Permissions are incorrect on the setuid helper. +Service file invalid (Name, User or Exec missing). +Tried to get a UNIX process ID and it wasn't available. +Tried to get a UNIX process ID and it wasn't available. +A type signature is not valid. +A file contains invalid syntax or is otherwise broken. +Asked for SELinux security context and it wasn't available. +Asked for ADT audit data and it wasn't available. +There's already an object with the requested object path. +Error codes for the %G_DBUS_ERROR error domain. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Struct used in g_dbus_error_register_error_domain(). + + + + + + + + + The type of the @get_property function in #GDBusInterfaceVTable. +consumed - otherwise its reference count is decreased by one. + + A #GVariant with the value for @property_name or %NULL if + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that the method was invoked on. + + + + The D-Bus interface name for the property. + + + + The name of the property to get the value of. + + + + Return location for error. + + + + The @user_data #gpointer passed to g_dbus_connection_register_object(). + + + + + + Information about a D-Bus interface. + + + + + + + + + + + + + + + + + + + + Appends an XML representation of @info (and its children) to @string_builder. +This function is typically used for generating introspection XML +documents at run-time for handling the +<literal>org.freedesktop.DBus.Introspectable.Introspect</literal> +method. + + + + + + Indentation level. + + + + A #GString to to append XML data to. + + + + + + Looks up information about a method. +This cost of this function is O(n) in number of methods. + + A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info. + + + + + A D-Bus method name (typically in CamelCase) + + + + + + Looks up information about a property. +This cost of this function is O(n) in number of properties. + + A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info. + + + + + A D-Bus property name (typically in CamelCase). + + + + + + Looks up information about a signal. +This cost of this function is O(n) in number of signals. + + A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info. + + + + + A D-Bus signal name (typically in CamelCase) + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + The type of the @method_call function in #GDBusInterfaceVTable. + + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that the method was invoked on. + + + + The D-Bus interface name the method was invoked on. + + + + The name of the method that was invoked. + + + + A #GVariant tuple with parameters. + + + + A #GDBusMethodInvocation object that can be used to return a value or error. + + + + The @user_data #gpointer passed to g_dbus_connection_register_object(). + + + + + + The type of the @set_property function in #GDBusInterfaceVTable. + + %TRUE if the property was set to @value, %FALSE if @error is set. + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that the method was invoked on. + + + + The D-Bus interface name for the property. + + + + The name of the property to get the value of. + + + + The value to set the property to. + + + + Return location for error. + + + + The @user_data #gpointer passed to g_dbus_connection_register_object(). + + + + + + Virtual table for handling properties and method calls for a D-Bus +interface. +If you want to handle getting/setting D-Bus properties asynchronously, simply +register an object with the <literal>org.freedesktop.DBus.Properties</literal> +D-Bus interface using g_dbus_connection_register_object(). + + + + + + + + + + + + + + + + + The #GDBusMessage structure contains only private data and should +only be accessed using the provided API. + + Creates a new empty #GDBusMessage. + + A #GDBusMessage. Free with g_object_unref(). + + + + + Creates a new #GDBusMessage from the data stored at @blob. The byte +order that the message was in can be retrieved using +g_dbus_message_get_byte_order(). +g_object_unref(). + + A new #GDBusMessage or %NULL if @error is set. Free with + + + + + A blob represent a binary D-Bus message. + + + + The length of @blob. + + + + A #GDBusCapabilityFlags describing what protocol features are supported. + + + + + + Creates a new #GDBusMessage for a method call. + + A #GDBusMessage. Free with g_object_unref(). + + + + + A valid D-Bus name or %NULL. + + + + A valid object path. + + + + A valid D-Bus interface name or %NULL. + + + + A valid method name. + + + + + + Creates a new #GDBusMessage for a signal emission. + + A #GDBusMessage. Free with g_object_unref(). + + + + + A valid object path. + + + + A valid D-Bus interface name. + + + + A valid signal name. + + + + + + Utility function to calculate how many bytes are needed to +completely deserialize the D-Bus message stored at @blob. +determine the size). + + Number of bytes needed or -1 if @error is set (e.g. if + + + + + A blob represent a binary D-Bus message. + + + + The length of @blob (must be at least 16). + + + + + + Copies @message. The copy is a deep copy and the returned +#GDBusMessage is completely identical except that it is guaranteed +to not be locked. +This operation can fail if e.g. @message contains file descriptors +and the per-process or system-wide open files limit is reached. +g_object_unref(). + + A new #GDBusMessage or %NULL if @error is set. Free with + + + + + Convenience to get the first item in the body of @message. + + The string item or %NULL if the first item in the body of + + + + + Gets the body of a message. + + A #GVariant or %NULL if the body is empty. Do not free, it is owned by @message. + + + + + Gets the byte order of @message. + + The byte order. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. + + The value. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. + + The value. + + + + + Gets the flags for @message. + + Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together). + + + + + Gets a header field on @message. +otherwise. Do not free, it is owned by @message. + + A #GVariant with the value if the header was found, %NULL + + + + + A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration) + + + + + + Gets an array of all header fields on @message that are set. +%G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element is a +#guchar. Free with g_free(). + + An array of header fields terminated by + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. + + The value. + + + + + Checks whether @message is locked. To monitor changes to this +value, conncet to the #GObject::notify signal to listen for changes +on the #GDBusMessage:locked property. + + %TRUE if @message is locked, %FALSE otherwise. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. + + The value. + + + + + Gets the type of @message. + + A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration). + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. + + The value. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. + + The value. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. + + The value. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. + + The value. + + + + + Gets the serial for @message. + + A #guint32. + + + + + Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. + + The value. + + + + + Gets the UNIX file descriptors associated with @message, if any. +This method is only available on UNIX. +associated. Do not free, this object is owned by @message. + + A #GUnixFDList or %NULL if no file descriptors are + + + + + If @message is locked, does nothing. Otherwise locks the message. + + + + + + Creates a new #GDBusMessage that is an error reply to @method_call_message. + + A #GDBusMessage. Free with g_object_unref(). + + + + + A valid D-Bus error name. + + + + The D-Bus error message in a printf() format. + + + + + + + + + + Creates a new #GDBusMessage that is an error reply to @method_call_message. + + A #GDBusMessage. Free with g_object_unref(). + + + + + A valid D-Bus error name. + + + + The D-Bus error message. + + + + + + Like g_dbus_message_new_method_error() but intended for language bindings. + + A #GDBusMessage. Free with g_object_unref(). + + + + + A valid D-Bus error name. + + + + The D-Bus error message in a printf() format. + + + + Arguments for @error_message_format. + + + + + + Creates a new #GDBusMessage that is a reply to @method_call_message. + + #GDBusMessage. Free with g_object_unref(). + + + + + Produces a human-readable multi-line description of @message. +The contents of the description has no ABI guarantees, the contents +and formatting is subject to change at any time. Typical output +looks something like this: +<programlisting> +Headers: +path -> objectpath '/org/gtk/GDBus/TestObject' +interface -> 'org.gtk.GDBus.TestInterface' +member -> 'GimmeStdout' +destination -> ':1.146' +UNIX File Descriptors: +(none) +</programlisting> +or +<programlisting> +Headers: +reply-serial -> uint32 4 +destination -> ':1.159' +sender -> ':1.146' +num-unix-fds -> uint32 1 +UNIX File Descriptors: +</programlisting> + + A string that should be freed with g_free(). + + + + + Indentation level. + + + + + + Sets the body @message. As a side-effect the +%G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the +type string of @body (or cleared if @body is %NULL). +If @body is floating, @message assumes ownership of @body. + + + + + + Either %NULL or a #GVariant that is a tuple. + + + + + + Sets the byte order of @message. + + + + + + The byte order. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field. + + + + + + The value to set. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field. + + + + + + The value to set. + + + + + + Sets the flags to set on @message. + + + + + + Flags for @message that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together). + + + + + + Sets a header field on @message. +If @value is floating, @message assumes ownership of @value. + + + + + + A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration) + + + + A #GVariant to set the header field or %NULL to clear the header field. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field. + + + + + + The value to set. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field. + + + + + + The value to set. + + + + + + Sets @message to be of @type. - + A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration). + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field. + + + + + + The value to set. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field. + + + + + + The value to set. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field. + + + + + + The value to set. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field. + + + + + + The value to set. + + + + + + Sets the serial for @message. + + + + + + A #guint32. + + + + + + Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field. + + + + + + The value to set. + + + + + + Sets the UNIX file descriptors associated with @message. As a +side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header +field is set to the number of fds in @fd_list (or cleared if +This method is only available on UNIX. + + + + + + A #GUnixFDList or %NULL. + + + + + + Serializes @message to a blob. The byte order returned by +g_dbus_message_get_byte_order() will be used. +generated by @message or %NULL if @error is set. Free with g_free(). + + A pointer to a valid binary D-Bus message of @out_size bytes + + + + + Return location for size of generated blob. + + + + A #GDBusCapabilityFlags describing what protocol features are supported. + + + + + + If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does +nothing and returns %FALSE. +Otherwise this method encodes the error in @message as a #GError +using g_dbus_error_set_dbus_error() using the information in the +%G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as +well as the first string item in @message's body. + + %TRUE if @error was set, %FALSE otherwise. + + + + + + + + + Enumeration used to describe the byte order of a D-Bus message. + + + + + Signature for function used in g_dbus_connection_add_filter(). +A filter function is passed a #GDBusMessage and expected to return +a #GDBusMessage too. Passive filter functions that don't modify the +message can simply return the @message object: +|[ +static GDBusMessage * +passive_filter (GDBusConnection *connection +GDBusMessage *message, +gboolean incoming, +gpointer user_data) +{ +/<!-- -->* inspect @message *<!-- -->/ +return message; +} +]| +Filter functions that wants to drop a message can simply return %NULL: +|[ +static GDBusMessage * +drop_filter (GDBusConnection *connection +GDBusMessage *message, +gboolean incoming, +gpointer user_data) +{ +if (should_drop_message) +{ +g_object_unref (message); +message = NULL; +} +return message; +} +]| +Finally, a filter function may modify a message by copying it: +|[ +static GDBusMessage * +modifying_filter (GDBusConnection *connection +GDBusMessage *message, +gboolean incoming, +gpointer user_data) +{ +GDBusMessage *copy; +GError *error; +error = NULL; +copy = g_dbus_message_copy (message, &error); +/<!-- -->* handle @error being is set *<!-- -->/ +g_object_unref (message); +/<!-- -->* modify @copy *<!-- -->/ +return copy; +} +]| +If the returned #GDBusMessage is different from @message and cannot +be sent on @connection (it could use features, such as file +descriptors, not compatible with @connection), then a warning is +logged to <emphasis>standard error</emphasis>. Applications can +check this ahead of time using g_dbus_message_to_blob() passing a +#GDBusCapabilityFlags value obtained from @connection. +g_object_unref() or %NULL to drop the message. Passive filter +functions can simply return the passed @message object. + + A #GDBusMessage that will be freed with + + + + + A #GDBusConnection. + + + + A locked #GDBusMessage that the filter function takes ownership of. + + + + %TRUE if it is a message received from the other peer, %FALSE if it is a message to be sent to the other peer. + + + + User data passed when adding the filter. + + + + + + Message flags used in #GDBusMessage. + + + + + + Header fields used in #GDBusMessage. + + + + + + + + + + + + + Message types used in #GDBusMessage. + + + + + + + + Information about a method on an D-Bus interface. + + + + + + + + + + + + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + The #GDBusMethodInvocation structure contains only private data and +should only be accessed using the provided API. + + Gets the #GDBusConnection the method was invoked on. + + A #GDBusConnection. Do not free, it is owned by @invocation. + + + + + Gets the name of the D-Bus interface the method was invoked on. + + A string. Do not free, it is owned by @invocation. + + + + + Gets the #GDBusMessage for the method invocation. This is useful if +you need to use low-level protocol features, such as UNIX file +descriptor passing, that cannot be properly expressed in the +#GVariant API. +See <xref linkend="gdbus-server"/> and <xref +linkend="gdbus-unix-fd-client"/> for an example of how to use this +low-level API to send and receive UNIX file descriptors. + + #GDBusMessage. Do not free, it is owned by @invocation. + + + + + Gets information about the method call, if any. + + A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation. + + + + + Gets the name of the method that was invoked. + + A string. Do not free, it is owned by @invocation. + + + + + Gets the object path the method was invoked on. + + A string. Do not free, it is owned by @invocation. + + + + + Gets the parameters of the method invocation. + + A #GVariant. Do not free, it is owned by @invocation. + + + + + Gets the bus name that invoked the method. + + A string. Do not free, it is owned by @invocation. + + + + + Gets the @user_data #gpointer passed to g_dbus_connection_register_object(). + + A #gpointer. + + + + + Finishes handling a D-Bus method call by returning an error. +This method will free @invocation, you cannot use it afterwards. + + + + + + A valid D-Bus error name. + + + + A valid D-Bus error message. + + + + + + Finishes handling a D-Bus method call by returning an error. +See g_dbus_error_encode_gerror() for details about what error name +will be returned on the wire. In a nutshell, if the given error is +registered using g_dbus_error_register_error() the name given +during registration is used. Otherwise, a name of the form +<literal>org.gtk.GDBus.UnmappedGError.Quark...</literal> is +used. This provides transparent mapping of #GError between +applications using GDBus. +If you are writing an application intended to be portable, +<emphasis>always</emphasis> register errors with g_dbus_error_register_error() +or use g_dbus_method_invocation_return_dbus_error(). +This method will free @invocation, you cannot use it afterwards. + + + + + + A #GQuark for the #GError error domain. + + + + The error code. + + + + printf()-style format. + + + + + + + + + + Like g_dbus_method_invocation_return_error() but without printf()-style formatting. +This method will free @invocation, you cannot use it afterwards. + + + + + + A #GQuark for the #GError error domain. + + + + The error code. + + + + The error message. + + + + + + Like g_dbus_method_invocation_return_error() but intended for +language bindings. +This method will free @invocation, you cannot use it afterwards. + + + + + + A #GQuark for the #GError error domain. + + + + The error code. + + + + printf()-style format. + + + + #va_list of parameters for @format. + + + + + + Like g_dbus_method_invocation_return_error() but takes a #GError +instead of the error domain, error code and message. +This method will free @invocation, you cannot use it afterwards. + + + + + + A #GError. + + + + + + Finishes handling a D-Bus method call by returning @parameters. +If the @parameters GVariant is floating, it is consumed. +It is an error if @parameters is not of the right format. +This method will free @invocation, you cannot use it afterwards. + + + + + + A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters. + + + + + + + Information about nodes in a remote object hierarchy. + + + + + + + + + + + + + + + + + Parses @xml_data and returns a #GDBusNodeInfo representing the data. +with g_dbus_node_info_unref(). + + A #GDBusNodeInfo structure or %NULL if @error is set. Free + + + + + Valid D-Bus introspection XML. + + + + + + Appends an XML representation of @info (and its children) to @string_builder. +This function is typically used for generating introspection XML documents at run-time for +handling the <literal>org.freedesktop.DBus.Introspectable.Introspect</literal> method. + + + + + + Indentation level. + + + + A #GString to to append XML data to. + + + + + + Looks up information about an interface. +This cost of this function is O(n) in number of interfaces. + + A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info. + + + + + A D-Bus interface name. + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + Information about a D-Bus property on a D-Bus interface. + + + + + + + + + + + + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + Flags describing the access control of a D-Bus property. + + + + + + The #GDBusProxy structure contains only private data and +should only be accessed using the provided API. + + + + Finishes creating a #GDBusProxy. + + A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new(). + + + + + + Finishes creating a #GDBusProxy. + + A #GDBusProxy or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus(). + + + + + + Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection. +See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. + + A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). + + + + + A #GBusType. + + + + Flags used when constructing the proxy. + + + + A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + + + + A bus name (well-known or unique). + + + + An object path. + + + + A D-Bus interface name. + + + + A #GCancellable or %NULL. + + + + + + Creates a proxy for accessing @interface_name on the remote object +at @object_path owned by @name at @connection and synchronously +loads D-Bus properties unless the +%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. +If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up +match rules for signals. Connect to the #GDBusProxy::g-signal signal +to handle signals from the remote object. +If @name is a well-known name and the +%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name +owner currently exists, the message bus will be requested to launch +a name owner for the name. +This is a synchronous failable constructor. See g_dbus_proxy_new() +and g_dbus_proxy_new_finish() for the asynchronous version. +See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. + + A #GDBusProxy or %NULL if error is set. Free with g_object_unref(). + + + + + A #GDBusConnection. + + + + Flags used when constructing the proxy. + + + + A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + + + + A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. + + + + An object path. + + + + A D-Bus interface name. + + + + A #GCancellable or %NULL. + + + + + + Creates a proxy for accessing @interface_name on the remote object +at @object_path owned by @name at @connection and asynchronously +loads D-Bus properties unless the +%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to +the #GDBusProxy::g-properties-changed signal to get notified about +property changes. +If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up +match rules for signals. Connect to the #GDBusProxy::g-signal signal +to handle signals from the remote object. +If @name is a well-known name and the +%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START flag isn't set and no name +owner currently exists, the message bus will be requested to launch +a name owner for the name. +This is a failable asynchronous constructor - when the proxy is +ready, @callback will be invoked and you can use +g_dbus_proxy_new_finish() to get the result. +See g_dbus_proxy_new_sync() and for a synchronous version of this constructor. +See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. + + + + + + A #GDBusConnection. + + + + Flags used when constructing the proxy. + + + + A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + + + + A bus name (well-known or unique) or %NULL if @connection is not a message bus connection. + + + + An object path. + + + + A D-Bus interface name. + + + + A #GCancellable or %NULL. + + + + Callback function to invoke when the proxy is ready. + + + + User data to pass to @callback. + + + + + + Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection. +See <xref linkend="gdbus-wellknown-proxy"/> for an example of how #GDBusProxy can be used. + + + + + + A #GBusType. + + + + Flags used when constructing the proxy. + + + + A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL. + + + + A bus name (well-known or unique). + + + + An object path. + + + + A D-Bus interface name. + + + + A #GCancellable or %NULL. + + + + Callback function to invoke when the proxy is ready. + + + + User data to pass to @callback. + + + + + + Asynchronously invokes the @method_name method on @proxy. +If @method_name contains any dots, then @name is split into interface and +method name parts. This allows using @proxy for invoking methods on +other interfaces. +If the #GDBusConnection associated with @proxy is closed then +the operation will fail with %G_IO_ERROR_CLOSED. If +%G_IO_ERROR_CANCELLED. If @parameters contains a value not +compatible with the D-Bus protocol, the operation fails with +%G_IO_ERROR_INVALID_ARGUMENT. +If the @parameters #GVariant is floating, it is consumed. This allows +convenient 'inline' use of g_variant_new(), e.g.: +|[ +g_dbus_proxy_call (proxy, +"TwoStrings", +g_variant_new ("(ss)", +"Thing One", +"Thing Two"), +G_DBUS_CALL_FLAGS_NONE, +-1, +NULL, +(GAsyncReadyCallback) two_strings_done, +&amp;data); +]| +This is an asynchronous method. When the operation is finished, +<link linkend="g-main-context-push-thread-default">thread-default +main loop</link> of the thread you are calling this method from. +You can then call g_dbus_proxy_call_finish() to get the result of +the operation. See g_dbus_proxy_call_sync() for the synchronous +version of this method. + + + + + + Name of method to invoke. + + + + A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. + + + + Flags from the #GDBusCallFlags enumeration. + + + + The timeout in milliseconds or -1 to use the proxy default timeout. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't care about the result of the method invocation. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_proxy_call(). +return values. Free with g_variant_unref(). + + %NULL if @error is set. Otherwise a #GVariant tuple with + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call(). + + + + + + Synchronously invokes the @method_name method on @proxy. +If @method_name contains any dots, then @name is split into interface and +method name parts. This allows using @proxy for invoking methods on +other interfaces. +If the #GDBusConnection associated with @proxy is disconnected then +the operation will fail with %G_IO_ERROR_CLOSED. If +%G_IO_ERROR_CANCELLED. If @parameters contains a value not +compatible with the D-Bus protocol, the operation fails with +%G_IO_ERROR_INVALID_ARGUMENT. +If the @parameters #GVariant is floating, it is consumed. This allows +convenient 'inline' use of g_variant_new(), e.g.: +|[ +g_dbus_proxy_call_sync (proxy, +"TwoStrings", +g_variant_new ("(ss)", +"Thing One", +"Thing Two"), +G_DBUS_CALL_FLAGS_NONE, +-1, +NULL, +&amp;error); +]| +The calling thread is blocked until a reply is received. See +g_dbus_proxy_call() for the asynchronous version of this +method. +return values. Free with g_variant_unref(). + + %NULL if @error is set. Otherwise a #GVariant tuple with + + + + + Name of method to invoke. + + + + A #GVariant tuple with parameters for the signal or %NULL if not passing parameters. + + + + Flags from the #GDBusCallFlags enumeration. + + + + The timeout in milliseconds or -1 to use the proxy default timeout. + + + + A #GCancellable or %NULL. + + + + + + Looks up the value for a property from the cache. This call does no +blocking IO. +If @proxy has an expected interface (see +#GDBusProxy:g-interface-info), then @property_name (for existence) +is checked against it. +for @property_name or %NULL if the value is not in the cache. The +returned reference must be freed with g_variant_unref(). + + A reference to the #GVariant instance that holds the value + + + + + Property name. + + + + + + Gets the names of all cached properties on @proxy. +no cached properties. Free the returned array with g_strfreev(). + + A %NULL-terminated array of strings or %NULL if @proxy has + + + + + + + Gets the connection @proxy is for. + + A #GDBusConnection owned by @proxy. Do not free. + + + + + Gets the timeout to use if -1 (specifying default timeout) is +passed as @timeout_msec in the g_dbus_proxy_call() and +g_dbus_proxy_call_sync() functions. +See the #GDBusProxy:g-default-timeout property for more details. + + Timeout to use for @proxy. + + + + + Gets the flags that @proxy was constructed with. + + Flags from the #GDBusProxyFlags enumeration. + + + + + Returns the #GDBusInterfaceInfo, if any, specifying the minimal +interface that @proxy conforms to. +See the #GDBusProxy:g-interface-info property for more details. +object, it is owned by @proxy. + + A #GDBusInterfaceInfo or %NULL. Do not unref the returned + + + + + Gets the D-Bus interface name @proxy is for. + + A string owned by @proxy. Do not free. + + + + + Gets the name that @proxy was constructed for. + + A string owned by @proxy. Do not free. + + + + + The unique name that owns the name that @proxy is for or %NULL if +no-one currently owns that name. You may connect to the +#GObject::notify signal to track changes to the +#GDBusProxy:g-name-owner property. + + The name owner or %NULL if no name owner exists. Free with g_free(). + + + + + Gets the object path @proxy is for. + + A string owned by @proxy. Do not free. + + + + + If @value is not %NULL, sets the cached value for the property with +name @property_name to the value in @value. +If @value is %NULL, then the cached value is removed from the +property cache. +If @proxy has an expected interface (see +#GDBusProxy:g-interface-info), then @property_name (for existence) +and @value (for the type) is checked against it. +If the @value #GVariant is floating, it is consumed. This allows +convenient 'inline' use of g_variant_new(), e.g. +|[ +g_dbus_proxy_set_cached_property (proxy, +"SomeProperty", +g_variant_new ("(si)", +"A String", +42)); +]| +Normally you will not need to use this method since @proxy is +tracking changes using the +<literal>org.freedesktop.DBus.Properties.PropertiesChanged</literal> +D-Bus signal. However, for performance reasons an object may decide +to not use this signal for some properties and instead use a +proprietary out-of-band mechanism to transmit changes. +As a concrete example, consider an object with a property +<literal>ChatroomParticipants</literal> which is an array of +strings. Instead of transmitting the same (long) array every time +the property changes, it is more efficient to only transmit the +delta using e.g. signals <literal>ChatroomParticipantJoined(String +name)</literal> and <literal>ChatroomParticipantParted(String +name)</literal>. + + + + + + Property name. + + + + Value for the property or %NULL to remove it from the cache. + + + + + + Sets the timeout to use if -1 (specifying default timeout) is +passed as @timeout_msec in the g_dbus_proxy_call() and +g_dbus_proxy_call_sync() functions. +See the #GDBusProxy:g-default-timeout property for more details. + + + + + + Timeout in milliseconds. + + + + + + Ensure that interactions with @proxy conform to the given +interface. For example, when completing a method call, if the type +signature of the message isn't what's expected, the given #GError +is set. Signals that have a type signature mismatch are simply +dropped. +See the #GDBusProxy:g-interface-info property for more details. + + + + + + Minimum interface this proxy conforms to or %NULL to unset. + + + + + + If this property is not %G_BUS_TYPE_NONE, then +#GDBusProxy:g-connection must be %NULL and will be set to the +#GDBusConnection obtained by calling g_bus_get() with the value +of this property. + + + + The #GDBusConnection the proxy is for. + + + + The timeout to use if -1 (specifying default timeout) is passed +as @timeout_msec in the g_dbus_proxy_call() and +g_dbus_proxy_call_sync() functions. +This allows applications to set a proxy-wide timeout for all +remote method invocations on the proxy. If this property is -1, +the default timeout (typically 25 seconds) is used. If set to +%G_MAXINT, then no timeout is used. + + + + Flags from the #GDBusProxyFlags enumeration. + + + + Ensure that interactions with this proxy conform to the given +interface. For example, when completing a method call, if the +type signature of the message isn't what's expected, the given +#GError is set. Signals that have a type signature mismatch are +simply dropped. + + + + The D-Bus interface name the proxy is for. + + + + The well-known or unique name that the proxy is for. + + + + The unique name that owns #GDBusProxy:name or %NULL if no-one +currently owns that name. You may connect to #GObject::notify signal to +track changes to this property. + + + + The object path the proxy is for. + + + + + + + + + + Emitted when one or more D-Bus properties on @proxy changes. The +local cache has already been updated when this signal fires. Note +that both @changed_properties and @invalidated_properties are +guaranteed to never be %NULL (either may be empty though). +This signal corresponds to the +<literal>PropertiesChanged</literal> D-Bus signal on the +<literal>org.freedesktop.DBus.Properties</literal> interface. + + + + + + A #GVariant containing the properties that changed + + + + A %NULL terminated array of properties that was invalidated + + + + + + Emitted when a signal from the remote object and interface that @proxy is for, has been received. + + + + + + The sender of the signal or %NULL if the connection is not a bus connection. + + + + The name of the signal. + + + + A #GVariant tuple with parameters for the signal. + + + + + + + Class structure for #GDBusProxy. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Flags used when constructing an instance of a #GDBusProxy derived class. + + + + + + + + + Flags used when sending #GDBusMessage<!-- -->s on a #GDBusConnection. + + + + + The #GDBusServer structure contains only private data and +should only be accessed using the provided API. + + + Creates a new D-Bus server that listens on the first address in +Once constructed, you can use g_dbus_server_get_client_address() to +get a D-Bus address string that clients can use to connect. +Connect to the #GDBusServer::new-connection signal to handle +incoming connections. +The returned #GDBusServer isn't active - you have to start it with +g_dbus_server_start(). +See <xref linkend="gdbus-peer-to-peer"/> for how #GDBusServer can +be used. +This is a synchronous failable constructor. See +g_dbus_server_new() for the asynchronous version. +g_object_unref(). + + A #GDBusServer or %NULL if @error is set. Free with + + + + + A D-Bus address. + + + + Flags from the #GDBusServerFlags enumeration. + + + + A D-Bus GUID. + + + + A #GDBusAuthObserver or %NULL. + + + + A #GCancellable or %NULL. + + + + + + Gets a D-Bus address string that can be used by clients to connect +to @server. +by @server. + + A D-Bus address string. Do not free, the string is owned + + + + + Gets the flags for @server. + + A set of flags from the #GDBusServerFlags enumeration. + + + + + Gets the GUID for @server. + + A D-Bus GUID. Do not free this string, it is owned by @server. + + + + + Gets whether @server is active. + + %TRUE if server is active, %FALSE otherwise. + + + + + Starts @server. + + + + + + Stops @server. + + + + + + Whether the server is currently active. + + + + The D-Bus address to listen on. + + + + A #GDBusAuthObserver object to assist in the authentication process or %NULL. + + + + The D-Bus address that clients can use. + + + + Flags from the #GDBusServerFlags enumeration. + + + + The guid of the server. + + + + Emitted when a new authenticated connection has been made. Use +g_dbus_connection_get_peer_credentials() to figure out what +identity (if any), was authenticated. +If you want to accept the connection, take a reference to the +connection call g_dbus_connection_close() and give up your +reference. Note that the other peer may disconnect at any time - +a typical thing to do when accepting a connection is to listen to +the #GDBusConnection::closed signal. +If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD +then the signal is emitted in a new thread dedicated to the +connection. Otherwise the signal is emitted in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread that @server was constructed in. +You are guaranteed that signal handlers for this signal runs +before incoming messages on @connection are processed. This means +that it's suitable to call g_dbus_connection_register_object() or +similar from the signal handler. +run. + + %TRUE to claim @connection, %FALSE to let other handlers + + + + + A #GDBusConnection for the new connection. + + + + + + + Flags used when creating a #GDBusServer. + + + + + + Signature for callback function used in g_dbus_connection_signal_subscribe(). + + + + + + A #GDBusConnection. + + + + The unique bus name of the sender of the signal. + + + + The object path that the signal was emitted on. + + + + The name of the interface. + + + + The name of the signal. + + + + A #GVariant tuple with parameters for the signal. + + + + User data passed when subscribing to the signal. + + + + + + Flags used when subscribing to signals via g_dbus_connection_signal_subscribe(). + + + + Information about a signal on a D-Bus interface. + + + + + + + + + + + + + + If @info is statically allocated does nothing. Otherwise increases +the reference count. + + The same @info. + + + + + If @info is statically allocated, does nothing. Otherwise decreases +the reference count of @info. When its reference count drops to 0, +the memory used is freed. + + + + + + + The type of the @dispatch function in #GDBusSubtreeVTable. +Subtrees are flat. @node, if non-%NULL, is always exactly one + + A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods. + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that was registered with g_dbus_connection_register_subtree(). + + + + The D-Bus interface name that the method call or property access is for. + + + + A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree. + + + + Return location for user data to pass to functions in the returned #GDBusInterfaceVTable (never %NULL). + + + + The @user_data #gpointer passed to g_dbus_connection_register_subtree(). + + + + + + The type of the @enumerate function in #GDBusSubtreeVTable. +This function is called when generating introspection data and also +when preparing to dispatch incoming messages in the event that the +%G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is not +Hierarchies are not supported; the items that you return should not +contain the '/' character. +The return value will be freed with g_strfreev(). + + A newly allocated array of strings for node names that are children of @object_path. + + + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that was registered with g_dbus_connection_register_subtree(). + + + + The @user_data #gpointer passed to g_dbus_connection_register_subtree(). + + + + + + Flags passed to g_dbus_connection_register_subtree(). + + + + + The type of the @introspect function in #GDBusSubtreeVTable. +Subtrees are flat. @node, if non-%NULL, is always exactly one +This function should return %NULL to indicate that there is no object +at this node. +If this function returns non-%NULL, the return value is expected to +be a %NULL-terminated array of pointers to #GDBusInterfaceInfo +structures describing the interfaces implemented by @node. This +array will have g_dbus_interface_info_unref() called on each item +before being freed with g_free(). +The difference between returning %NULL and an array containing zero +items is that the standard DBus interfaces will returned to the +remote introspector in the empty array case, but not in the %NULL +case. + + A %NULL-terminated array of pointers to #GDBusInterfaceInfo, or %NULL. + + + + + A #GDBusConnection. + + + + The unique bus name of the remote caller. + + + + The object path that was registered with g_dbus_connection_register_subtree(). + + + + A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree. + + + + The @user_data #gpointer passed to g_dbus_connection_register_subtree(). + + + + + + Virtual table for handling subtrees registered with g_dbus_connection_register_subtree(). + + + + + + + + + + + + + + + + + + + + An implementation of #GBufferedInputStream that allows for high-level +data manipulation of arbitrary data (including binary operations). + + Creates a new data input stream for the @base_stream. + + a new #GDataInputStream. + + + + + a #GInputStream. + + + + + + Gets the byte order for the data input stream. + + the @stream's current #GDataStreamByteOrder. + + + - + Gets the current newline type for the @stream. + + #GDataStreamNewlineType for the given @stream. + Reads an unsigned 8-bit/1-byte value from @stream. +if an error occurred. - + an unsigned 8-bit/1-byte value read from the @stream or %0 + + optional #GCancellable object, %NULL to ignore. @@ -2183,27 +9702,19 @@ data manipulation of arbitrary data (including binary operations)." + Reads a 16-bit/2-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). +an error occurred. - - - - - - - - - - - + a signed 16-bit/2-byte value read from @stream or %0 if + + optional #GCancellable object, %NULL to ignore. @@ -2211,27 +9722,22 @@ data manipulation of arbitrary data (including binary operations)." + Reads a signed 32-bit/4-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +an error occurred. - - - - - - - - - - - + a signed 32-bit/4-byte value read from the @stream or %0 if + + optional #GCancellable object, %NULL to ignore. @@ -2239,27 +9745,22 @@ data manipulation of arbitrary data (including binary operations)." + Reads a 64-bit/8-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +an error occurred. - - - - - - - - - - - + a signed 64-bit/8-byte value read from @stream or %0 if + + optional #GCancellable object, %NULL to ignore. @@ -2267,128 +9768,408 @@ data manipulation of arbitrary data (including binary operations)." + Reads a line from the data input stream. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Set @length to a #gsize to get the length of the read line. +On an error, it will return %NULL and @error will be set. If there's no +content to read, it will still return %NULL, but @error won't be set. + a string with the line that was read in (without the newlines). - - + + a #gsize to get the length of the data read in. + + optional #GCancellable object, %NULL to ignore. + c:identifier="g_data_input_stream_read_line_async" + version="2.20"> + The asynchronous version of g_data_input_stream_read_line(). It is +an error to have two outstanding calls to this function. +When the operation is finished, @callback will be called. You +can then call g_data_input_stream_read_line_finish() to get +the result of the operation. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="3"> + callback to call when the request is satisfied. - + the data to pass to callback function. + + Finish an asynchronous call started by +g_data_input_stream_read_line_async(). +Set @length to a #gsize to get the length of the read line. +On an error, it will return %NULL and @error will be set. If there's no +content to read, it will still return %NULL, but @error won't be set. + a string with the line that was read in (without the newlines). + the #GAsyncResult that was provided to the callback. - - + + a #gsize to get the length of the data read in. + + + + + + Reads an unsigned 16-bit/2-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). +an error occurred. + + an unsigned 16-bit/2-byte value read from the @stream or %0 if + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Reads an unsigned 32-bit/4-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +an error occurred. + + an unsigned 32-bit/4-byte value read from the @stream or %0 if + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Reads an unsigned 64-bit/8-byte value from @stream. +In order to get the correct byte order for this read operation, +see g_data_input_stream_get_byte_order(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +an error occurred. + + an unsigned 64-bit/8-byte read from @stream or %0 if + + + + + optional #GCancellable object, %NULL to ignore. + + Reads a string from the data input stream, up to the first +occurrence of any of the stop characters. +Note that, in contrast to g_data_input_stream_read_until_async(), +this function consumes the stop character that it finds. +Don't use this function in new code. Its functionality is +inconsistent with g_data_input_stream_read_until_async(). Both +functions will be marked as deprecated in a future release. Use +g_data_input_stream_read_upto() instead, but note that that function +does not consume the stop character. +any of the stop characters. Set @length to a #gsize to get the length +of the string. This function will return %NULL on an error. + a string with the data that was read before encountering + characters to terminate the read. - - + + a #gsize to get the length of the data read in. + + optional #GCancellable object, %NULL to ignore. + c:identifier="g_data_input_stream_read_until_async" + version="2.20"> + The asynchronous version of g_data_input_stream_read_until(). +It is an error to have two outstanding calls to this function. +Note that, in contrast to g_data_input_stream_read_until(), +this function does not consume the stop character that it finds. You +must read it for yourself. +When the operation is finished, @callback will be called. You +can then call g_data_input_stream_read_until_finish() to get +the result of the operation. +Don't use this function in new code. Its functionality is +inconsistent with g_data_input_stream_read_until(). Both functions +will be marked as deprecated in a future release. Use +g_data_input_stream_read_upto_async() instead. + characters to terminate the read. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + + + + callback to call when the request is satisfied. + + + + the data to pass to callback function. + + + + + + Finish an asynchronous call started by +g_data_input_stream_read_until_async(). +any of the stop characters. Set @length to a #gsize to get the length +of the string. This function will return %NULL on an error. + + a string with the data that was read before encountering + + + + + the #GAsyncResult that was provided to the callback. + + + + a #gsize to get the length of the data read in. + + + + + + Reads a string from the data input stream, up to the first +occurrence of any of the stop characters. +In contrast to g_data_input_stream_read_until(), this function +does <emphasis>not</emphasis> consume the stop character. You have +to use g_data_input_stream_read_byte() to get it before calling +g_data_input_stream_read_upto() again. +Note that @stop_chars may contain '\0' if @stop_chars_len is +specified. +any of the stop characters. Set @length to a #gsize to get the length +of the string. This function will return %NULL on an error + + a string with the data that was read before encountering + + + + + characters to terminate the read + + + + length of @stop_chars. May be -1 if @stop_chars is nul-terminated + + + + a #gsize to get the length of the data read in + + + + optional #GCancellable object, %NULL to ignore + + + + + + The asynchronous version of g_data_input_stream_read_upto(). +It is an error to have two outstanding calls to this function. +In contrast to g_data_input_stream_read_until(), this function +does <emphasis>not</emphasis> consume the stop character. You have +to use g_data_input_stream_read_byte() to get it before calling +g_data_input_stream_read_upto() again. +Note that @stop_chars may contain '\0' if @stop_chars_len is +specified. +When the operation is finished, @callback will be called. You +can then call g_data_input_stream_read_upto_finish() to get +the result of the operation. + + + + + + characters to terminate the read + + + + length of @stop_chars. May be -1 if @stop_chars is nul-terminated + + + + + + + optional #GCancellable object, %NULL to ignore + callback to call when the request is satisfied - + the data to pass to callback function + - + Finish an asynchronous call started by +g_data_input_stream_read_upto_async(). +Note that this function does <emphasis>not</emphasis> consume the +stop character. You have to use g_data_input_stream_read_byte() to +get it before calling g_data_input_stream_read_upto_async() again. +any of the stop characters. Set @length to a #gsize to get the length +of the string. This function will return %NULL on an error. + a string with the data that was read before encountering + the #GAsyncResult that was provided to the callback - - + + a #gsize to get the length of the data read in + - - + + This function sets the byte order for the given @stream. All subsequent +reads from the @stream will be read in the given @order. + + + + + + a #GDataStreamByteOrder to set. + + + + + + Sets the newline type for the @stream. +Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read +chunk ends in "CR" we must read an additional byte to know if this is "CR" or +"CR LF", and this might block if there is no more data availible. + + + + + + the type of new line return as #GDataStreamNewlineType. + + + + + + - - + + @@ -2404,92 +10185,93 @@ data manipulation of arbitrary data (including binary operations)." - - + + - - + + - - + + - - + + - - + + - + + An implementation of #GBufferedOutputStream that allows for high-level +data manipulation of arbitrary data (including binary operations). + Creates a new data output stream for @base_stream. + #GDataOutputStream. + a #GOutputStream. - - - - - - - - - - - + Gets the byte order for the stream. + + the #GDataStreamByteOrder for the @stream. + Puts a byte into the output stream. - + %TRUE if @data was successfully added to the @stream. + - + a #guchar. + + optional #GCancellable object, %NULL to ignore. @@ -2497,33 +10279,20 @@ data manipulation of arbitrary data (including binary operations)." + Puts a signed 16-bit integer into the output stream. - + %TRUE if @data was successfully added to the @stream. + - - - - - - - - - - - - - - + a #gint16. + + optional #GCancellable object, %NULL to ignore. @@ -2531,33 +10300,20 @@ data manipulation of arbitrary data (including binary operations)." + Puts a signed 32-bit integer into the output stream. - + %TRUE if @data was successfully added to the @stream. + - - - - - - - - - - - - - - + a #gint32. + + optional #GCancellable object, %NULL to ignore. @@ -2565,33 +10321,20 @@ data manipulation of arbitrary data (including binary operations)." + Puts a signed 64-bit integer into the stream. - + %TRUE if @data was successfully added to the @stream. + - - - - - - - - - - - - - - + a #gint64. + + optional #GCancellable object, %NULL to ignore. @@ -2599,22 +10342,104 @@ data manipulation of arbitrary data (including binary operations)." + Puts a string into the output stream. - + %TRUE if @string was successfully added to the @stream. + + a string. + optional #GCancellable object, %NULL to ignore. - - + + Puts an unsigned 16-bit integer into the output stream. + + %TRUE if @data was successfully added to the @stream. + + + + + a #guint16. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Puts an unsigned 32-bit integer into the stream. + + %TRUE if @data was successfully added to the @stream. + + + + + a #guint32. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Puts an unsigned 64-bit integer into the stream. + + %TRUE if @data was successfully added to the @stream. + + + + + a #guint64. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets the byte order of the data output stream to @order. + + + + + + a %GDataStreamByteOrder. + + + + + + Determines the byte ordering that is used when writing +multi-byte entities (such as integers) to the stream. + @@ -2631,50 +10456,52 @@ data manipulation of arbitrary data (including binary operations)." - - + + - - + + - - + + - - + + - - + + - + + #GDataStreamByteOrder is used to ensure proper endianness of streaming data sources +across various machine architectures. + #GDataStreamNewlineType is used when checking for or setting the line endings for a given file. + Information about an installed application from a desktop file. + + Creates a new #GDesktopAppInfo based on a desktop file id. +A desktop file id is the basename of the desktop file, including the +.desktop extension. GIO is looking for a desktop file with this name +in the <filename>applications</filename> subdirectories of the XDG data +directories (i.e. the directories specified in the +<envar>XDG_DATA_HOME</envar> and <envar>XDG_DATA_DIRS</envar> environment +variables). GIO also supports the prefix-to-subdirectory mapping that is +described in the <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Menu Spec</ulink> +(i.e. a desktop id of kde-foo.desktop will match +<filename>/usr/share/applications/kde/foo.desktop</filename>). + + a new #GDesktopAppInfo, or %NULL if no desktop file with that id + + + + + the desktop file id + + + + + Creates a new #GDesktopAppInfo. + a new #GDesktopAppInfo or %NULL on error. + the path of a desktop file, in the GLib filename encoding + c:identifier="g_desktop_app_info_new_from_keyfile" + version="2.18"> + Creates a new #GDesktopAppInfo. + a new #GDesktopAppInfo or %NULL on error. + an opened #GKeyFile - - - - - - - - - - + Sets the name of the desktop that the application is running in. +This is used by g_app_info_should_show() to evaluate the +<literal>OnlyShowIn</literal> and <literal>NotShowIn</literal> +desktop entry fields. +The <ulink url="http://standards.freedesktop.org/menu-spec/latest/">Desktop +Menu specification</ulink> recognizes the following: +<simplelist> +<member>GNOME</member> +<member>KDE</member> +<member>ROX</member> +<member>XFCE</member> +<member>Old</member> +</simplelist> +Should be called only once; subsequent calls are ignored. + a string specifying what desktop this is + c:identifier="g_desktop_app_info_get_filename" + version="2.24"> + When @info was created from a known filename, return it. In some +situations such as the #GDesktopAppInfo returned from +g_desktop_app_info_new_from_keyfile(), this function will return %NULL. + The full path to the file for @info, or %NULL if not known. + A desktop file is hidden if the Hidden key in it is +set to True. - + %TRUE if hidden, %FALSE otherwise. + @@ -2781,30 +10652,49 @@ across various machine architectures." + Interface that is used by backends to associate default +handlers with URI schemes. + Gets the default application for launching applications +using this URI scheme for a particular GDesktopAppInfoLookup +implementation. +The GDesktopAppInfoLookup interface and this function is used +to implement g_app_info_get_default_for_uri_scheme() backends +in a GIO module. There is no reason for applications to use it +directly. Applications should use g_app_info_get_default_for_uri_scheme(). + #GAppInfo for given @uri_scheme or %NULL on error. + a string containing a URI scheme. + Gets the default application for launching applications +using this URI scheme for a particular GDesktopAppInfoLookup +implementation. +The GDesktopAppInfoLookup interface and this function is used +to implement g_app_info_get_default_for_uri_scheme() backends +in a GIO module. There is no reason for applications to use it +directly. Applications should use g_app_info_get_default_for_uri_scheme(). + #GAppInfo for given @uri_scheme or %NULL on error. + a string containing a URI scheme. @@ -2817,9 +10707,9 @@ handlers with URI schemes." - + + #GAppInfo for given @uri_scheme or %NULL on error. @@ -2828,6 +10718,7 @@ handlers with URI schemes." c:type="GDesktopAppInfoLookup*"/> + a string containing a URI scheme. @@ -2835,568 +10726,833 @@ handlers with URI schemes." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Opaque drive object. + Checks if a drive can be ejected. - + %TRUE if the @drive can be ejected, %FALSE otherwise. + + Checks if a drive can be polled for media changes. +%FALSE otherwise. - + %TRUE if the @drive can be polled for media changes, + - + + Checks if a drive can be started. + + %TRUE if the @drive can be started, %FALSE otherwise. + + + + + Checks if a drive can be started degraded. + + %TRUE if the @drive can be started degraded, %FALSE otherwise. + + + + + Checks if a drive can be stopped. + + %TRUE if the @drive can be stopped, %FALSE otherwise. + + + + + Asynchronously ejects a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_eject_finish() to obtain the +result of the operation. + flags affecting the unmount if required for eject - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback, or %NULL. + + + + user data to pass to @callback + + + + + + Finishes ejecting a drive. +%FALSE otherwise. + + %TRUE if the drive has been ejected successfully, + + + + + a #GAsyncResult. + + + + + + Ejects a drive. This is an asynchronous operation, and is +finished by calling g_drive_eject_with_operation_finish() with the @drive +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the unmount if required for eject + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a drive. If any errors occurred during the operation, + + %TRUE if the drive was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Gets the kinds of identifiers that @drive has. +Use g_drive_get_identifer() to obtain the identifiers +themselves. +kinds of identifiers. Use g_strfreev() to free. + + a %NULL-terminated array of strings containing + + + + + + + Gets the icon for @drive. +Free the returned object with g_object_unref(). + + #GIcon for the @drive. + + + + + Gets the identifier of the given kind for @drive. +requested identfier, or %NULL if the #GDrive +doesn't have this kind of identifier. + + a newly allocated string containing the + + + + + the kind of identifier to return + + + + + + Gets the name of @drive. +string should be freed when no longer needed. + + a string containing @drive's name. The returned + + + + + Gets a hint about how a drive can be started/stopped. + + A value from the #GDriveStartStopType enumeration. + + + + + Get a list of mountable volumes for @drive. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + + #GList containing any #GVolume objects on the given @drive. + + + + + + + Checks if the @drive has media. Note that the OS may not be polling +the drive for media changes; see g_drive_is_media_check_automatic() +for more details. + + %TRUE if @drive has media, %FALSE otherwise. + + + + + Check if @drive has any mountable volumes. + + %TRUE if the @drive contains volumes, %FALSE otherwise. + + + + + Checks if @drive is capabable of automatically detecting media changes. +media changes, %FALSE otherwise. + + %TRUE if the @drive is capabable of automatically detecting + + + + + Checks if the @drive supports removable media. + + %TRUE if @drive supports removable media, %FALSE otherwise. + + + + + Asynchronously polls @drive to see if media has been inserted or removed. +When the operation is finished, @callback will be called. +You can then call g_drive_poll_for_media_finish() to obtain the +result of the operation. + + + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data to pass to @callback + + + + + + Finishes an operation started with g_drive_poll_for_media() on a drive. +%FALSE otherwise. + + %TRUE if the drive has been poll_for_mediaed successfully, + + + + + a #GAsyncResult. + + + + + + Asynchronously starts a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_start_finish() to obtain the +result of the operation. + + + + + + flags affecting the start operation. + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data to pass to @callback + + + + + + Finishes starting a drive. +%FALSE otherwise. + + %TRUE if the drive has been started successfully, + + + + + a #GAsyncResult. + + + + + + Asynchronously stops a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_stop_finish() to obtain the +result of the operation. + + + + + + flags affecting the unmount if required for stopping. + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data to pass to @callback + + + + + + Finishes stopping a drive. +%FALSE otherwise. + + %TRUE if the drive has been stopped successfully, + + + + + a #GAsyncResult. + + + + + + Checks if a drive can be ejected. + + %TRUE if the @drive can be ejected, %FALSE otherwise. + + + + + Checks if a drive can be polled for media changes. +%FALSE otherwise. + + %TRUE if the @drive can be polled for media changes, + + + + + Checks if a drive can be started. + + %TRUE if the @drive can be started, %FALSE otherwise. + + + + + Checks if a drive can be started degraded. + + %TRUE if the @drive can be started degraded, %FALSE otherwise. + + + + + Checks if a drive can be stopped. + + %TRUE if the @drive can be stopped, %FALSE otherwise. + + + + + Asynchronously ejects a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_eject_finish() to obtain the +result of the operation. + + + + + + flags affecting the unmount if required for eject + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + + + + + + Finishes ejecting a drive. +%FALSE otherwise. + + %TRUE if the drive has been ejected successfully, + + + + + a #GAsyncResult. + + + + + + Ejects a drive. This is an asynchronous operation, and is +finished by calling g_drive_eject_with_operation_finish() with the @drive +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the unmount if required for eject + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a drive. If any errors occurred during the operation, + + %TRUE if the drive was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Gets the kinds of identifiers that @drive has. +Use g_drive_get_identifer() to obtain the identifiers +themselves. +kinds of identifiers. Use g_strfreev() to free. + + a %NULL-terminated array of strings containing + + + + + + + Gets the icon for @drive. +Free the returned object with g_object_unref(). + + #GIcon for the @drive. + + + + + Gets the identifier of the given kind for @drive. +requested identfier, or %NULL if the #GDrive +doesn't have this kind of identifier. + + a newly allocated string containing the + + + + + the kind of identifier to return + + + + + + Gets the name of @drive. +string should be freed when no longer needed. + + a string containing @drive's name. The returned + + + + + Gets a hint about how a drive can be started/stopped. + + A value from the #GDriveStartStopType enumeration. + + + + + Get a list of mountable volumes for @drive. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + + #GList containing any #GVolume objects on the given @drive. + + + + + + + Checks if the @drive has media. Note that the OS may not be polling +the drive for media changes; see g_drive_is_media_check_automatic() +for more details. + + %TRUE if @drive has media, %FALSE otherwise. + + + + + Check if @drive has any mountable volumes. + + %TRUE if the @drive contains volumes, %FALSE otherwise. + + + + + Checks if @drive is capabable of automatically detecting media changes. +media changes, %FALSE otherwise. + + %TRUE if the @drive is capabable of automatically detecting + + + + + Checks if the @drive supports removable media. + + %TRUE if @drive supports removable media, %FALSE otherwise. + + + + + Asynchronously polls @drive to see if media has been inserted or removed. +When the operation is finished, @callback will be called. +You can then call g_drive_poll_for_media_finish() to obtain the +result of the operation. + + + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data to pass to @callback + + Finishes an operation started with g_drive_poll_for_media() on a drive. +%FALSE otherwise. - + %TRUE if the drive has been poll_for_mediaed successfully, + + a #GAsyncResult. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Asynchronously starts a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_start_finish() to obtain the +result of the operation. + flags affecting the start operation. + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. + closure="4"> + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + + Finishes starting a drive. +%FALSE otherwise. - + %TRUE if the drive has been started successfully, + + a #GAsyncResult. - - - - - - + + Asynchronously stops a drive. +When the operation is finished, @callback will be called. +You can then call g_drive_stop_finish() to obtain the +result of the operation. + flags affecting the unmount if required for stopping. + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. + closure="4"> + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Finishes stopping a drive. +%FALSE otherwise. - + %TRUE if the drive has been stopped successfully, + + a #GAsyncResult. - - + Emitted when the drive's state has changed. + + - - + This signal is emitted when the #GDrive have been +disconnected. If the recipient is holding references to the +object they should release them so the object can be +finalized. + + - - + Emitted when the physical eject button (if any) of a drive has +been pressed. + + - - - + + Emitted when the physical stop button (if any) of a drive has +been pressed. + + + glib:is-gtype-struct-for="Drive"> + Interface for creating #GDrive implementations. - + @@ -3408,7 +11564,7 @@ Interface for creating #GDrive implementations."> - + @@ -3420,7 +11576,7 @@ Interface for creating #GDrive implementations."> - + @@ -3432,8 +11588,9 @@ Interface for creating #GDrive implementations."> - + + a string containing @drive's name. The returned @@ -3444,8 +11601,9 @@ Interface for creating #GDrive implementations."> - + + #GIcon for the @drive. @@ -3456,9 +11614,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive contains volumes, %FALSE otherwise. + @@ -3468,9 +11627,12 @@ Interface for creating #GDrive implementations."> - + - + #GList containing any #GVolume objects on the given @drive. + + + @@ -3480,9 +11642,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if @drive supports removable media, %FALSE otherwise. + @@ -3492,9 +11655,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if @drive has media, %FALSE otherwise. + @@ -3504,10 +11668,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive is capabable of automatically detecting + @@ -3517,9 +11681,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive can be ejected, %FALSE otherwise. + @@ -3529,9 +11694,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive can be polled for media changes, + @@ -3541,7 +11707,7 @@ Interface for creating #GDrive implementations."> - + @@ -3550,39 +11716,48 @@ Interface for creating #GDrive implementations."> + flags affecting the unmount if required for eject + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + - + - + %TRUE if the drive has been ejected successfully, + + a #GAsyncResult. - + @@ -3593,37 +11768,44 @@ Interface for creating #GDrive implementations."> + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + - + - + %TRUE if the drive has been poll_for_mediaed successfully, + + a #GAsyncResult. - + + a newly allocated string containing the @@ -3631,14 +11813,16 @@ Interface for creating #GDrive implementations."> + the kind of identifier to return - + + a %NULL-terminated array of strings containing @@ -3651,8 +11835,9 @@ Interface for creating #GDrive implementations."> - - + + + A value from the #GDriveStartStopType enumeration. @@ -3663,9 +11848,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive can be started, %FALSE otherwise. + @@ -3675,9 +11861,10 @@ Interface for creating #GDrive implementations."> - + - + %TRUE if the @drive can be started degraded, %FALSE otherwise. + @@ -3687,7 +11874,7 @@ Interface for creating #GDrive implementations."> - + @@ -3696,44 +11883,55 @@ Interface for creating #GDrive implementations."> + flags affecting the start operation. + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + - + - + %TRUE if the drive has been started successfully, + + a #GAsyncResult. - + - + %TRUE if the @drive can be stopped, %FALSE otherwise. + @@ -3743,7 +11941,7 @@ Interface for creating #GDrive implementations."> - + @@ -3752,42 +11950,52 @@ Interface for creating #GDrive implementations."> + flags affecting the unmount if required for stopping. + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data to pass to @callback + - + - + %TRUE if the drive has been stopped successfully, + + a #GAsyncResult. - + @@ -3799,7 +12007,7 @@ Interface for creating #GDrive implementations."> - + @@ -3808,37 +12016,45 @@ Interface for creating #GDrive implementations."> + flags affecting the unmount if required for eject + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the drive was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. @@ -3846,30 +12062,22 @@ Interface for creating #GDrive implementations."> + Flags used when starting a drive. + Enumeration describing how a drive can be started/stopped. + An object for Emblems - + + Creates a new emblem for @icon. + a new #GEmblem. + a GIcon containing the icon. + c:identifier="g_emblem_new_with_origin" + version="2.18"> + Creates a new emblem for @icon. + a new #GEmblem. + a GIcon containing the icon. + a GEmblemOrigin enum defining the emblem's origin - + + Gives back the icon from @emblem. +and should not be modified or freed. + a #GIcon. The returned object belongs to the emblem - - + + Gets the origin of the emblem. + + the origin of the emblem - - + + - - + + + GEmblemOrigin is used to add information about the origin of the emblem +to #GEmblem. + An implementation of #GIcon for icons with emblems. - + + Creates a new emblemed icon for @icon with the emblem @emblem. - + a new #GIcon + + a #GIcon + a #GEmblem - - - - - - - - - - - - + + + Adds @emblem to the #GList of #GEmblem <!-- -->s. + a #GEmblem + + Gets the list of emblems for the @icon. +is owned by @emblemed + + a #GList of #GEmblem <!-- -->s that + + + + + + + Gets the main icon for @emblemed. + + a #GIcon that is owned by @emblemed + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + A handle to an object implementing the #GFileIface interface. +Generally stores a location within the file system. Handles do not +necessarily represent files or directories that currently exist. + Gets an output stream for appending data to the file. If +the file doesn't already exist it is created. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Some file systems don't allow all file names, and may +return an %G_IO_ERROR_INVALID_FILENAME error. +If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be +returned. Other errors are possible too, and depend on what kind of +filesystem the file is on. +Free the returned object with g_object_unref(). + a #GFileOutputStream, or %NULL on error. + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. + Asynchronously opens @file for appending. +For more details, see g_file_append_to() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_append_to_finish() to get the result of the operation. + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + + Finishes an asynchronous file append operation started with +g_file_append_to_async(). +Free the returned object with g_object_unref(). + a valid #GFileOutputStream or %NULL on error. + #GAsyncResult + + + + + + Copies the file @source to the location specified by @destination. +Can not handle recursive copies of directories. +If the flag #G_FILE_COPY_OVERWRITE is specified an already +existing @destination file is overwritten. +If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks +will be copied as symlinks, otherwise the target of the +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If @progress_callback is not %NULL, then the operation can be monitored by +setting this to a #GFileProgressCallback function. @progress_callback_data +will be passed to this function. It is guaranteed that this callback will +be called after all data has been transferred with the total number of bytes +copied during the operation. +If the @source file does not exist then the G_IO_ERROR_NOT_FOUND +error is returned, independent on the status of the @destination. +If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the +error G_IO_ERROR_EXISTS is returned. +If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY +error is returned. If trying to overwrite a directory with a directory the +G_IO_ERROR_WOULD_MERGE error is returned. +If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is +specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error +is returned. +If you are interested in copying the #GFile object itself (not the on-disk +file), see g_file_dup(). + + %TRUE on success, %FALSE otherwise. + + + + + destination #GFile + + + + set of #GFileCopyFlags + + + + optional #GCancellable object, %NULL to ignore. + + + + function to callback with progress information + + + + user data to pass to @progress_callback + + + + + + Copies the file @source to the location specified by @destination +asynchronously. For details of the behaviour, see g_file_copy(). +If @progress_callback is not %NULL, then that function that will be called +just like in g_file_copy(), however the callback will run in the main loop, +not in the thread that is doing the I/O operation. +When the operation is finished, @callback will be called. You can then call +g_file_copy_finish() to get the result of the operation. + + + + + + destination #GFile + + + + set of #GFileCopyFlags + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + function to callback with progress information + + + + user data to pass to @progress_callback + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes copying the file started with +g_file_copy_async(). + + a %TRUE on success, %FALSE on error. + + + + + a #GAsyncResult. + Creates a new file and returns an output stream for writing to it. +The file must not already exist. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If a file or directory with this name already exists the G_IO_ERROR_EXISTS +error will be returned. +Some file systems don't allow all file names, and may +return an G_IO_ERROR_INVALID_FILENAME error, and if the name +is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. +Other errors are possible too, and depend on what kind of +filesystem the file is on. +%NULL on error. +Free the returned object with g_object_unref(). + a #GFileOutputStream for the newly created file, or + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. + Asynchronously creates a new file and returns an output stream for writing to it. +The file must not already exist. +For more details, see g_file_create() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_create_finish() to get the result of the operation. + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + + Finishes an asynchronous file create operation started with +g_file_create_async(). +Free the returned object with g_object_unref(). + a #GFileOutputStream or %NULL on error. + a #GAsyncResult. - + + Creates a new file and returns a stream for reading and writing to it. +The file must not already exist. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If a file or directory with this name already exists the %G_IO_ERROR_EXISTS +error will be returned. Some file systems don't allow all file names, +and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name +is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors +are possible too, and depend on what kind of filesystem the file is on. +Note that in many non-local file cases read and write streams are not +supported, so make sure you really need to do read and write streaming, +rather than just opening for reading or writing. +Free the returned object with g_object_unref(). - + a #GFileIOStream for the newly created file, or %NULL on error. + - - - - - - + a set of #GFileCreateFlags + optional #GCancellable object, %NULL to ignore - + + Asynchronously creates a new file and returns a stream for reading and +writing to it. The file must not already exist. +For more details, see g_file_create_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then +call g_file_create_readwrite_finish() to get the result of the operation. - - - - - - + a set of #GFileCreateFlags - + the <link linkend="io-priority">I/O priority</link> of the request + + optional #GCancellable object, %NULL to ignore - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + - + Finishes an asynchronous file create operation started with +g_file_create_readwrite_async(). +Free the returned object with g_object_unref(). - + a #GFileIOStream or %NULL on error. + + a #GAsyncResult - + + Deletes a file. If the @file is a directory, it will only be deleted if it +is empty. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - + %TRUE if the file was deleted. %FALSE otherwise. + + optional #GCancellable object, %NULL to ignore. - + + Duplicates a #GFile handle. This operation does not duplicate +the actual file or directory represented by the #GFile; see +g_file_copy() if attempting to copy a file. +This call does no blocking i/o. + + a new #GFile that is a duplicate of the given #GFile. + + + + + Starts an asynchronous eject on a mountable. +When this operation has completed, @callback will be called with +g_file_eject_mountable_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an asynchronous eject operation started by +g_file_eject_mountable(). +otherwise. + + %TRUE if the @file was ejected successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Starts an asynchronous eject on a mountable. +When this operation has completed, @callback will be called with +g_file_eject_mountable_with_operation_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an asynchronous eject operation started by +g_file_eject_mountable_with_operation(). +otherwise. + + %TRUE if the @file was ejected successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Gets the requested information about the files in a directory. The result +is a #GFileEnumerator object that will give out #GFileInfo objects for +all the files in the directory. +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "standard::*" means all attributes in the standard +namespace. An example attribute query be "standard::*,owner::user". +The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned. +Other errors are possible too. +Free the returned object with g_object_unref(). + + A #GFileEnumerator if successful, %NULL on error. + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously gets the requested information about the files in a directory. The result +is a #GFileEnumerator object that will give out #GFileInfo objects for +all the files in the directory. +For more details, see g_file_enumerate_children() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_enumerate_children_finish() to get the result of the operation. + + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an async enumerate children operation. +See g_file_enumerate_children_async(). +Free the returned object with g_object_unref(). + + a #GFileEnumerator or %NULL if an error occurred. + + + + + a #GAsyncResult. + + + + + + Checks equality of two given #GFile<!-- -->s. Note that two +#GFile<!-- -->s that differ can still refer to the same +file on the filesystem due to various forms of filename +aliasing. +This call does no blocking i/o. +%FALSE if either is not a #GFile. + + %TRUE if @file1 and @file2 are equal. + + + + + the second #GFile. + + + + + + Gets a #GMount for the #GFile. +If the #GFileIface for @file does not have a mount (e.g. possibly a +remote share), @error will be set to %G_IO_ERROR_NOT_FOUND and %NULL +will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). + + a #GMount where the @file is located or %NULL on error. + + optional #GCancellable object, %NULL to ignore. + + Asynchronously gets the mount for the file. +For more details, see g_file_find_enclosing_mount() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_find_enclosing_mount_finish() to get the result of the operation. + + + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous find mount request. +See g_file_find_enclosing_mount_async(). +Free the returned object with g_object_unref(). + + #GMount for given @file or %NULL on error. + + + + + a #GAsyncResult + + + + + + Gets the base name (the last component of the path) for a given #GFile. +If called for the top level of a system (such as the filesystem root +or a uri like sftp://host/) it will return a single directory separator +(and on Windows, possibly a drive letter). +The base name is a byte string (*not* UTF-8). It has no defined encoding +or rules other than it may not contain zero bytes. If you want to use +filenames in a user interface you should use the display name that you +can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME +attribute with g_file_query_info(). +This call does no blocking i/o. +if given #GFile is invalid. The returned string should be +freed with g_free() when no longer needed. + + string containing the #GFile's base name, or %NULL + + + + + Gets the child of @file for a given @display_name (i.e. a UTF8 +version of the name). If this function fails, it returns %NULL and @error will be +set. This is very useful when constructing a GFile for a new file +and the user entered the filename in the user interface, for instance +when you select a directory and type a filename in the file selector. +This call does no blocking i/o. +%NULL if the display name couldn't be converted. +Free the returned object with g_object_unref(). + + a #GFile to the specified child, or + + + + + string to a possible child. + + + + + + Gets the parent directory for the @file. +If the @file represents the root directory of the +file system, then %NULL will be returned. +This call does no blocking i/o. +#GFile or %NULL if there is no parent. +Free the returned object with g_object_unref(). + + a #GFile structure to the parent of the given + + + + + Gets the parse name of the @file. +A parse name is a UTF-8 string that describes the +file such that one can get the #GFile back using +g_file_parse_name(). +This is generally used to show the #GFile as a nice +full-pathname kind of string in a user interface, +like in a location entry. +For local files with names that can safely be converted +to UTF8 the pathname is used, otherwise the IRI is used +(a form of URI that allows UTF8 characters unescaped). +This call does no blocking i/o. +string should be freed with g_free() when no longer needed. + + a string containing the #GFile's parse name. The returned + + + + + Gets the local pathname for #GFile, if one exists. +This call does no blocking i/o. +no such path exists. The returned string should be +freed with g_free() when no longer needed. + + string containing the #GFile's path, or %NULL if + + + + + Gets the path for @descendant relative to @parent. +This call does no blocking i/o. +to @parent, or %NULL if @descendant doesn't have @parent as prefix. +The returned string should be freed with g_free() when no longer needed. + + string with the relative path from @descendant + + + + + input #GFile. + + + + + + Gets the URI for the @file. +This call does no blocking i/o. +The returned string should be freed with g_free() when no longer needed. + + a string containing the #GFile's URI. + + + + + Gets the URI scheme for a #GFile. +RFC 3986 decodes the scheme as: +<programlisting> +URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] +</programlisting> +Common schemes include "file", "http", "ftp", etc. +This call does no blocking i/o. +#GFile. The returned string should be freed with g_free() +when no longer needed. + + a string containing the URI scheme for the given + + + + + Checks to see if a #GFile has a given URI scheme. +This call does no blocking i/o. +given URI scheme, %FALSE if URI scheme is %NULL, +not supported, or #GFile is invalid. + + %TRUE if #GFile's backend supports the + + + + + a string containing a URI scheme. + + + + + + + + + + + Checks to see if a file is native to the platform. +A native file s one expressed in the platform-native filename format, +e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, +as it might be on a locally mounted remote filesystem. +On some systems non-native files may be available using +the native filesystem via a userspace filesystem (FUSE), in +these cases this call will return %FALSE, but g_file_get_path() +will still return a native path. +This call does no blocking i/o. + + %TRUE if file is native. + + + - + + Creates a symbolic link named @file which contains the string +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - + %TRUE on the creation of a new symlink, %FALSE otherwise. + + a string with the path for the target of the new symlink + optional #GCancellable object, %NULL to ignore. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Obtains a directory monitor for the given file. +This may fail if directory monitoring is not supported. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). - - - - - - - - - - - + a #GFileMonitor for the given @file, or %NULL on error. + - + a set of #GFileMonitorFlags. + + optional #GCancellable object, %NULL to ignore. - - - - - - - - - - - - - - - - - - - + + Obtains a file monitor for the given file. If no file notification +mechanism exists, then regular polling of the file is used. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). + + a #GFileMonitor for the given @file, or %NULL on error. + - + a set of #GFileMonitorFlags. + + optional #GCancellable object, %NULL to ignore. - - - - - - - - - - - - - - - - + Starts a @mount_operation, mounting the volume that contains the file @location. +When this operation has completed, @callback will be called with +g_file_mount_enclosing_volume_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + flags affecting the operation + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - - + + the data to pass to callback function + + Finishes a mount operation started by g_file_mount_enclosing_volume(). +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + + a #GAsyncResult. - - - + + Mounts a file of type G_FILE_TYPE_MOUNTABLE. +Using @mount_operation, you can request callbacks when, for instance, +passwords are needed during authentication. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. + + - + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + optional #GCancellable object, %NULL to ignore. + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + - + + Finishes a mount operation. See g_file_mount_mountable() for details. +Finish an asynchronous mount operation that was started +with g_file_mount_mountable(). +Free the returned object with g_object_unref(). - + a #GFile or %NULL on error. + + + a #GAsyncResult. + + + + + + Tries to move the file or directory @source to the location specified by @destination. +If native move operations are supported then this is used, otherwise a copy + delete +fallback is used. The native implementation may support moving directories (for instance +on moves inside the same filesystem), but the fallback code does not. +If the flag #G_FILE_COPY_OVERWRITE is specified an already +existing @destination file is overwritten. +If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks +will be copied as symlinks, otherwise the target of the +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If @progress_callback is not %NULL, then the operation can be monitored by +setting this to a #GFileProgressCallback function. @progress_callback_data +will be passed to this function. It is guaranteed that this callback will +be called after all data has been transferred with the total number of bytes +copied during the operation. +If the @source file does not exist then the G_IO_ERROR_NOT_FOUND +error is returned, independent on the status of the @destination. +If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the +error G_IO_ERROR_EXISTS is returned. +If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY +error is returned. If trying to overwrite a directory with a directory the +G_IO_ERROR_WOULD_MERGE error is returned. +If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is +specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error +may be returned (if the native move operation isn't available). + + %TRUE on successful move, %FALSE otherwise. + + + + + #GFile pointing to the destination location. + + - + set of #GFileCopyFlags. + + optional #GCancellable object, %NULL to ignore. + + #GFileProgressCallback function for updates. + + + + gpointer to user data for the callback function. + + + Opens an existing file for reading and writing. The result is +a #GFileIOStream that can be used to read and write the contents of the file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Note that in many non-local file cases read and write streams are not supported, +so make sure you really need to do read and write streaming, rather than +just opening for reading or writing. +Free the returned object with g_object_unref(). + #GFileIOStream or %NULL on error. + a #GCancellable + invoker="open_readwrite_async" + version="2.22"> + Asynchronously opens @file for reading and writing. +For more details, see g_file_open_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_open_readwrite_finish() to get the result of the operation. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + + Finishes an asynchronous file read operation started with +g_file_open_readwrite_async(). +Free the returned object with g_object_unref(). + a #GFileIOStream or %NULL on error. + a #GAsyncResult. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Polls a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. @@ -5623,739 +13789,1679 @@ necessarily represent files or directories that currently exist." + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - - + + the data to pass to callback function + + Finishes a poll operation. See g_file_poll_mountable() for details. +Finish an asynchronous poll operation that was polled +with g_file_poll_mountable(). +otherwise. - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. - - - - - - + + Checks whether @file has the prefix specified by @prefix. In other word, +if the names of inital elements of @file<!-- -->s pathname match @prefix. +Only full pathname elements are matched, so a path like /foo is not +considered a prefix of /foobar, only of /foo/bar. +This call does no i/o, as it works purely on names. As such it can +sometimes return %FALSE even if @file is inside a @prefix (from a +filesystem point of view), because the prefix of @file is an alias +of @prefix. +%FALSE otherwise. - + %TRUE if the @files's parent, grandparent, etc is @prefix. + - + + input #GFile. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Similar to g_file_query_info(), but obtains information +about the filesystem the @file is on, rather than the file itself. +For instance the amount of space available and the type of +the filesystem. +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "fs:*" means all attributes in the fs +namespace. The standard namespace for filesystem attributes is "fs". +Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE +(the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of +bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + a #GFileInfo or %NULL if there was an error. + an attribute query string. - - - + optional #GCancellable object, %NULL to ignore. - - + + + Asynchronously gets the requested information about the filesystem +that the specified @file is on. The result is a #GFileInfo object +that contains key-value attributes (such as type or size for the +file). +For more details, see g_file_query_filesystem_info() which is the +synchronous version of this call. +When the operation is finished, @callback will be called. You can +then call g_file_query_info_finish() to get the result of the +operation. + an attribute query string. - - - - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous filesystem info query. See +g_file_query_filesystem_info_async(). +Free the returned object with g_object_unref(). + + #GFileInfo for given @file or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Gets the requested information about specified @file. The result +is a #GFileInfo object that contains key-value attributes (such as +the type or size of the file). +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "standard::*" means all attributes in the standard +namespace. An example attribute query be "standard::*,owner::user". +The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +For symlinks, normally the information about the target of the +symlink is returned, rather than information about the symlink itself. +However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the +information about the symlink itself will be returned. Also, for symlinks +that point to non-existing files the information about the symlink itself +will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileInfo for the given @file, or %NULL on error. + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously gets the requested information about specified @file. The result +is a #GFileInfo object that contains key-value attributes (such as type or size +for the file). +For more details, see g_file_query_info() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_query_info_finish() to get the result of the operation. + + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file info query. +See g_file_query_info_async(). +Free the returned object with g_object_unref(). + + #GFileInfo for given @file or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Obtain the list of settable attributes for the file. +Returns the type and full attribute name of all the attributes +that can be set on this file. This doesn't mean setting it will always +succeed though, you might get an access failure, or some specific +file may not support a specific attribute. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When you are done with it, release it with g_file_attribute_info_list_unref() + + a #GFileAttributeInfoList describing the settable attributes. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Obtain the list of attribute namespaces where new attributes +can be created by a user. An example of this is extended +attributes (in the "xattr" namespace). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When you are done with it, release it with g_file_attribute_info_list_unref() + + a #GFileAttributeInfoList describing the writable namespaces. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously opens @file for reading. +For more details, see g_file_read() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_read_finish() to get the result of the operation. + + + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file read operation started with +g_file_read_async(). +Free the returned object with g_object_unref(). + + a #GFileInputStream or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Opens a file for reading. The result is a #GFileInputStream that +can be used to read the contents of the file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + + #GFileInputStream or %NULL on error. + + + + + a #GCancellable + + + + + + Returns an output stream for overwriting the file, possibly +creating a backup copy of the file first. If the file doesn't exist, +it will be created. +This will try to replace the file in the safest way possible so +that any errors during the writing will not affect an already +existing copy of the file. For instance, for local files it +may write to a temporary file and then atomically rename over +the destination when the stream is closed. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If you pass in a non-#NULL @etag value, then this value is +compared to the current entity tag of the file, and if they differ +an G_IO_ERROR_WRONG_ETAG error is returned. This generally means +that the file has been changed since you last read it. You can get +the new etag from g_file_output_stream_get_etag() after you've +finished writing and closed the #GFileOutputStream. When you load +a new file you can use g_file_input_stream_query_info() to get +the etag of the file. +If @make_backup is %TRUE, this function will attempt to make a backup +of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP +error will be returned. If you want to replace anyway, try again with +If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned, +and if the file is some other form of non-regular file then a +G_IO_ERROR_NOT_REGULAR_FILE error will be returned. +Some file systems don't allow all file names, and may +return an G_IO_ERROR_INVALID_FILENAME error, and if the name +is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. +Other errors are possible too, and depend on what kind of +filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileOutputStream or %NULL on error. + + + + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore. + + + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously overwrites the file, replacing the contents, possibly +creating a backup copy of the file first. +For more details, see g_file_replace() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_replace_finish() to get the result of the operation. + + + + + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. + + + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + - - + + + Finishes an asynchronous file replace operation started with +g_file_replace_async(). +Free the returned object with g_object_unref(). - + a #GFileOutputStream, or %NULL on error. + + a #GAsyncResult. - - + + + Returns an output stream for overwriting the file in readwrite mode, +possibly creating a backup copy of the file first. If the file doesn't +exist, it will be created. +For details about the behaviour, see g_file_replace() which does the same +thing but returns an output stream only. +Note that in many non-local file cases read and write streams are not +supported, so make sure you really need to do read and write streaming, +rather than just opening for reading or writing. +Free the returned object with g_object_unref(). - + a #GFileIOStream or %NULL on error. + - + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore + + %TRUE if a backup should be created + + + + a set of #GFileCreateFlags + + + optional #GCancellable object, %NULL to ignore - - + + + Asynchronously overwrites the file in read-write mode, replacing the +contents, possibly creating a backup copy of the file first. +For more details, see g_file_replace_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then +call g_file_replace_readwrite_finish() to get the result of the operation. - + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file replace operation started with +g_file_replace_readwrite_async(). +Free the returned object with g_object_unref(). + + a #GFileIOStream, or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Resolves a relative path for @file to an absolute path. +This call does no blocking i/o. +is %NULL or if @file is invalid. +Free the returned object with g_object_unref(). + + #GFile to the resolved path. %NULL if @relative_path + + + + + a given relative path string. + + + + + + Sets an attribute in the file with attribute name @attribute to @value. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if the attribute was set, %FALSE otherwise. + + + + + a string containing the attribute's name. + + + + The type of the attribute + + + + a pointer to the value (or the pointer itself if the type is a pointer type) + + + + a set of #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously sets the attributes of @file with @info. +For more details, see g_file_set_attributes_from_info() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_set_attributes_finish() to get the result of the operation. + + + + + + a #GFileInfo. + + + + a #GFileQueryInfoFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback. - - + + a #gpointer. + - - - - + + + Finishes setting an attribute started in g_file_set_attributes_async(). + + %TRUE if the attributes were set correctly, %FALSE otherwise. + - + + a #GAsyncResult. + + a #GFileInfo. + + - - - - + + + Tries to set all attributes in the #GFileInfo on the target values, +not stopping on the first error. +If there is any error during this operation then @error will be set to +the first error. Error on particular fields are flagged by setting +the "status" field in the attribute value to +%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect +further errors. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if there was any error, %FALSE otherwise. + + + a #GFileInfo. + + + + #GFileQueryInfoFlags + + + optional #GCancellable object, %NULL to ignore. - - + + + Renames @file to the specified display name. +The display name is converted from UTF8 to the correct encoding for the target +filesystem if possible and the @file is renamed to this. +If you want to implement a rename operation in the user interface the edit name +(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename +widget, and then the result after editing should be passed to g_file_set_display_name(). +On success the resulting converted filename is returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +if there was an error. +Free the returned object with g_object_unref(). + + a #GFile specifying what @file was renamed to, or %NULL + + + + + a string. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously sets the display name for a given #GFile. +For more details, see g_file_set_display_name() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_set_display_name_finish() to get the result of the operation. + + a string. + + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + - - + + + Finishes setting a display name started with +g_file_set_display_name_async(). +Free the returned object with g_object_unref(). - + a #GFile or %NULL on error. + + a #GAsyncResult. + + + + + + Starts a file of type G_FILE_TYPE_MOUNTABLE. +Using @start_operation, you can request callbacks when, for instance, +passwords are needed during authentication. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes a start operation. See g_file_start_mountable() for details. +Finish an asynchronous start operation that was started +with g_file_start_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Stops a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_stop_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an stop operation, see g_file_stop_mountable() for details. +Finish an asynchronous stop operation that was started +with g_file_stop_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Sends @file to the "Trashcan", if possible. This is similar to +deleting it, but the user can recover it before emptying the trashcan. +Not all file systems support trashing, so this call can return the +%G_IO_ERROR_NOT_SUPPORTED error. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE on successful trash, %FALSE otherwise. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Unmounts a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_unmount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an unmount operation, see g_file_unmount_mountable() for details. +Finish an asynchronous unmount operation that was started +with g_file_unmount_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Unmounts a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_unmount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details. +Finish an asynchronous unmount operation that was started +with g_file_unmount_mountable_with_operation(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Gets an output stream for appending data to the file. If +the file doesn't already exist it is created. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Some file systems don't allow all file names, and may +return an %G_IO_ERROR_INVALID_FILENAME error. +If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will be +returned. Other errors are possible too, and depend on what kind of +filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileOutputStream, or %NULL on error. + + + + + a set of #GFileCreateFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously opens @file for appending. +For more details, see g_file_append_to() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_append_to_finish() to get the result of the operation. + + + + + + a set of #GFileCreateFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file append operation started with +g_file_append_to_async(). +Free the returned object with g_object_unref(). + + a valid #GFileOutputStream or %NULL on error. + + + + + #GAsyncResult + + + + + + Copies the file @source to the location specified by @destination. +Can not handle recursive copies of directories. +If the flag #G_FILE_COPY_OVERWRITE is specified an already +existing @destination file is overwritten. +If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks +will be copied as symlinks, otherwise the target of the +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If @progress_callback is not %NULL, then the operation can be monitored by +setting this to a #GFileProgressCallback function. @progress_callback_data +will be passed to this function. It is guaranteed that this callback will +be called after all data has been transferred with the total number of bytes +copied during the operation. +If the @source file does not exist then the G_IO_ERROR_NOT_FOUND +error is returned, independent on the status of the @destination. +If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the +error G_IO_ERROR_EXISTS is returned. +If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY +error is returned. If trying to overwrite a directory with a directory the +G_IO_ERROR_WOULD_MERGE error is returned. +If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is +specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error +is returned. +If you are interested in copying the #GFile object itself (not the on-disk +file), see g_file_dup(). + + %TRUE on success, %FALSE otherwise. + + + + + destination #GFile + + + + set of #GFileCopyFlags + + + + optional #GCancellable object, %NULL to ignore. + + + + function to callback with progress information + + + + user data to pass to @progress_callback + + + + + + Copies the file @source to the location specified by @destination +asynchronously. For details of the behaviour, see g_file_copy(). +If @progress_callback is not %NULL, then that function that will be called +just like in g_file_copy(), however the callback will run in the main loop, +not in the thread that is doing the I/O operation. +When the operation is finished, @callback will be called. You can then call +g_file_copy_finish() to get the result of the operation. + + + + + + destination #GFile + + + + set of #GFileCopyFlags + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + function to callback with progress information + + + + user data to pass to @progress_callback + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Copies the file attributes from @source to @destination. +Normally only a subset of the file attributes are copied, +those that are copies in a normal file copy operation +(which for instance does not include e.g. owner). However +if #G_FILE_COPY_ALL_METADATA is specified in @flags, then +all the metadata that is possible to copy is copied. This +is useful when implementing move by copy + delete source. + + %TRUE if the attributes were copied successfully, %FALSE otherwise. + + + + + a #GFile to copy attributes to. + + + + a set of #GFileCopyFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Finishes copying the file started with +g_file_copy_async(). + + a %TRUE on success, %FALSE on error. + + + + + a #GAsyncResult. + + + + + + Creates a new file and returns an output stream for writing to it. +The file must not already exist. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If a file or directory with this name already exists the G_IO_ERROR_EXISTS +error will be returned. +Some file systems don't allow all file names, and may +return an G_IO_ERROR_INVALID_FILENAME error, and if the name +is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. +Other errors are possible too, and depend on what kind of +filesystem the file is on. +%NULL on error. +Free the returned object with g_object_unref(). + + a #GFileOutputStream for the newly created file, or + + + + + a set of #GFileCreateFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously creates a new file and returns an output stream for writing to it. +The file must not already exist. +For more details, see g_file_create() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_create_finish() to get the result of the operation. + + + + + + a set of #GFileCreateFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file create operation started with +g_file_create_async(). +Free the returned object with g_object_unref(). + + a #GFileOutputStream or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Creates a new file and returns a stream for reading and writing to it. +The file must not already exist. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If a file or directory with this name already exists the %G_IO_ERROR_EXISTS +error will be returned. Some file systems don't allow all file names, +and may return an %G_IO_ERROR_INVALID_FILENAME error, and if the name +is too long, %G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors +are possible too, and depend on what kind of filesystem the file is on. +Note that in many non-local file cases read and write streams are not +supported, so make sure you really need to do read and write streaming, +rather than just opening for reading or writing. +Free the returned object with g_object_unref(). + + a #GFileIOStream for the newly created file, or %NULL on error. + + + + + a set of #GFileCreateFlags + + + + optional #GCancellable object, %NULL to ignore + + + + + + Asynchronously creates a new file and returns a stream for reading and +writing to it. The file must not already exist. +For more details, see g_file_create_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then +call g_file_create_readwrite_finish() to get the result of the operation. + + + + + + a set of #GFileCreateFlags + + + + the <link linkend="io-priority">I/O priority</link> of the request + + + + optional #GCancellable object, %NULL to ignore + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file create operation started with +g_file_create_readwrite_async(). +Free the returned object with g_object_unref(). + + a #GFileIOStream or %NULL on error. + + + + + a #GAsyncResult + + + + + + Deletes a file. If the @file is a directory, it will only be deleted if it +is empty. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if the file was deleted. %FALSE otherwise. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Duplicates a #GFile handle. This operation does not duplicate +the actual file or directory represented by the #GFile; see +g_file_copy() if attempting to copy a file. +This call does no blocking i/o. + + a new #GFile that is a duplicate of the given #GFile. + + + + + Starts an asynchronous eject on a mountable. +When this operation has completed, @callback will be called with +g_file_eject_mountable_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an asynchronous eject operation started by +g_file_eject_mountable(). +otherwise. + + %TRUE if the @file was ejected successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Starts an asynchronous eject on a mountable. +When this operation has completed, @callback will be called with +g_file_eject_mountable_with_operation_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an asynchronous eject operation started by +g_file_eject_mountable_with_operation(). +otherwise. + + %TRUE if the @file was ejected successfully. %FALSE + + + + + a #GAsyncResult. @@ -6363,247 +15469,618 @@ necessarily represent files or directories that currently exist." + Gets the requested information about the files in a directory. The result +is a #GFileEnumerator object that will give out #GFileInfo objects for +all the files in the directory. +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "standard::*" means all attributes in the standard +namespace. An example attribute query be "standard::*,owner::user". +The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is not a directory, the G_FILE_ERROR_NOTDIR error will be returned. +Other errors are possible too. +Free the returned object with g_object_unref(). + A #GFileEnumerator if successful, %NULL on error. + an attribute query string. + a set of #GFileQueryInfoFlags. + optional #GCancellable object, %NULL to ignore. + Asynchronously gets the requested information about the files in a directory. The result +is a #GFileEnumerator object that will give out #GFileInfo objects for +all the files in the directory. +For more details, see g_file_enumerate_children() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_enumerate_children_finish() to get the result of the operation. + an attribute query string. + a set of #GFileQueryInfoFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="5"> + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Finishes an async enumerate children operation. +See g_file_enumerate_children_async(). +Free the returned object with g_object_unref(). + a #GFileEnumerator or %NULL if an error occurred. + a #GAsyncResult. - - - + + Checks equality of two given #GFile<!-- -->s. Note that two +#GFile<!-- -->s that differ can still refer to the same +file on the filesystem due to various forms of filename +aliasing. +This call does no blocking i/o. +%FALSE if either is not a #GFile. + + %TRUE if @file1 and @file2 are equal. + - - + + the second #GFile. + + + + + Gets a #GMount for the #GFile. +If the #GFileIface for @file does not have a mount (e.g. possibly a +remote share), @error will be set to %G_IO_ERROR_NOT_FOUND and %NULL +will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). + + a #GMount where the @file is located or %NULL on error. + + + + optional #GCancellable object, %NULL to ignore. - + + Asynchronously gets the mount for the file. +For more details, see g_file_find_enclosing_mount() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_find_enclosing_mount_finish() to get the result of the operation. - - - - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="3"> + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + Finishes an asynchronous find mount request. +See g_file_find_enclosing_mount_async(). +Free the returned object with g_object_unref(). - + #GMount for given @file or %NULL on error. + + a #GAsyncResult - - - + + Gets the base name (the last component of the path) for a given #GFile. +If called for the top level of a system (such as the filesystem root +or a uri like sftp://host/) it will return a single directory separator +(and on Windows, possibly a drive letter). +The base name is a byte string (*not* UTF-8). It has no defined encoding +or rules other than it may not contain zero bytes. If you want to use +filenames in a user interface you should use the display name that you +can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME +attribute with g_file_query_info(). +This call does no blocking i/o. +if given #GFile is invalid. The returned string should be +freed with g_free() when no longer needed. + + string containing the #GFile's base name, or %NULL + + + + + Gets a child of @file with basename equal to @name. +Note that the file with that specific name might not exist, but +you can still have a #GFile that points to it. You can use this +for instance to create that file. +This call does no blocking i/o. +Free the returned object with g_object_unref(). + + a #GFile to a child specified by @name. + - - + + string containing the child's basename. + - - - + + Gets the child of @file for a given @display_name (i.e. a UTF8 +version of the name). If this function fails, it returns %NULL and @error will be +set. This is very useful when constructing a GFile for a new file +and the user entered the filename in the user interface, for instance +when you select a directory and type a filename in the file selector. +This call does no blocking i/o. +%NULL if the display name couldn't be converted. +Free the returned object with g_object_unref(). + + a #GFile to the specified child, or + - - + + string to a possible child. + - - - + + Gets the parent directory for the @file. +If the @file represents the root directory of the +file system, then %NULL will be returned. +This call does no blocking i/o. +#GFile or %NULL if there is no parent. +Free the returned object with g_object_unref(). + + a #GFile structure to the parent of the given + + + + + Gets the parse name of the @file. +A parse name is a UTF-8 string that describes the +file such that one can get the #GFile back using +g_file_parse_name(). +This is generally used to show the #GFile as a nice +full-pathname kind of string in a user interface, +like in a location entry. +For local files with names that can safely be converted +to UTF8 the pathname is used, otherwise the IRI is used +(a form of URI that allows UTF8 characters unescaped). +This call does no blocking i/o. +string should be freed with g_free() when no longer needed. + + a string containing the #GFile's parse name. The returned + + + + + Gets the local pathname for #GFile, if one exists. +This call does no blocking i/o. +no such path exists. The returned string should be +freed with g_free() when no longer needed. + + string containing the #GFile's path, or %NULL if + + + + + Gets the path for @descendant relative to @parent. +This call does no blocking i/o. +to @parent, or %NULL if @descendant doesn't have @parent as prefix. +The returned string should be freed with g_free() when no longer needed. + + string with the relative path from @descendant + - + + input #GFile. - - - - - - - - - - - + + + + Gets the URI for the @file. +This call does no blocking i/o. +The returned string should be freed with g_free() when no longer needed. + + a string containing the #GFile's URI. + + + + + Gets the URI scheme for a #GFile. +RFC 3986 decodes the scheme as: +<programlisting> +URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ] +</programlisting> +Common schemes include "file", "http", "ftp", etc. +This call does no blocking i/o. +#GFile. The returned string should be freed with g_free() +when no longer needed. + + a string containing the URI scheme for the given + + + + + Checks if @file has a parent, and optionally, if it is @parent. +If @parent is %NULL then this function returns %TRUE if @file has any +parent at all. If @parent is non-%NULL then %TRUE is only returned +if @file is a child of @parent. +case that @parent is %NULL). + + %TRUE if @file is a child of @parent (or any parent in the + + + + + the parent to check for, or %NULL + - + + Checks whether @file has the prefix specified by @prefix. In other word, +if the names of inital elements of @file<!-- -->s pathname match @prefix. +Only full pathname elements are matched, so a path like /foo is not +considered a prefix of /foobar, only of /foo/bar. +This call does no i/o, as it works purely on names. As such it can +sometimes return %FALSE even if @file is inside a @prefix (from a +filesystem point of view), because the prefix of @file is an alias +of @prefix. +%FALSE otherwise. + + %TRUE if the @files's parent, grandparent, etc is @prefix. + + + + + input #GFile. + + + + + + Checks to see if a #GFile has a given URI scheme. +This call does no blocking i/o. +given URI scheme, %FALSE if URI scheme is %NULL, +not supported, or #GFile is invalid. + + %TRUE if #GFile's backend supports the + + + + + a string containing a URI scheme. + + + + + + Creates a new icon for a file. + + a #GIcon for the given @file, or %NULL on error. + + + + + Checks to see if a file is native to the platform. +A native file s one expressed in the platform-native filename format, +e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, +as it might be on a locally mounted remote filesystem. +On some systems non-native files may be available using +the native filesystem via a userspace filesystem (FUSE), in +these cases this call will return %FALSE, but g_file_get_path() +will still return a native path. +This call does no blocking i/o. + + %TRUE if file is native. + + + + + Loads the content of the file into memory. The data is always +zero-terminated, but this is not included in the resultant @length. +The returned @content should be freed with g_free() when no longer +needed. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +%FALSE if there were errors. + + %TRUE if the @file's contents were successfully loaded. + + + + + optional #GCancellable object, %NULL to ignore. + + + + a location to place the contents of the file. + + + + a location to place the length of the contents of the file, or %NULL if the length is not needed + + + + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed + + + + + + Starts an asynchronous load of the @file's contents. +For more details, see g_file_load_contents() which is +the synchronous version of this call. +When the load operation has completed, @callback will be called +with @user data. To finish the operation, call +g_file_load_contents_finish() with the #GAsyncResult returned by +the @callback. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - - - - - - - - - + optional #GCancellable object, %NULL to ignore. - - - - - - + closure="2"> + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + Finishes an asynchronous load of the @file's contents. +The contents are placed in @contents, and @length is set to the +size of the @contents string. The @content should be freed with +g_free() when no longer needed. If @etag_out is present, it will be +set to the new entity tag for the @file. +present, it will be set appropriately. - + %TRUE if the load was successful. If %FALSE and @error is + + a #GAsyncResult. + + a location to place the contents of the file. + + + + a location to place the length of the contents of the file, or %NULL if the length is not needed + + + + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed + + - + + Reads the partial contents of a file. A #GFileReadMoreCallback should be +used to stop reading from the file when appropriate, else this function +will behave exactly as g_file_load_contents_async(). This operation +can be finished by g_file_load_partial_contents_finish(). +Users of this function should be aware that @user_data is passed to +both the @read_more_callback and the @callback. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - + - - - - - - + optional #GCancellable object, %NULL to ignore. - - + + a #GFileReadMoreCallback to receive partial data and to specify whether further data should be read. + - - + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to the callback functions. + + + + + + Finishes an asynchronous partial load operation that was started +with g_file_load_partial_contents_async(). The data is always +zero-terminated, but this is not included in the resultant @length. +The returned @content should be freed with g_free() when no longer +needed. +present, it will be set appropriately. + + %TRUE if the load was successful. If %FALSE and @error is + + + + + a #GAsyncResult. + + + + a location to place the contents of the file. + + + + a location to place the length of the contents of the file, or %NULL if the length is not needed + + + + a location to place the current entity tag for the file, or %NULL if the entity tag is not needed + @@ -6611,7 +16088,7 @@ necessarily represent files or directories that currently exist." c:identifier="g_file_make_directory" throws="1"> - + + Creates a directory and any parent directories that may not exist similar to +'mkdir -p'. If the file system does not support creating directories, this +function will fail, setting @error to %G_IO_ERROR_NOT_SUPPORTED. +For a local #GFile the newly created directories will have the default +(current) ownership and permissions of the current process. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +otherwise. - + %TRUE if all directories have been successfully created, %FALSE + + optional #GCancellable object, %NULL to ignore. @@ -6638,525 +16127,50 @@ necessarily represent files or directories that currently exist." + Creates a symbolic link named @file which contains the string +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - + %TRUE on the creation of a new symlink, %FALSE otherwise. + + a string with the path for the target of the new symlink + optional #GCancellable object, %NULL to ignore. - + Obtains a file or directory monitor for the given file, depending +on the type of the file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a #GFileMonitor for the given @file, or %NULL on error. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a set of #GFileMonitorFlags + + optional #GCancellable object, %NULL to ignore @@ -7164,16 +16178,25 @@ necessarily represent files or directories that currently exist." + Obtains a directory monitor for the given file. +This may fail if directory monitoring is not supported. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). + a #GFileMonitor for the given @file, or %NULL on error. + a set of #GFileMonitorFlags. + optional #GCancellable object, %NULL to ignore. @@ -7181,142 +16204,333 @@ necessarily represent files or directories that currently exist." + Obtains a file monitor for the given file. If no file notification +mechanism exists, then regular polling of the file is used. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Free the returned object with g_object_unref(). + a #GFileMonitor for the given @file, or %NULL on error. + a set of #GFileMonitorFlags. + optional #GCancellable object, %NULL to ignore. - - - - - - - - - - - - - - + + Starts a @mount_operation, mounting the volume that contains the file @location. +When this operation has completed, @callback will be called with +g_file_mount_enclosing_volume_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + flags affecting the operation + + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. + closure="4"> + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + Finishes a mount operation started by g_file_mount_enclosing_volume(). +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + + a #GAsyncResult. - + + Mounts a file of type G_FILE_TYPE_MOUNTABLE. +Using @mount_operation, you can request callbacks when, for instance, +passwords are needed during authentication. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes a mount operation. See g_file_mount_mountable() for details. +Finish an asynchronous mount operation that was started +with g_file_mount_mountable(). +Free the returned object with g_object_unref(). + + a #GFile or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Tries to move the file or directory @source to the location specified by @destination. +If native move operations are supported then this is used, otherwise a copy + delete +fallback is used. The native implementation may support moving directories (for instance +on moves inside the same filesystem), but the fallback code does not. +If the flag #G_FILE_COPY_OVERWRITE is specified an already +existing @destination file is overwritten. +If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks +will be copied as symlinks, otherwise the target of the +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If @progress_callback is not %NULL, then the operation can be monitored by +setting this to a #GFileProgressCallback function. @progress_callback_data +will be passed to this function. It is guaranteed that this callback will +be called after all data has been transferred with the total number of bytes +copied during the operation. +If the @source file does not exist then the G_IO_ERROR_NOT_FOUND +error is returned, independent on the status of the @destination. +If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then the +error G_IO_ERROR_EXISTS is returned. +If trying to overwrite a file over a directory the G_IO_ERROR_IS_DIRECTORY +error is returned. If trying to overwrite a directory with a directory the +G_IO_ERROR_WOULD_MERGE error is returned. +If the source is a directory and the target does not exist, or #G_FILE_COPY_OVERWRITE is +specified and the target is a file, then the G_IO_ERROR_WOULD_RECURSE error +may be returned (if the native move operation isn't available). + + %TRUE on successful move, %FALSE otherwise. + + + + + #GFile pointing to the destination location. + + + + set of #GFileCopyFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + #GFileProgressCallback function for updates. + + + + gpointer to user data for the callback function. + + + + + + Opens an existing file for reading and writing. The result is +a #GFileIOStream that can be used to read and write the contents of the file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Note that in many non-local file cases read and write streams are not supported, +so make sure you really need to do read and write streaming, rather than +just opening for reading or writing. +Free the returned object with g_object_unref(). + + #GFileIOStream or %NULL on error. + + + a #GCancellable + + + + + + Asynchronously opens @file for reading and writing. +For more details, see g_file_open_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_open_readwrite_finish() to get the result of the operation. + + + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + + + + + Finishes an asynchronous file read operation started with +g_file_open_readwrite_async(). +Free the returned object with g_object_unref(). + + a #GFileIOStream or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Polls a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. + + + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + Finishes a poll operation. See g_file_poll_mountable() for details. +Finish an asynchronous poll operation that was polled +with g_file_poll_mountable(). +otherwise. - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. @@ -7324,249 +16538,1478 @@ necessarily represent files or directories that currently exist." + Returns the #GAppInfo that is registered as the default +application to handle the file specified by @file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When you are done with it, release it with g_object_unref() + a #GAppInfo if the handle was found, %NULL if there were errors. + optional #GCancellable object, %NULL to ignore. - + + Utility function to check if a particular file exists. This is +implemented using g_file_query_info() and as such does blocking I/O. +Note that in many cases it is racy to first check for file existence +and then execute something based on the outcome of that, because the +file might have been created or removed in between the operations. The +general approach to handling that is to not check, but just do the +operation and handle the errors as they come. +As an example of race-free checking, take the case of reading a file, and +can both result in two processes creating the file (with perhaps a partially +written file as the result). The correct approach is to always try to create +the file with g_file_create() which will either atomically create the file +or fail with a G_IO_ERROR_EXISTS error. +However, in many cases an existence check is useful in a user +interface, for instance to make a menu item sensitive/insensitive, so that +you don't have to fool users that something is possible and then just show +and error dialog. If you do this, you should make sure to also handle the +errors that can happen due to races when you execute the operation. - + %TRUE if the file exists (and can be detected without error), %FALSE otherwise (or if cancelled). + + optional #GCancellable object, %NULL to ignore. - - - - - - - - - - + + Utility function to inspect the #GFileType of a file. This is +implemented using g_file_query_info() and as such does blocking I/O. +The primary use case of this method is to check if a file is a regular file, +directory, or symlink. +does not exist + + The #GFileType of the file and #G_FILE_TYPE_UNKNOWN if the file + + + + + a set of #GFileQueryInfoFlags passed to g_file_query_info(). + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Similar to g_file_query_info(), but obtains information +about the filesystem the @file is on, rather than the file itself. +For instance the amount of space available and the type of +the filesystem. +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "fs:*" means all attributes in the fs +namespace. The standard namespace for filesystem attributes is "fs". +Common attributes of interest are #G_FILE_ATTRIBUTE_FILESYSTEM_SIZE +(the total size of the filesystem in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of +bytes available), and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileInfo or %NULL if there was an error. + + + + + an attribute query string. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously gets the requested information about the filesystem +that the specified @file is on. The result is a #GFileInfo object +that contains key-value attributes (such as type or size for the +file). +For more details, see g_file_query_filesystem_info() which is the +synchronous version of this call. +When the operation is finished, @callback will be called. You can +then call g_file_query_info_finish() to get the result of the +operation. + + an attribute query string. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous filesystem info query. See +g_file_query_filesystem_info_async(). +Free the returned object with g_object_unref(). + + #GFileInfo for given @file or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Gets the requested information about specified @file. The result +is a #GFileInfo object that contains key-value attributes (such as +the type or size of the file). +The @attributes value is a string that specifies the file attributes that +should be gathered. It is not an error if it's not possible to read a particular +requested attribute from a file - it just won't be set. @attributes should +be a comma-separated list of attributes or attribute wildcards. The wildcard "*" +means all attributes, and a wildcard like "standard::*" means all attributes in the standard +namespace. An example attribute query be "standard::*,owner::user". +The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +For symlinks, normally the information about the target of the +symlink is returned, rather than information about the symlink itself. +However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in @flags the +information about the symlink itself will be returned. Also, for symlinks +that point to non-existing files the information about the symlink itself +will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileInfo for the given @file, or %NULL on error. + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously gets the requested information about specified @file. The result +is a #GFileInfo object that contains key-value attributes (such as type or size +for the file). +For more details, see g_file_query_info() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_query_info_finish() to get the result of the operation. + + + + + + an attribute query string. + + + + a set of #GFileQueryInfoFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file info query. +See g_file_query_info_async(). +Free the returned object with g_object_unref(). + + #GFileInfo for given @file or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Obtain the list of settable attributes for the file. +Returns the type and full attribute name of all the attributes +that can be set on this file. This doesn't mean setting it will always +succeed though, you might get an access failure, or some specific +file may not support a specific attribute. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When you are done with it, release it with g_file_attribute_info_list_unref() + + a #GFileAttributeInfoList describing the settable attributes. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Obtain the list of attribute namespaces where new attributes +can be created by a user. An example of this is extended +attributes (in the "xattr" namespace). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When you are done with it, release it with g_file_attribute_info_list_unref() + + a #GFileAttributeInfoList describing the writable namespaces. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Opens a file for reading. The result is a #GFileInputStream that +can be used to read the contents of the file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. +If the file is a directory, the G_IO_ERROR_IS_DIRECTORY error will be returned. +Other errors are possible too, and depend on what kind of filesystem the file is on. +Free the returned object with g_object_unref(). + + #GFileInputStream or %NULL on error. + + + + + a #GCancellable + + + + + + Asynchronously opens @file for reading. +For more details, see g_file_read() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_read_finish() to get the result of the operation. + + + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - - - + + Finishes an asynchronous file read operation started with +g_file_read_async(). +Free the returned object with g_object_unref(). + + a #GFileInputStream or %NULL on error. + + a #GAsyncResult. - - - - - - - - - - + + Returns an output stream for overwriting the file, possibly +creating a backup copy of the file first. If the file doesn't exist, +it will be created. +This will try to replace the file in the safest way possible so +that any errors during the writing will not affect an already +existing copy of the file. For instance, for local files it +may write to a temporary file and then atomically rename over +the destination when the stream is closed. +By default files created are generally readable by everyone, +but if you pass #G_FILE_CREATE_PRIVATE in @flags the file +will be made readable only to the current user, to the level that +is supported on the target filesystem. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If you pass in a non-#NULL @etag value, then this value is +compared to the current entity tag of the file, and if they differ +an G_IO_ERROR_WRONG_ETAG error is returned. This generally means +that the file has been changed since you last read it. You can get +the new etag from g_file_output_stream_get_etag() after you've +finished writing and closed the #GFileOutputStream. When you load +a new file you can use g_file_input_stream_query_info() to get +the etag of the file. +If @make_backup is %TRUE, this function will attempt to make a backup +of the current file before overwriting it. If this fails a G_IO_ERROR_CANT_CREATE_BACKUP +error will be returned. If you want to replace anyway, try again with +If the file is a directory the G_IO_ERROR_IS_DIRECTORY error will be returned, +and if the file is some other form of non-regular file then a +G_IO_ERROR_NOT_REGULAR_FILE error will be returned. +Some file systems don't allow all file names, and may +return an G_IO_ERROR_INVALID_FILENAME error, and if the name +is to long G_IO_ERROR_FILENAME_TOO_LONG will be returned. +Other errors are possible too, and depend on what kind of +filesystem the file is on. +Free the returned object with g_object_unref(). + + a #GFileOutputStream or %NULL on error. + + + + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore. + + + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously overwrites the file, replacing the contents, possibly +creating a backup copy of the file first. +For more details, see g_file_replace() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_replace_finish() to get the result of the operation. + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. + + + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + optional #GCancellable object, %NULL to ignore. - - - + closure="6"> + a #GAsyncReadyCallback to call when the request is satisfied - - - - - - - - - - - - - - - - - - - - + the data to pass to callback function + + Replaces the contents of @file with @contents of @length bytes. +If @etag is specified (not %NULL) any existing file must have that etag, or +the error %G_IO_ERROR_WRONG_ETAG will be returned. +If @make_backup is %TRUE, this function will attempt to make a backup of @file. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +The returned @new_etag can be used to verify that the file hasn't changed the +next time it is saved over. +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + + a string containing the new contents for @file. - + the length of @contents in bytes. + + the old <link linkend="gfile-etag">entity tag</link> for the document, or %NULL - + %TRUE if a backup should be created. + + a set of #GFileCreateFlags. + a location to a new <link linkend="gfile-etag">entity tag</link> for the document. This should be freed with g_free() when no longer needed, or %NULL + optional #GCancellable object, %NULL to ignore. + Starts an asynchronous replacement of @file with the given +current entity tag. +When this operation has completed, @callback will be called with +g_file_replace_contents_finish(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +If @make_backup is %TRUE, this function will attempt to +make a backup of @file. + string of contents to replace the file with. - + the length of @contents in bytes. + + a new <link linkend="gfile-etag">entity tag</link> for the @file, or %NULL - + %TRUE if a backup should be created. + + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. + closure="7"> + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Finishes an asynchronous replace of the given @file. See +g_file_replace_contents_async(). Sets @new_etag to the new entity +tag for the document, if present. - + %TRUE on success, %FALSE on failure. + + a #GAsyncResult. + a location of a new <link linkend="gfile-etag">entity tag</link> for the document. This should be freed with g_free() when it is no longer needed, or %NULL - + + Finishes an asynchronous file replace operation started with +g_file_replace_async(). +Free the returned object with g_object_unref(). + + a #GFileOutputStream, or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Returns an output stream for overwriting the file in readwrite mode, +possibly creating a backup copy of the file first. If the file doesn't +exist, it will be created. +For details about the behaviour, see g_file_replace() which does the same +thing but returns an output stream only. +Note that in many non-local file cases read and write streams are not +supported, so make sure you really need to do read and write streaming, +rather than just opening for reading or writing. +Free the returned object with g_object_unref(). + + a #GFileIOStream or %NULL on error. + + + + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore + + + + %TRUE if a backup should be created + + + + a set of #GFileCreateFlags + + + + optional #GCancellable object, %NULL to ignore + + + + + + Asynchronously overwrites the file in read-write mode, replacing the +contents, possibly creating a backup copy of the file first. +For more details, see g_file_replace_readwrite() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then +call g_file_replace_readwrite_finish() to get the result of the operation. - + + + + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. + + + + %TRUE if a backup should be created. + + + + a set of #GFileCreateFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous file replace operation started with +g_file_replace_readwrite_async(). +Free the returned object with g_object_unref(). + + a #GFileIOStream, or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Resolves a relative path for @file to an absolute path. +This call does no blocking i/o. +is %NULL or if @file is invalid. +Free the returned object with g_object_unref(). + + #GFile to the resolved path. %NULL if @relative_path + + + + + a given relative path string. + + + + + + Sets an attribute in the file with attribute name @attribute to @value. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if the attribute was set, %FALSE otherwise. + + + + + a string containing the attribute's name. + + + + The type of the attribute + + + + a pointer to the value (or the pointer itself if the type is a pointer type) + + + + a set of #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value. +If @attribute is of a different type, this operation will fail, +returning %FALSE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +in the @file, %FALSE otherwise. + + %TRUE if the @attribute was successfully set to @value + + + + + a string containing the attribute's name. + + + + a string containing the attribute's new value. + + + + a #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value. +If @attribute is of a different type, this operation will fail. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +in the @file, %FALSE otherwise. + + %TRUE if the @attribute was successfully set to @value + + + + + a string containing the attribute's name. + + + + a #gint32 containing the attribute's new value. + + + + a #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value. +If @attribute is of a different type, this operation will fail. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if the @attribute was successfully set, %FALSE otherwise. + + + + + a string containing the attribute's name. + + + + a #guint64 containing the attribute's new value. + + + + a #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value. +If @attribute is of a different type, this operation will fail. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if the @attribute was successfully set, %FALSE otherwise. + + + + + a string containing the attribute's name. + + + + a string containing the attribute's value. + + + + #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value. +If @attribute is of a different type, this operation will fail. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +in the @file, %FALSE otherwise. + + %TRUE if the @attribute was successfully set to @value + + + + + a string containing the attribute's name. + + + + a #guint32 containing the attribute's new value. + + + + a #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value. +If @attribute is of a different type, this operation will fail. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +in the @file, %FALSE otherwise. + + %TRUE if the @attribute was successfully set to @value + + + + + a string containing the attribute's name. + + + + a #guint64 containing the attribute's new value. + + + + a #GFileQueryInfoFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously sets the attributes of @file with @info. +For more details, see g_file_set_attributes_from_info() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_set_attributes_finish() to get the result of the operation. + + + + + + a #GFileInfo. + + + + a #GFileQueryInfoFlags. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback. + + + + a #gpointer. + + + + + + Finishes setting an attribute started in g_file_set_attributes_async(). + + %TRUE if the attributes were set correctly, %FALSE otherwise. + + + + + a #GAsyncResult. + + + + a #GFileInfo. + + + + + + Tries to set all attributes in the #GFileInfo on the target values, +not stopping on the first error. +If there is any error during this operation then @error will be set to +the first error. Error on particular fields are flagged by setting +the "status" field in the attribute value to +%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect +further errors. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE if there was any error, %FALSE otherwise. + + + + + a #GFileInfo. + + + + #GFileQueryInfoFlags + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Renames @file to the specified display name. +The display name is converted from UTF8 to the correct encoding for the target +filesystem if possible and the @file is renamed to this. +If you want to implement a rename operation in the user interface the edit name +(#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename +widget, and then the result after editing should be passed to g_file_set_display_name(). +On success the resulting converted filename is returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +if there was an error. +Free the returned object with g_object_unref(). + + a #GFile specifying what @file was renamed to, or %NULL + + + + + a string. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously sets the display name for a given #GFile. +For more details, see g_file_set_display_name() which is +the synchronous version of this call. +When the operation is finished, @callback will be called. You can then call +g_file_set_display_name_finish() to get the result of the operation. + + + + + + a string. + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes setting a display name started with +g_file_set_display_name_async(). +Free the returned object with g_object_unref(). + + a #GFile or %NULL on error. + + + + + a #GAsyncResult. + + + + + + Starts a file of type G_FILE_TYPE_MOUNTABLE. +Using @start_operation, you can request callbacks when, for instance, +passwords are needed during authentication. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_mount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes a start operation. See g_file_start_mountable() for details. +Finish an asynchronous start operation that was started +with g_file_start_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Stops a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_stop_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an stop operation, see g_file_stop_mountable() for details. +Finish an asynchronous stop operation that was started +with g_file_stop_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Checks if @file supports <link +linkend="g-main-context-push-thread-default-context">thread-default +contexts</link>. If this returns %FALSE, you cannot perform +asynchronous operations on @file in a thread that has a +thread-default context. + + Whether or not @file supports thread-default contexts. + + + Sends @file to the "Trashcan", if possible. This is similar to +deleting it, but the user can recover it before emptying the trashcan. +Not all file systems support trashing, so this call can return the +%G_IO_ERROR_NOT_SUPPORTED error. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE on successful trash, %FALSE otherwise. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Unmounts a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_unmount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an unmount operation, see g_file_unmount_mountable() for details. +Finish an asynchronous unmount operation that was started +with g_file_unmount_mountable(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + + + Unmounts a file of type G_FILE_TYPE_MOUNTABLE. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +When the operation is finished, @callback will be called. You can then call +g_file_unmount_mountable_finish() to get the result of the operation. + + + + + + flags affecting the operation + + + + a #GMountOperation, or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. + + + + the data to pass to callback function + + + + + + Finishes an unmount operation, see g_file_unmount_mountable_with_operation() for details. +Finish an asynchronous unmount operation that was started +with g_file_unmount_mountable_with_operation(). +otherwise. + + %TRUE if the operation finished successfully. %FALSE + + + + + a #GAsyncResult. + + + + - + + Information about a specific attribute. @@ -7578,10 +18021,10 @@ necessarily represent files or directories that currently exist." + Flags specifying the behaviour of an attribute. + glib:get-type="g_file_attribute_info_list_get_type" + c:symbol-prefix="file_attribute_info_list"> + Acts as a lightweight registry for possible valid file attributes. +The registry stores Key-Value pair formats as #GFileAttributeInfo<!-- -->s. - + + Creates a new file attribute info list. + a #GFileAttributeInfoList. - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a new attribute with @name to the @list, setting +its @type and @flags. + the name of the attribute to add. + the #GFileAttributeType for the attribute. + #GFileAttributeInfoFlags for the attribute. - - - + + Makes a duplicate of a file attribute info list. - + a copy of the given @list. + + + + + Gets the file attribute with the name @name from @list. +attribute isn't found. + + a #GFileAttributeInfo for the @name, or %NULL if an + - + + the name of the attribute to lookup. - - + + + References a file attribute info list. - + #GFileAttributeInfoList or %NULL on error. + - + + Removes a reference from the given @list. If the reference count +falls to zero, the @list is deleted. - - - + + + Determines if a string matches a file attribute. + + Creates a new file attribute matcher, which matches attributes +against a given string. #GFileAttributeMatcher<!-- -->s are reference +counted structures, and are created with a reference count of 1. If +the number of references falls to 0, the #GFileAttributeMatcher is +automatically destroyed. +The @attribute string should be formatted with specific keys separated +from namespaces with a double colon. Several "namespace::key" strings may be +concatenated with a single comma (e.g. "standard::type,standard::is-hidden"). +The wildcard "*" may be used to match all keys and namespaces, or +"namespace::*" will match all keys in a given namespace. +Examples of strings to use: +<table> +<title>File Attribute Matcher strings and results</title> +<tgroup cols='2' align='left'><thead> +<row><entry> Matcher String </entry><entry> Matches </entry></row></thead> +<tbody> +<row><entry>"*"</entry><entry>matches all attributes.</entry></row> +<row><entry>"standard::is-hidden"</entry><entry>matches only the key is-hidden in the standard namespace.</entry></row> +<row><entry>"standard::type,unix::*"</entry><entry>matches the type key in the standard namespace and +all keys in the unix namespace.</entry></row> +</tbody></tgroup> +</table> + + a #GFileAttributeMatcher. + - + + an attribute string to match. - - - - - - - - - - - + + Checks if the matcher will match all of the keys in a given namespace. +This will always return %TRUE if a wildcard character is in use (e.g. if +matcher was created with "standard::*" and @ns is "standard", or if matcher was created +using "*" and namespace is anything.) +in the given @ns, %FALSE otherwise. - + %TRUE if the matcher matches all of the entries + + a string containing a file attribute namespace. + Gets the next matched attribute from a #GFileAttributeMatcher. +no more attribute exist. + a string containing the next attribute or %NULL if + + Checks if an attribute will be matched by an attribute matcher. If +the matcher was created with the "*" matching string, this function +will always return %TRUE. + + %TRUE if @attribute matches @matcher. %FALSE otherwise. + + + + + a file attribute key. + + + + + + Checks if a attribute matcher only matches a given attribute. Always +returns %FALSE if "*" was used when creating the matcher. + + %TRUE if the matcher only matches @attribute. %FALSE otherwise. + + + + + a file attribute key. + + + + + + References a file attribute matcher. + + a #GFileAttributeMatcher. + + + + + Unreferences @matcher. If the reference count falls below 1, +the @matcher is automatically freed. + + + + + Used by g_file_set_attributes_from_info() when setting file attributes. + The data types for file attributes. + Flags used when copying or moving files. + Flags used when an operation may create a file. - + An interface for file descriptor based io objects. + + Gets the underlying file descriptor. - + The file descriptor + - + + Gets the underlying file descriptor. - + The file descriptor + @@ -7865,9 +18375,10 @@ Flags used when an operation may create a file." - + - + The file descriptor + @@ -7878,233 +18389,366 @@ Flags used when an operation may create a file." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + A per matched file iterator. + Asynchronously closes the file enumerator. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in +g_file_enumerator_close_finish(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="3"> + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + - - - - - - + + + Finishes closing a file enumerator, started from g_file_enumerator_close_async(). +If the file enumerator was already closed when g_file_enumerator_close_async() +was called, then this function will report %G_IO_ERROR_CLOSED in @error, and +return %FALSE. If the file enumerator had pending operation when the close +operation was started, then this function will report %G_IO_ERROR_PENDING, and +return %FALSE. If @cancellable was not %NULL, then the operation may have been +cancelled by triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be +returned. + + %TRUE if the close operation has finished successfully. + - + - - + + + + + + + + + + + + + Returns information for the next file in the enumerated object. +Will block until the information is available. The #GFileInfo +returned from this function will contain attributes that match the +attribute string that was passed when the #GFileEnumerator was created. +On error, returns %NULL and sets @error to the error. If the +enumerator is at the end, %NULL will be returned and @error will +be unset. +Free the returned object with g_object_unref() when no longer needed. + + A #GFileInfo or %NULL on error or end of enumerator. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Request information for a number of files from the enumerator asynchronously. +When all i/o for the operation is finished the @callback will be called with +the requested information. +The callback can be called with less than @num_files files in case of error +or at the end of the enumerator. In case of a partial error the callback will +be called with any succeeding items and no error, and on the next request the +error will be reported. If a request is cancelled the callback will be called +with %G_IO_ERROR_CANCELLED. +During an async request no other sync and async calls are allowed, and will +result in %G_IO_ERROR_PENDING errors. +Any outstanding i/o request with higher priority (lower numerical value) will +be executed before an outstanding request with lower priority. Default +priority is %G_PRIORITY_DEFAULT. + + the number of file info objects to request + + - + the <link linkend="gioscheduler">io priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). +g_list_free() and unref the infos with g_object_unref() when you're +done with them. + + a #GList of #GFileInfo<!---->s. You must free the list with + + + + + + + + + + + + Releases all resources used by this enumerator, making the +enumerator return %G_IO_ERROR_CLOSED on all calls. +This will be automatically called when the last reference +is dropped, but you might want to call this function to make +sure resources are released as early as possible. + + #TRUE on success or #FALSE on error. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Asynchronously closes the file enumerator. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in +g_file_enumerator_close_finish(). + + + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Finishes closing a file enumerator, started from g_file_enumerator_close_async(). +If the file enumerator was already closed when g_file_enumerator_close_async() +was called, then this function will report %G_IO_ERROR_CLOSED in @error, and +return %FALSE. If the file enumerator had pending operation when the close +operation was started, then this function will report %G_IO_ERROR_PENDING, and +return %FALSE. If @cancellable was not %NULL, then the operation may have been +cancelled by triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be +returned. - + %TRUE if the close operation has finished successfully. + + a #GAsyncResult. - - - + + Get the #GFile container which is being enumerated. + + the #GFile which is being enumerated. + + Checks if the file enumerator has pending operations. - + %TRUE if the @enumerator has pending operations. + + + Checks if the file enumerator has been closed. + + %TRUE if the @enumerator is closed. + + + + + Returns information for the next file in the enumerated object. +Will block until the information is available. The #GFileInfo +returned from this function will contain attributes that match the +attribute string that was passed when the #GFileEnumerator was created. +On error, returns %NULL and sets @error to the error. If the +enumerator is at the end, %NULL will be returned and @error will +be unset. +Free the returned object with g_object_unref() when no longer needed. + + A #GFileInfo or %NULL on error or end of enumerator. + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Request information for a number of files from the enumerator asynchronously. +When all i/o for the operation is finished the @callback will be called with +the requested information. +The callback can be called with less than @num_files files in case of error +or at the end of the enumerator. In case of a partial error the callback will +be called with any succeeding items and no error, and on the next request the +error will be reported. If a request is cancelled the callback will be called +with %G_IO_ERROR_CANCELLED. +During an async request no other sync and async calls are allowed, and will +result in %G_IO_ERROR_PENDING errors. +Any outstanding i/o request with higher priority (lower numerical value) will +be executed before an outstanding request with lower priority. Default +priority is %G_PRIORITY_DEFAULT. + + + + + + the number of file info objects to request + + + + the <link linkend="gioscheduler">io priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes the asynchronous operation started with g_file_enumerator_next_files_async(). +g_list_free() and unref the infos with g_object_unref() when you're +done with them. + + a #GList of #GFileInfo<!---->s. You must free the list with + + + + + + + a #GAsyncResult. + + + + + Sets the file enumerator as having pending operations. - + a boolean value. + - - - - - - - + + @@ -8120,8 +18764,9 @@ Flags used when an operation may create a file." - + + A #GFileInfo or %NULL on error or end of enumerator. @@ -8131,30 +18776,29 @@ Flags used when an operation may create a file." + optional #GCancellable object, %NULL to ignore. - + - + - + - + @@ -8163,31 +18807,40 @@ Flags used when an operation may create a file." - + the number of file info objects to request + - + the <link linkend="gioscheduler">io priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + - + a #GList of #GFileInfo<!---->s. You must free the list with + + + @@ -8200,7 +18853,7 @@ Flags used when an operation may create a file." - + @@ -8209,26 +18862,34 @@ Flags used when an operation may create a file." - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if the close operation has finished successfully. + @@ -8240,157 +18901,172 @@ Flags used when an operation may create a file." - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + + A subclass of GIOStream for opened files. This adds +a few file-specific operations and seeking and truncating. +#GFileIOStream implements GSeekable. - - - - - - + - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - + + Gets the entity tag for the file when it has been written. +This must be called after the stream has been written +and closed, as the etag can change while writing. + the entity tag for the stream. + + + + + Queries a file io stream for the given @attributes. +This function blocks while querying the stream. For the asynchronous +version of this function, see g_file_io_stream_query_info_async(). +While the stream is blocked, the stream will set the pending flag +internally, and any other operations on the stream will fail with +%G_IO_ERROR_PENDING. +Can fail if the stream was already closed (with @error being set to +%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being +set to %G_IO_ERROR_PENDING), or if querying info is not supported for +the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I +all cases of failure, %NULL will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will +be returned. + + a #GFileInfo for the @stream, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. - + + Asynchronously queries the @stream for a #GFileInfo. When completed, +finish the operation with g_file_io_stream_query_info_finish(). +For the synchronous version of this function, see +g_file_io_stream_query_info(). + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - - + + the data to pass to callback function + - + + Finalizes the asynchronous query started +by g_file_io_stream_query_info_async(). + A #GFileInfo for the finished query. @@ -8399,73 +19075,142 @@ a few file-specific operations and seeking and truncating. - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the entity tag for the file when it has been written. +This must be called after the stream has been written +and closed, as the etag can change while writing. + + the entity tag for the stream. + + + + Queries a file io stream for the given @attributes. +This function blocks while querying the stream. For the asynchronous +version of this function, see g_file_io_stream_query_info_async(). +While the stream is blocked, the stream will set the pending flag +internally, and any other operations on the stream will fail with +%G_IO_ERROR_PENDING. +Can fail if the stream was already closed (with @error being set to +%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being +set to %G_IO_ERROR_PENDING), or if querying info is not supported for +the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I +all cases of failure, %NULL will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will +be returned. + a #GFileInfo for the @stream, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. + c:identifier="g_file_io_stream_query_info_async" + version="2.22"> + Asynchronously queries the @stream for a #GFileInfo. When completed, +finish the operation with g_file_io_stream_query_info_finish(). +For the synchronous version of this function, see +g_file_io_stream_query_info(). + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="4"> + callback to call when the request is satisfied - + the data to pass to callback function + + Finalizes the asynchronous query started +by g_file_io_stream_query_info_async(). + A #GFileInfo for the finished query. + a #GAsyncResult. - - - - - @@ -8480,9 +19225,9 @@ a few file-specific operations and seeking and truncating. - - - + + + @@ -8492,9 +19237,9 @@ a few file-specific operations and seeking and truncating. - + - + @@ -8504,32 +19249,30 @@ a few file-specific operations and seeking and truncating. - + - + - + - + - + - + @@ -8539,28 +19282,27 @@ a few file-specific operations and seeking and truncating. - + - + - + - + - + + a #GFileInfo for the @stream, or %NULL on error. @@ -8568,18 +19310,20 @@ a few file-specific operations and seeking and truncating. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. - + @@ -8588,30 +19332,37 @@ a few file-specific operations and seeking and truncating. + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + + A #GFileInfo for the finished query. @@ -8625,8 +19376,9 @@ a few file-specific operations and seeking and truncating. - + + the entity tag for the stream. @@ -8636,86 +19388,87 @@ a few file-specific operations and seeking and truncating. - - + + - - + + - - + + - - + + - - + + - + + Gets an icon for a #GFile. Implements #GLoadableIcon. - - - - - - - - - - - + Gets the #GFile associated with the given @icon. + + a #GFile, or %NULL. - - + + The file containing the icon. + + glib:is-gtype-struct-for="File"> + An interface for writing VFS file handles. - + + a new #GFile that is a duplicate of the given #GFile. @@ -8726,9 +19479,9 @@ a few file-specific operations and seeking and truncating. - + - + @@ -8738,24 +19491,27 @@ a few file-specific operations and seeking and truncating. - + - + %TRUE if @file1 and @file2 are equal. + + the second #GFile. - + - + %TRUE if file is native. + @@ -8765,23 +19521,26 @@ a few file-specific operations and seeking and truncating. - + - + %TRUE if #GFile's backend supports the + + a string containing a URI scheme. - + + a string containing the URI scheme for the given @@ -8792,8 +19551,9 @@ a few file-specific operations and seeking and truncating. - + + string containing the #GFile's base name, or %NULL @@ -8804,8 +19564,9 @@ a few file-specific operations and seeking and truncating. - + + string containing the #GFile's path, or %NULL if @@ -8816,8 +19577,9 @@ a few file-specific operations and seeking and truncating. - + + a string containing the #GFile's URI. @@ -8828,8 +19590,9 @@ a few file-specific operations and seeking and truncating. - + + a string containing the #GFile's parse name. The returned @@ -8840,8 +19603,9 @@ a few file-specific operations and seeking and truncating. - + + a #GFile structure to the parent of the given @@ -8852,23 +19616,26 @@ a few file-specific operations and seeking and truncating. - + - + %TRUE if the @files's parent, grandparent, etc is @prefix. + + input #GFile. - + + string with the relative path from @descendant @@ -8876,14 +19643,16 @@ a few file-specific operations and seeking and truncating. + input #GFile. - + + #GFile to the resolved path. %NULL if @relative_path @@ -8891,16 +19660,16 @@ a few file-specific operations and seeking and truncating. + a given relative path string. - + + a #GFile to the specified child, or @@ -8908,16 +19677,16 @@ a few file-specific operations and seeking and truncating. + string to a possible child. - + + A #GFileEnumerator if successful, %NULL on error. @@ -8925,22 +19694,24 @@ a few file-specific operations and seeking and truncating. + an attribute query string. + a set of #GFileQueryInfoFlags. + optional #GCancellable object, %NULL to ignore. - + @@ -8949,33 +19720,41 @@ a few file-specific operations and seeking and truncating. + an attribute query string. + a set of #GFileQueryInfoFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileEnumerator or %NULL if an error occurred. @@ -8983,14 +19762,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileInfo for the given @file, or %NULL on error. @@ -8998,21 +19779,24 @@ a few file-specific operations and seeking and truncating. + an attribute query string. + a set of #GFileQueryInfoFlags. + optional #GCancellable object, %NULL to ignore. - + @@ -9021,33 +19805,41 @@ a few file-specific operations and seeking and truncating. + an attribute query string. + a set of #GFileQueryInfoFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + #GFileInfo for given @file or %NULL on error. @@ -9055,16 +19847,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileInfo or %NULL if there was an error. @@ -9072,19 +19864,20 @@ a few file-specific operations and seeking and truncating. + an attribute query string. + optional #GCancellable object, %NULL to ignore. - + @@ -9093,30 +19886,37 @@ a few file-specific operations and seeking and truncating. + an attribute query string. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + #GFileInfo for given @file or %NULL on error. @@ -9124,16 +19924,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GMount where the @file is located or %NULL on error. @@ -9143,14 +19943,14 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - + @@ -9159,27 +19959,33 @@ a few file-specific operations and seeking and truncating. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + #GMount for given @file or %NULL on error. @@ -9187,14 +19993,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult - + + a #GFile specifying what @file was renamed to, or %NULL @@ -9202,19 +20010,20 @@ a few file-specific operations and seeking and truncating. + a string. + optional #GCancellable object, %NULL to ignore. - + @@ -9223,30 +20032,37 @@ a few file-specific operations and seeking and truncating. + a string. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFile or %NULL on error. @@ -9254,16 +20070,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileAttributeInfoList describing the settable attributes. @@ -9274,32 +20090,30 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - - + + - - + + - + + a #GFileAttributeInfoList describing the writable namespaces. @@ -9310,83 +20124,90 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - - + + - - + + - + - + %TRUE if the attribute was set, %FALSE otherwise. + + a string containing the attribute's name. + The type of the attribute - + a pointer to the value (or the pointer itself if the type is a pointer type) + + a set of #GFileQueryInfoFlags. + optional #GCancellable object, %NULL to ignore. - + - + %TRUE if there was any error, %FALSE otherwise. + + a #GFileInfo. + #GFileQueryInfoFlags + optional #GCancellable object, %NULL to ignore. - + @@ -9395,51 +20216,65 @@ a few file-specific operations and seeking and truncating. + a #GFileInfo. + a #GFileQueryInfoFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback. - + a #gpointer. + - + - + %TRUE if the attributes were set correctly, %FALSE otherwise. + + a #GAsyncResult. - + + a #GFileInfo. - + + #GFileInputStream or %NULL on error. @@ -9449,13 +20284,14 @@ a few file-specific operations and seeking and truncating. + a #GCancellable - + @@ -9464,25 +20300,33 @@ a few file-specific operations and seeking and truncating. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileInputStream or %NULL on error. @@ -9490,14 +20334,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileOutputStream, or %NULL on error. @@ -9505,18 +20351,20 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. - + @@ -9525,28 +20373,37 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a valid #GFileOutputStream or %NULL on error. @@ -9554,14 +20411,16 @@ a few file-specific operations and seeking and truncating. + #GAsyncResult - + + a #GFileOutputStream for the newly created file, or @@ -9569,18 +20428,20 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. - + @@ -9589,28 +20450,37 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileOutputStream or %NULL on error. @@ -9618,39 +20488,45 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileOutputStream or %NULL on error. - + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore. - + %TRUE if a backup should be created. + + a set of #GFileCreateFlags. + optional #GCancellable object, %NULL to ignore. - + @@ -9658,35 +20534,46 @@ a few file-specific operations and seeking and truncating. - + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. - + %TRUE if a backup should be created. + + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileOutputStream, or %NULL on error. @@ -9694,15 +20581,17 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + - + %TRUE if the file was deleted. %FALSE otherwise. + @@ -9711,29 +20600,31 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - - + + - - + + - + - + %TRUE on successful trash, %FALSE otherwise. + @@ -9742,29 +20633,30 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - - + + - - + + - + - + @@ -9778,90 +20670,97 @@ a few file-specific operations and seeking and truncating. - - + + - - + + - + - + %TRUE on the creation of a new symlink, %FALSE otherwise. + + a string with the path for the target of the new symlink + optional #GCancellable object, %NULL to ignore. - - + + - - + + - - + + - + %TRUE on success, %FALSE otherwise. + + destination #GFile + set of #GFileCopyFlags + optional #GCancellable object, %NULL to ignore. - + + function to callback with progress information - + user data to pass to @progress_callback + - - + + @@ -9870,96 +20769,119 @@ a few file-specific operations and seeking and truncating. + destination #GFile + set of #GFileCopyFlags - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + function to callback with progress information - + user data to pass to @progress_callback + - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + - + a %TRUE on success, %FALSE on error. + + a #GAsyncResult. - - + + - + %TRUE on successful move, %FALSE otherwise. + + #GFile pointing to the destination location. + set of #GFileCopyFlags. + optional #GCancellable object, %NULL to ignore. - + + #GFileProgressCallback function for updates. - + gpointer to user data for the callback function. + - - + + - - + + - + @@ -9968,30 +20890,37 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation, or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + + a #GFile or %NULL on error. @@ -9999,13 +20928,14 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + @@ -10014,41 +20944,48 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. - + @@ -10057,42 +20994,48 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the @file was ejected successfully. %FALSE + + a #GAsyncResult. - + @@ -10101,45 +21044,54 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if successful. If an error + + a #GAsyncResult. - + + a #GFileMonitor for the given @file, or %NULL on error. @@ -10147,19 +21099,22 @@ a few file-specific operations and seeking and truncating. + a set of #GFileMonitorFlags. + optional #GCancellable object, %NULL to ignore. - + + a #GFileMonitor for the given @file, or %NULL on error. @@ -10167,19 +21122,22 @@ a few file-specific operations and seeking and truncating. + a set of #GFileMonitorFlags. + optional #GCancellable object, %NULL to ignore. - + + #GFileIOStream or %NULL on error. @@ -10189,13 +21147,14 @@ a few file-specific operations and seeking and truncating. + a #GCancellable - + @@ -10204,27 +21163,33 @@ a few file-specific operations and seeking and truncating. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileIOStream or %NULL on error. @@ -10232,14 +21197,16 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + + a #GFileIOStream for the newly created file, or %NULL on error. @@ -10247,19 +21214,20 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags + optional #GCancellable object, %NULL to ignore - + @@ -10268,30 +21236,37 @@ a few file-specific operations and seeking and truncating. + a set of #GFileCreateFlags - + the <link linkend="io-priority">I/O priority</link> of the request + + optional #GCancellable object, %NULL to ignore - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileIOStream or %NULL on error. @@ -10299,42 +21274,45 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult - + + a #GFileIOStream or %NULL on error. - + + an optional <link linkend="gfile-etag">entity tag</link> for the current #GFile, or #NULL to ignore - + %TRUE if a backup should be created + + a set of #GFileCreateFlags + optional #GCancellable object, %NULL to ignore - + @@ -10342,37 +21320,46 @@ a few file-specific operations and seeking and truncating. - + + an <link linkend="gfile-etag">entity tag</link> for the current #GFile, or NULL to ignore. - + %TRUE if a backup should be created. + + a set of #GFileCreateFlags. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GFileIOStream, or %NULL on error. @@ -10380,13 +21367,14 @@ a few file-specific operations and seeking and truncating. + a #GAsyncResult. - + @@ -10395,44 +21383,52 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation, or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. - + @@ -10441,48 +21437,55 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation, or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. - + - + @@ -10491,45 +21494,52 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation, or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. - + @@ -10538,44 +21548,52 @@ a few file-specific operations and seeking and truncating. + flags affecting the operation + a #GMountOperation, or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the @file was ejected successfully. %FALSE + + a #GAsyncResult. - + @@ -10586,29 +21604,35 @@ a few file-specific operations and seeking and truncating. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied, or %NULL. - + the data to pass to callback function + - + - + %TRUE if the operation finished successfully. %FALSE + + a #GAsyncResult. @@ -10616,136 +21640,184 @@ a few file-specific operations and seeking and truncating. + Stores information about a file system object referenced by a #GFile. + Creates a new file info structure. + a #GFileInfo. - - - + + Clears the status information from @info. + + + Copies all of the #GFileAttribute<!-- -->s from @src_info to @dest_info. + destination to copy attributes to. - - - + + Duplicates a file info structure. + + a duplicate #GFileInfo of @other. + + + + + Gets the value of a attribute, formated as a string. +This escapes things as needed to make the string valid +utf8. +When you're done with the string it must be freed with g_free(). + + a UTF-8 string associated with the given @attribute. + + a file attribute key. - + + Gets the value of a boolean attribute. If the attribute does not +contain a boolean value, %FALSE will be returned. - + the boolean value contained within the attribute. + - + + a file attribute key. - - - - - + + Gets the value of a byte string attribute. If the attribute does +not contain a byte string, %NULL will be returned. +%NULL otherwise. + + the contents of the @attribute value as a byte string, or + - + + a file attribute key. + Gets the attribute type, value and status for an attribute key. +%FALSE otherwise. - + %TRUE if @info has an attribute named @attribute, + + a file attribute key - + + return location for the attribute type, or %NULL - - + + return location for the attribute value, or %NULL + - + + return location for the attribute status, or %NULL - - - + + Gets a signed 32-bit integer contained within the attribute. If the +attribute does not contain a signed 32-bit integer, or is invalid, +0 will be returned. + + a signed 32-bit integer from the attribute. + + a file attribute key. - + + Gets a signed 64-bit integer contained within the attribute. If the +attribute does not contain an signed 64-bit integer, or is invalid, +0 will be returned. - + a signed 64-bit integer from the attribute. + + a file attribute key. + + + + + + Gets the value of a #GObject attribute. If the attribute does +not contain a #GObject, %NULL will be returned. +%NULL otherwise. + + a #GObject associated with the given @attribute, or + + + + + a file attribute key. - - - - - - - - - - - - - - - - - - - - - - - - + @@ -10755,439 +21827,567 @@ a few file-specific operations and seeking and truncating. + Gets the value of a string attribute. If the attribute does +not contain a string, %NULL will be returned. +%NULL otherwise. + the contents of the @attribute value as a string, or - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a file attribute key. - + c:identifier="g_file_info_get_attribute_stringv" + version="2.22"> + Gets the value of a stringv attribute. If the attribute does +not contain a stringv, %NULL will be returned. +%NULL otherwise. Do not free. + + the contents of the @attribute value as a stringv, or + a file attribute key. - + + Gets the attribute type for an attribute key. +%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set. - + a #GFileAttributeType for the given @attribute, or + + a file attribute key. - - - - - - - + + Gets an unsigned 32-bit integer contained within the attribute. If the +attribute does not contain an unsigned 32-bit integer, or is invalid, +0 will be returned. - + an unsigned 32-bit integer from the attribute. + - - - + a file attribute key. - + + Gets a unsigned 64-bit integer contained within the attribute. If the +attribute does not contain an unsigned 64-bit integer, or is invalid, +0 will be returned. - + a unsigned 64-bit integer from the attribute. + - - - + a file attribute key. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the file's content type. + a string containing the file's content type. + Gets a display name for a file. + a string containing the display name. + Gets the edit name for a file. + a string containing the edit name. + + Gets the <link linkend="gfile-etag">entity tag</link> for a given +#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE. + + a string containing the value of the "etag:value" attribute. + + + + + Gets a file's type (whether it is a regular file, symlink, etc). +This is different from the file's content type, see g_file_info_get_content_type(). + + a #GFileType for the given file. + + + + Gets the icon for a file. + #GIcon for the given @info. - + + Checks if a file is a backup file. - + %TRUE if file is a backup file, %FALSE otherwise. + - - - + + Checks if a file is hidden. + + %TRUE if the file is a hidden file, %FALSE otherwise. + + + + + Checks if a file is a symlink. + + %TRUE if the given @info is a symlink. + + Gets the modification time of the current @info and sets it +in @result. + a #GTimeVal. - + + Gets the name for a file. + a string containing the file name. - + + Gets the file's size. - + a #goffset containing the file's size. + + Gets the value of the sort_order attribute from the #GFileInfo. +See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - + a #gint32 containing the value of the "standard::sort_order" attribute. + + + Gets the symlink target for a given #GFileInfo. + + a string containing the symlink target. + + + + + Checks if a file info structure has an attribute named @attribute. +%FALSE otherwise. + + %TRUE if @Ginfo has an attribute named @attribute, + + + + + a file attribute key. + + + + + + Checks if a file info structure has an attribute in the +specified @name_space. +%FALSE otherwise. + + %TRUE if @Ginfo has an attribute in @name_space, + + + + + a file attribute namespace. + + + + + + Lists the file info structure's attributes. +possible attribute types for the given @name_space, or +%NULL on error. + + a null-terminated array of strings of all of the + + + + + + + a file attribute key's namespace. + + + + + + Removes all cases of @attribute from @info if it exists. + + + + + + a file attribute key. + + + + + + Sets the @attribute to contain the given value, if possible. + + + + + + a file attribute key. + + + + a #GFileAttributeType + + + + pointer to the value + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + a file attribute key. + + + + a boolean value. + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + a file attribute key. + + + + a byte string. + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + a file attribute key. + + + + a signed 32-bit integer + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + attribute name to set. + + + + int64 value to set attribute to. + + + + + Sets @mask on @info to match specific attribute types. + a #GFileAttributeMatcher. - - - - - - + + Sets the @attribute to contain the given @attr_value, +if possible. - - + + a file attribute key. + + + + a #GObject. + - + + Sets the attribute status for an attribute key. This is only +needed by external code that implement g_file_set_attributes_from_info() +or similar functions. +The attribute must exist in @info for this to work. Otherwise %FALSE +is returned and @info is unchanged. - + %TRUE if the status was changed, %FALSE if the key was not set. + - - + + a file attribute key + + + + a #GFileAttributeStatus + - + + Sets the @attribute to contain the given @attr_value, +if possible. - - + + a file attribute key. + + + + a string. + - + + Sets the @attribute to contain the given @attr_value, +if possible. - + + a file attribute key. + + + + a %NULL terminated string array + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + a file attribute key. + + + + an unsigned 32-bit integer. + + + + + + Sets the @attribute to contain the given @attr_value, +if possible. + + + + + + a file attribute key. + + + + an unsigned 64-bit integer. + + + + + + Sets the content type attribute for a given #GFileInfo. +See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE. + + + + + + a content type. See #GContentType. + Sets the display name for the current #GFileInfo. +See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. + a string containing a display name. + Sets the edit name for the current file. +See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME. + a string containing an edit name. + + Sets the file type in a #GFileInfo to @type. +See %G_FILE_ATTRIBUTE_STANDARD_TYPE. + + + + + + a #GFileType. + + + + + Sets the icon for a given #GFileInfo. +See %G_FILE_ATTRIBUTE_STANDARD_ICON. + a #GIcon. - + + Sets the "is_hidden" attribute in a #GFileInfo according to @is_symlink. +See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN. - - + + a #gboolean. + - + + Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink. +See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK. - - + + a #gboolean. + @@ -11202,111 +22402,159 @@ a few file-specific operations and seeking and truncating. - + + Sets the name attribute for the current #GFileInfo. +See %G_FILE_ATTRIBUTE_STANDARD_NAME. - + + a string containing a name. + + Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info +to the given size. + + + + + + a #goffset containing the file's size. + + + + + Sets the sort order attribute in the file info structure. See +%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER. - + a sort order integer. + + + Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info +to the given symlink target. + + + + + + a static string containing a path to a symlink target. + + + + + + Unsets a mask set by g_file_info_set_attribute_mask(), if one +is set. + + + + + A subclass of GInputStream for opened files. This adds +a few file-specific operations and seeking. +#GFileInputStream implements #GSeekable. - - - - - - + - - - - - - - - - - - - - - - - + Queries a file input stream the given @attributes. This function blocks +while querying the stream. For the asynchronous (non-blocking) version +of this function, see g_file_input_stream_query_info_async(). While the +stream is blocked, the stream will set the pending flag internally, and +any other operations on the stream will fail with %G_IO_ERROR_PENDING. + a #GFileInfo, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. + Queries the stream information asynchronously. +When the operation is finished @callback will be called. +You can then call g_file_input_stream_query_info_finish() +to get the result of the operation. +For the synchronous version of this function, +see g_file_input_stream_query_info(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set + a file attribute query string. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - - + + the data to pass to callback function + - + + Finishes an asynchronous info query operation. + #GFileInfo. @@ -11315,59 +22563,105 @@ a few file-specific operations and seeking. + + + + + + + + + + + + + + + + + + + + + + Queries a file input stream the given @attributes. This function blocks +while querying the stream. For the asynchronous (non-blocking) version +of this function, see g_file_input_stream_query_info_async(). While the +stream is blocked, the stream will set the pending flag internally, and +any other operations on the stream will fail with %G_IO_ERROR_PENDING. + a #GFileInfo, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. + Queries the stream information asynchronously. +When the operation is finished @callback will be called. +You can then call g_file_input_stream_query_info_finish() +to get the result of the operation. +For the synchronous version of this function, +see g_file_input_stream_query_info(). +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set + a file attribute query string. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="4"> + callback to call when the request is satisfied - + the data to pass to callback function + + Finishes an asynchronous info query operation. + #GFileInfo. + a #GAsyncResult. @@ -11386,9 +22680,9 @@ a few file-specific operations and seeking. - - - + + + @@ -11398,9 +22692,9 @@ a few file-specific operations and seeking. - + - + @@ -11410,31 +22704,30 @@ a few file-specific operations and seeking. - + - + - + - + - + + a #GFileInfo, or %NULL on error. @@ -11442,18 +22735,20 @@ a few file-specific operations and seeking. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. - + @@ -11462,30 +22757,37 @@ a few file-specific operations and seeking. + a file attribute query string. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + + #GFileInfo. @@ -11498,99 +22800,120 @@ a few file-specific operations and seeking. - - + + - - + + - - + + - - + + - - + + - + + Watches for changes to a file. + Cancels a file monitor. - + %TRUE if monitor was cancelled. + + Cancels a file monitor. - + %TRUE if monitor was cancelled. + - - - - - - - - - - - - - - - + Emits the #GFileMonitor::changed signal if a change +has taken place. Should be called from file monitor +implementations only. +The signal will be emitted from an idle handler (in the <link +linkend="g-main-context-push-thread-default">thread-default main +context</link>). + a #GFile. + a #GFile. + a set of #GFileMonitorEvent flags. - - + + Returns whether the monitor is canceled. + + %TRUE if monitor is canceled. %FALSE otherwise. + + + + + Sets the rate limit to which the @monitor will report +consecutive change events to the same file. + + + + + + a integer with the limit in milliseconds to poll for changes. + + + + + + - - + + @@ -11599,18 +22922,22 @@ a few file-specific operations and seeking. - - + Emitted when a file has been changed. + + - + a #GFile. + - + a #GFile. + - + a #GFileMonitorEvent. + @@ -11622,7 +22949,7 @@ a few file-specific operations and seeking. - + @@ -11643,9 +22970,10 @@ a few file-specific operations and seeking. - + - + %TRUE if monitor was cancelled. + @@ -11654,36 +22982,36 @@ a few file-specific operations and seeking. - - + + - - + + - - + + - - + + - - + + @@ -11691,10 +23019,10 @@ a few file-specific operations and seeking. + Specifies what type of event a monitor event is. + Flags used to set what a #GFileMonitor will watch for. - + + A subclass of GOutputStream for opened files. This adds +a few file-specific operations and seeking and truncating. +#GFileOutputStream implements GSeekable. - - - - - - + - - - - - - - - - - - - - - - - - + - - - + + Gets the entity tag for the file when it has been written. +This must be called after the stream has been written +and closed, as the etag can change while writing. + + the entity tag for the stream. + - - - - - - - - + Queries a file output stream for the given @attributes. +This function blocks while querying the stream. For the asynchronous +version of this function, see g_file_output_stream_query_info_async(). +While the stream is blocked, the stream will set the pending flag +internally, and any other operations on the stream will fail with +%G_IO_ERROR_PENDING. +Can fail if the stream was already closed (with @error being set to +%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being +set to %G_IO_ERROR_PENDING), or if querying info is not supported for +the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In +all cases of failure, %NULL will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will +be returned. + a #GFileInfo for the @stream, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. + Asynchronously queries the @stream for a #GFileInfo. When completed, +finish the operation with g_file_output_stream_query_info_finish(). +For the synchronous version of this function, see +g_file_output_stream_query_info(). + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - - + + the data to pass to callback function + - + + Finalizes the asynchronous query started +by g_file_output_stream_query_info_async(). + A #GFileInfo for the finished query. @@ -11858,73 +23192,137 @@ a few file-specific operations and seeking and truncating. - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the entity tag for the file when it has been written. +This must be called after the stream has been written +and closed, as the etag can change while writing. + + the entity tag for the stream. + + + + Queries a file output stream for the given @attributes. +This function blocks while querying the stream. For the asynchronous +version of this function, see g_file_output_stream_query_info_async(). +While the stream is blocked, the stream will set the pending flag +internally, and any other operations on the stream will fail with +%G_IO_ERROR_PENDING. +Can fail if the stream was already closed (with @error being set to +%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being +set to %G_IO_ERROR_PENDING), or if querying info is not supported for +the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In +all cases of failure, %NULL will be returned. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will +be returned. + a #GFileInfo for the @stream, or %NULL on error. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. + Asynchronously queries the @stream for a #GFileInfo. When completed, +finish the operation with g_file_output_stream_query_info_finish(). +For the synchronous version of this function, see +g_file_output_stream_query_info(). + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + closure="4"> + callback to call when the request is satisfied - + the data to pass to callback function + + Finalizes the asynchronous query started +by g_file_output_stream_query_info_async(). + A #GFileInfo for the finished query. + a #GAsyncResult. - - - - - @@ -11940,9 +23338,9 @@ a few file-specific operations and seeking and truncating. - - - + + + @@ -11952,9 +23350,9 @@ a few file-specific operations and seeking and truncating. - + - + @@ -11964,32 +23362,30 @@ a few file-specific operations and seeking and truncating. - + - + - + - + - + - + @@ -11999,28 +23395,27 @@ a few file-specific operations and seeking and truncating. - + - + - + - + - + + a #GFileInfo for the @stream, or %NULL on error. @@ -12028,18 +23423,20 @@ a few file-specific operations and seeking and truncating. + a file attribute query string. + optional #GCancellable object, %NULL to ignore. - + @@ -12048,30 +23445,37 @@ a few file-specific operations and seeking and truncating. + a file attribute query string. - + the <link linkend="gio-GIOScheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + + A #GFileInfo for the finished query. @@ -12085,8 +23489,9 @@ a few file-specific operations and seeking and truncating. - + + the entity tag for the stream. @@ -12096,69 +23501,73 @@ a few file-specific operations and seeking and truncating. - - + + - - + + - - + + - - + + - - + + - + - + When doing file operations that may take a while, such as moving a file or copying a file, a progress callback is used to pass how -far along that operation is to the application."> +far along that operation is to the application. - + the current number of bytes in the operation. + - + the total number of bytes in the operation. + - + user data passed to the callback. + + Flags used when querying a #GFileInfo. c:identifier="G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS" glib:nick="nofollow-symlinks"/> - + When loading the partial contents of a file with g_file_load_partial_contents_async(), it may become necessary to determine if any more data from the file should be loaded. A #GFileReadMoreCallback function facilitates this by returning %TRUE if more data -should be read, or %FALSE otherwise."> +should be read, or %FALSE otherwise. - + %TRUE if more data should be read back. %FALSE otherwise. + + the data as currently read. - + the size of the data currently read. + - + data passed to the callback. + + Indicates the file's on-disk type. + Completes filenames based on files that exist within the file system. + Creates a new filename completer. + a #GFilenameCompleter. + Obtains a completion for @initial_text from @completer. +This string is not owned by GIO, so remember to g_free() it +when finished. + a completed string, or %NULL if no completion exists. + text to be completed. + Gets an array of completion strings for a given initial text. +This array must be freed by g_strfreev() when finished. + array of strings with possible completions for @initial_text. + text to be completed. + If @dirs_only is %TRUE, @completer will only +complete directory names, and not file names. - + a #gboolean. + - - + Emitted when the file name completion information comes available. + + @@ -12285,7 +23711,7 @@ Indicates the file's on-disk type." - + @@ -12296,22 +23722,22 @@ Indicates the file's on-disk type." - - + + - - + + - - + + @@ -12319,12 +23745,12 @@ Indicates the file's on-disk type." + Indicates a hint from the file system whether files should be +previewed in a file manager. Returned as the value of the key +#G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW. + A base class for all input streams that work on an underlying stream. - + Gets the base stream for the filter stream. + + a #GInputStream. + Returns whether the base stream will be closed when @stream is +closed. - + %TRUE if the base stream will be closed. + + Sets whether the base stream will be closed when @stream is closed. - + %TRUE to close the base stream. + - - + + - - + + @@ -12387,22 +23828,22 @@ previewed in a file manager. Returned as the value of the key - - + + - - + + - - + + @@ -12410,40 +23851,55 @@ previewed in a file manager. Returned as the value of the key + A base class for all output streams that work on an underlying stream. - + Gets the base stream for the filter stream. + + a #GOutputStream. + Returns whether the base stream will be closed when @stream is +closed. - + %TRUE if the base stream will be closed. + + Sets whether the base stream will be closed when @stream is closed. - + %TRUE to close the base stream. + - - + + - - + + @@ -12458,22 +23914,22 @@ previewed in a file manager. Returned as the value of the key - - + + - - + + - - + + @@ -12481,14 +23937,11 @@ previewed in a file manager. Returned as the value of the key + Error codes returned by GIO functions. + + + + + + + + - + + Gets the name under which @extension was registered. +Note that the same type may be registered as extension +for multiple extension points, under different names. + the name of @extension. + Gets the priority with which @extension was registered. - + the priority of @extension + - + + Gets a reference to the class for the type that is +associated with @extension. + the #GTypeClass for the type of @extension - + + + Finds a #GIOExtension for an extension point by name. +given name, or %NULL if there is no extension with that name + + the #GIOExtension for @extension_point that has the + + + + + the name of the extension to get + + + + + + Gets a list of all extensions that implement this extension point. +The list is sorted by priority, beginning with the highest priority. +#GIOExtension<!-- -->s. The list is owned by GIO and should not be +modified. + + a #GList of + + + + + + + Gets the required type for @extension_point. +or #G_TYPE_INVALID if the extension point has no required type + + the #GType that all implementations must have, + + + + Sets the required type for @extension_point to @type. +All implementations must henceforth have this type. + the #GType to require - - - - - - - - - - - - - - - - - - - - + Opaque module base class for extending GIO. + Creates a new GIOModule that will load the specific +shared library when in use. +or %NULL on error. + a #GIOModule from given @filename, + filename of the shared library module. + Optional API for GIO modules to implement. Should return a list of all the extension points that may be implemented in this module. This method will not be called in normal use, however it may be called when probing existing modules and recording which extension -points that this modle is used for. This means we won't have to +points that this modle is used for. This means we won't have to load and initialze this module unless its needed. If this function is not implemented by the module the module will always be loaded, initialized and then unloaded on application startup @@ -12725,28 +24246,26 @@ When installing a module that implements g_io_module_query you must run gio-querymodules in order to build the cache files required for lazy loading. extension points of the module. The array must be suitable for -freeing with g_strfreev()." - version="2.24"> - +freeing with g_strfreev(). + + A %NULL-terminated array of strings, listing the supported - + Required API for GIO modules to implement. This function is ran after the module has been loaded into GIO, -to initialize the module."> +to initialize the module. - + Required API for GIO modules to implement. This function is ran when the module is being unloaded from GIO, -to finalize the module."> +to finalize the module. @@ -12754,34 +24273,48 @@ to finalize the module."> - + + Opaque class for definining and scheduling IO jobs. + Used from an I/O job to send a callback to be run in the thread +that the job was started from, waiting for the result (and thus +blocking the I/O job). - + The return value of @func + + closure="1" + destroy="2"> + a #GSourceFunc callback that will be called in the original thread - + data to pass to @func + - + + a #GDestroyNotify for @user_data, or %NULL + Used from an I/O job to send a callback to be run asynchronously in +the thread that the job was started from. The callback will be run +when the main loop is available, but at that time the I/O job might +have finished. The return value from the callback is ignored. +Note that if you are passing the @user_data from g_io_scheduler_push_job() +on to this function you have to ensure that it is not freed before +g_io_scheduler_push_job() or by using refcounting for @user_data. @@ -12789,193 +24322,306 @@ to finalize the module."> + closure="1" + destroy="2"> + a #GSourceFunc callback that will be called in the original thread - + data to pass to @func + - + + a #GDestroyNotify for @user_data, or %NULL - + I/O Job function. Note that depending on whether threads are available, the #GIOScheduler may run jobs in separate threads or in an idle in the mainloop. Long-running jobs should periodically check the @cancellable to see if they have been cancelled. -complete the job, %FALSE if the job is complete (or cancelled)"> +complete the job, %FALSE if the job is complete (or cancelled) - + %TRUE if this function should be called again to + + a #GIOSchedulerJob. + optional #GCancellable object, %NULL to ignore. - + the data to pass to callback function + - - - - - - - - - - - - - - - - - - - - - + Base class for read-write streams. + + Requests an asynchronous close of the stream, releasing resources +related to it. When the operation is finished @callback will be +called. You can then call g_io_stream_close_finish() to get +the result of the operation. +For behaviour details see g_io_stream_close(). +The asynchronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the io priority of the request + + optional cancellable object + closure="3"> + callback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Closes a stream. + + %TRUE if stream was successfully closed, %FALSE otherwise. + + + + + a #GAsyncResult + + + + + + + + + + + + + + + + Gets the input stream for this object. This is used +for reading. +Do not free. + + a #GInputStream, owned by the #GIOStream. + + + + + Gets the output stream for this object. This is used for +writing. +Do not free. + + a #GOutputStream, owned by the #GIOStream. + + + + + Clears the pending flag on @stream. + + + + + + Closes the stream, releasing resources related to it. This will also +closes the individual input and output streams, if they are not already +closed. +Once the stream is closed, all other operations will return +%G_IO_ERROR_CLOSED. Closing a stream multiple times will not +return an error. +Closing a stream will automatically flush any outstanding buffers +in the stream. +Streams will be automatically closed when the last reference +is dropped, but you might want to call this function to make sure +resources are released as early as possible. +Some streams might keep the backing store of the stream (e.g. a file +descriptor) open after the stream is closed. See the documentation for +the individual stream for details. +On failure the first error that happened will be reported, but the +close operation will finish as much as possible. A stream that failed +to close will still return %G_IO_ERROR_CLOSED for all operations. +Still, it is important to check and report the error to the user, +otherwise there might be a loss of data as all data might not be written. +If @cancellable is not NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Cancelling a close will still leave the stream closed, but some streams +can use a faster close that doesn't block to e.g. check errors. +The default implementation of this method just calls close on the +individual input/output streams. + + %TRUE on success, %FALSE on failure + + + + + optional #GCancellable object, %NULL to ignore + + + + + + Requests an asynchronous close of the stream, releasing resources +related to it. When the operation is finished @callback will be +called. You can then call g_io_stream_close_finish() to get +the result of the operation. +For behaviour details see g_io_stream_close(). +The asynchronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. + + + + + + the io priority of the request + + + + optional cancellable object + + + + callback to call when the request is satisfied - + the data to pass to callback function + + Closes a stream. - + %TRUE if stream was successfully closed, %FALSE otherwise. + + a #GAsyncResult - + + Gets the input stream for this object. This is used +for reading. +Do not free. - + a #GInputStream, owned by the #GIOStream. + - + + Gets the output stream for this object. This is used for +writing. +Do not free. - + a #GOutputStream, owned by the #GIOStream. + + + + + Checks if a stream has pending actions. + + %TRUE if @stream has pending actions. + + + + + Checks if a stream is closed. + + %TRUE if the stream is closed. + + Sets @stream to have actions pending. If the pending flag is +already set or @stream is closed, it will return %FALSE and set - + %TRUE if pending was previously unset and is now set. + - - - - - - - + + - - + + - - + + @@ -12991,8 +24637,9 @@ complete the job, %FALSE if the job is complete (or cancelled)"> - - + + + a #GInputStream, owned by the #GIOStream. @@ -13003,8 +24650,9 @@ complete the job, %FALSE if the job is complete (or cancelled)"> - - + + + a #GOutputStream, owned by the #GIOStream. @@ -13015,24 +24663,22 @@ complete the job, %FALSE if the job is complete (or cancelled)"> - + - + - + - + @@ -13041,179 +24687,233 @@ complete the job, %FALSE if the job is complete (or cancelled)"> - + the io priority of the request + + optional cancellable object - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if stream was successfully closed, %FALSE otherwise. + + a #GAsyncResult - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + - - - - - + An abstract type that specifies an icon. + Checks if two icons are equal. - + %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. + + pointer to the second #GIcon. - + - + + + + + Generates a textual representation of @icon that can be used for +serialization such as when passing @icon to a different process or +saving it to persistent storage. Use g_icon_new_for_string() to +get @icon back from the returned string. +The encoding of the returned string is proprietary to #GIcon except +in the following two cases +<itemizedlist> +<listitem><para> +If @icon is a #GFileIcon, the returned string is a native path +(such as <literal>/path/to/my icon.png</literal>) without escaping +if the #GFile for @icon is a native file. If the file is not +native, the returned string is the result of g_file_get_uri() +(such as <literal>sftp://path/to/my%%20icon.png</literal>). +</para></listitem> +<listitem><para> +If @icon is a #GThemedIcon with exactly one name, the encoding is +simply the name (such as <literal>network-server</literal>). +</para></listitem> +</itemizedlist> +be serialized. Use g_free() to free. + + An allocated NUL-terminated UTF8 string or %NULL if @icon can't + - + + + - - + + + Checks if two icons are equal. - + %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. + + pointer to the second #GIcon. - + + Generates a textual representation of @icon that can be used for +serialization such as when passing @icon to a different process or +saving it to persistent storage. Use g_icon_new_for_string() to +get @icon back from the returned string. +The encoding of the returned string is proprietary to #GIcon except +in the following two cases +<itemizedlist> +<listitem><para> +If @icon is a #GFileIcon, the returned string is a native path +(such as <literal>/path/to/my icon.png</literal>) without escaping +if the #GFile for @icon is a native file. If the file is not +native, the returned string is the result of g_file_get_uri() +(such as <literal>sftp://path/to/my%%20icon.png</literal>). +</para></listitem> +<listitem><para> +If @icon is a #GThemedIcon with exactly one name, the encoding is +simply the name (such as <literal>network-server</literal>). +</para></listitem> +</itemizedlist> +be serialized. Use g_free() to free. + An allocated NUL-terminated UTF8 string or %NULL if @icon can't + GIconIface is used to implement GIcon types for various different systems. See #GThemedIcon and #GLoadableIcon for -examples of how to implement this interface."> +examples of how to implement this interface. - + - + @@ -13223,244 +24923,359 @@ examples of how to implement this interface."> - + - + %TRUE if @icon1 is equal to @icon2. %FALSE otherwise. + + pointer to the second #GIcon. - + - + An allocated NUL-terminated UTF8 string or %NULL if @icon can't + - + + + - - + + - - - + + + - - - + - + - + - + An IPv4 or IPv6 internet address. + + Creates a #GInetAddress for the "any" address (unassigned/"don't +care") for @family. +for @family. + a new #GInetAddress corresponding to the "any" address - - + + the address family + + c:identifier="g_inet_address_new_from_bytes" + version="2.22"> + Creates a new #GInetAddress from the given @family and @bytes. +%G_INET_ADDRESS_IPV6. + a new #GInetAddress corresponding to @family and @bytes. - - - + raw address data + + the address family of @bytes + + Parses @string as an IP address and creates a new #GInetAddress. + + a new #GInetAddress corresponding to @string, or %NULL if + + + + + a string representation of an IP address + + + + + c:identifier="g_inet_address_new_loopback" + version="2.22"> + Creates a #GInetAddress for the loopback address for @family. +for @family. + a new #GInetAddress corresponding to the loopback address + the address family - - - + + Gets the raw binary address data from @address. +which should not be modified, stored, or freed. The size of this +array can be gotten with g_inet_address_get_native_size(). + + a pointer to an internal array of the bytes in @address, + - - - - - - - + + + Converts @address to string form. +freed after use. + a representation of @address as a string, which should be - + + Gets @address's family - - - - - - - - - - - - - - - - - - - - - - - - + @address's family - + + Tests whether @address is the "any" address for its family. - - - - - - + %TRUE if @address is the "any" address for its family. + + c:identifier="g_inet_address_get_is_link_local" + version="2.22"> + Tests whether @address is a link-local address (that is, if it +identifies a host on a local network that is not connected to the +Internet). - + %TRUE if @address is a link-local address. + - + + Tests whether @address is the loopback address for its family. - - - - - - + %TRUE if @address is the loopback address for its family. + + c:identifier="g_inet_address_get_is_mc_global" + version="2.22"> + Tests whether @address is a global multicast address. - + %TRUE if @address is a global multicast address. + + c:identifier="g_inet_address_get_is_mc_link_local" + version="2.22"> + Tests whether @address is a link-local multicast address. - + %TRUE if @address is a link-local multicast address. + + c:identifier="g_inet_address_get_is_mc_node_local" + version="2.22"> + Tests whether @address is a node-local multicast address. - + %TRUE if @address is a node-local multicast address. + + c:identifier="g_inet_address_get_is_mc_org_local" + version="2.22"> + Tests whether @address is an organization-local multicast address. - + %TRUE if @address is an organization-local multicast address. + + c:identifier="g_inet_address_get_is_mc_site_local" + version="2.22"> + Tests whether @address is a site-local multicast address. - + %TRUE if @address is a site-local multicast address. + - - + + Tests whether @address is a multicast address. + + %TRUE if @address is a multicast address. + + + + + Tests whether @address is a site-local address such as 10.0.0.1 +(that is, the address identifies a host on a local network that can +not be reached directly from the Internet, but which may have +outgoing Internet connectivity via a NAT or firewall). + + %TRUE if @address is a site-local address. + + + + + Gets the size of the native raw binary address for @address. This +is the size of the data that you get from g_inet_address_to_bytes(). + + the number of bytes used for the native version of @address. + + + + + Gets the raw binary address data from @address. +which should not be modified, stored, or freed. The size of this +array can be gotten with g_inet_address_get_native_size(). + + a pointer to an internal array of the bytes in @address, + + + + + Converts @address to string form. +freed after use. + + a representation of @address as a string, which should be + + + + + - - + + - - + + Whether this is the "any" address for its family. +See g_inet_address_get_is_any(). + - - + + Whether this is a link-local address. +See g_inet_address_get_is_link_local(). + - - + + Whether this is the loopback address for its family. +See g_inet_address_get_is_loopback(). + - - + + Whether this is a global multicast address. +See g_inet_address_get_is_mc_global(). + - - + + Whether this is a link-local multicast address. +See g_inet_address_get_is_mc_link_local(). + - - + + Whether this is a node-local multicast address. +See g_inet_address_get_is_mc_node_local(). + - - + + Whether this is an organization-local multicast address. +See g_inet_address_get_is_mc_org_local(). + - - + + Whether this is a site-local multicast address. +See g_inet_address_get_is_mc_site_local(). + - - + + Whether this is a multicast address. +See g_inet_address_get_is_multicast(). + - - + + Whether this is a site-local address. +See g_inet_address_get_is_loopback(). + @@ -13476,8 +25291,9 @@ examples of how to implement this interface."> - + + a representation of @address as a string, which should be @@ -13488,11 +25304,10 @@ examples of how to implement this interface."> - + - - - + a pointer to an internal array of the bytes in @address, + @@ -13502,44 +25317,69 @@ examples of how to implement this interface."> - + + An IPv4 or IPv6 socket address, corresponding to a <type>struct +sockaddr_in</type> or <type>struct sockaddr_in6</type>. - + + Creates a new #GInetSocketAddress for @address and @port. - + a new #GInetSocketAddress + + a #GInetAddress - + a port number + + c:identifier="g_inet_socket_address_get_address" + version="2.22"> + Gets @address's #GInetAddress. +g_object_ref()'d if it will be stored + the #GInetAddress for @address, which must be - + + Gets @address's port. - + the port for @address + - - + + - - + + @@ -13556,35 +25396,79 @@ examples of how to implement this interface."> - + - + Interface for initializable objects. + + Initializes the object implementing the interface. This must be +done before any real use of the object after initial construction. +Implementations may also support cancellation. If @cancellable is not %NULL, +then initialization can be cancelled by triggering the cancellable object +from another thread. If the operation was cancelled, the error +%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and +the object doesn't support cancellable initialization the error +%G_IO_ERROR_NOT_SUPPORTED will be returned. +If this function is not called, or returns with an error then all +operations on the object should fail, generally returning the +error %G_IO_ERROR_NOT_INITIALIZED. +Implementations of this method must be idempotent, i.e. multiple calls +to this function with the same argument should return the same results. +Only the first call initializes the object, further calls return the result +of the first call. This is so that its safe to implement the singleton +pattern in the GObject constructor function. +return %FALSE and set @error appropriately if present. - + %TRUE if successful. If an error has occurred, this function will + + optional #GCancellable object, %NULL to ignore. - + + Initializes the object implementing the interface. This must be +done before any real use of the object after initial construction. +Implementations may also support cancellation. If @cancellable is not %NULL, +then initialization can be cancelled by triggering the cancellable object +from another thread. If the operation was cancelled, the error +%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and +the object doesn't support cancellable initialization the error +%G_IO_ERROR_NOT_SUPPORTED will be returned. +If this function is not called, or returns with an error then all +operations on the object should fail, generally returning the +error %G_IO_ERROR_NOT_INITIALIZED. +Implementations of this method must be idempotent, i.e. multiple calls +to this function with the same argument should return the same results. +Only the first call initializes the object, further calls return the result +of the first call. This is so that its safe to implement the singleton +pattern in the GObject constructor function. +return %FALSE and set @error appropriately if present. - + %TRUE if successful. If an error has occurred, this function will + + optional #GCancellable object, %NULL to ignore. @@ -13593,16 +25477,17 @@ examples of how to implement this interface."> + Provides an interface for initializing object such that initialization +may fail. - + - + %TRUE if successful. If an error has occurred, this function will + @@ -13611,6 +25496,7 @@ may fail." + optional #GCancellable object, %NULL to ignore. @@ -13618,173 +25504,382 @@ may fail." - + Base class for streaming input operations. + + Requests an asynchronous closes of the stream, releasing resources related to it. +When the operation is finished @callback will be called. +You can then call g_input_stream_close_finish() to get the result of the +operation. +For behaviour details see g_input_stream_close(). +The asyncronous methods have a default fallback that uses threads to implement +asynchronicity, so they are optional for inheriting classes. However, if you +override one you must override all. - + - - - - - + + the <link linkend="io-priority">I/O priority</link> of the request. + + optional cancellable object + + callback to call when the request is satisfied + + + + the data to pass to callback function + + - + + Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - + %TRUE if the stream was closed successfully. + - - - - - + + a #GAsyncResult. + - + - + + Request an asynchronous read of @count bytes from the stream into the buffer +starting at @buffer. When the operation is finished @callback will be called. +You can then call g_input_stream_read_finish() to get the result of the +operation. +During an async request no other sync and async calls are allowed on @stream, and will +result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes read into the buffer will be passed to the +callback. It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file, but generally we try to read +as many bytes as requested. Zero is returned on end of file +(or if @count is zero), but never otherwise. +Any outstanding i/o request with higher priority (lower numerical value) will +be executed before an outstanding request with lower priority. Default +priority is %G_PRIORITY_DEFAULT. +The asyncronous methods have a default fallback that uses threads to implement +asynchronicity, so they are optional for inheriting classes. However, if you +override one you must override all. - + a buffer to read data into (which should be at least count bytes long). + - + the number of bytes that will be read from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - - + + the data to pass to callback function + + Finishes an asynchronous stream read operation. - + number of bytes read in, or -1 on error. + + a #GAsyncResult. + + + + + + + + + + + + + + + + + + Tries to skip @count bytes from the stream. Will block during the operation. +This is identical to g_input_stream_read(), from a behaviour standpoint, +but the bytes that are skipped are not returned to the user. Some +streams have an implementation that is more efficient than reading the data. +This function is optional for inherited classes, as the default implementation +emulates it using read. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. + + Number of bytes skipped, or -1 on error + + + + + the number of bytes that will be skipped from the stream + + + + optional #GCancellable object, %NULL to ignore. + + + + + Request an asynchronous skip of @count bytes from the stream. +When the operation is finished @callback will be called. +You can then call g_input_stream_skip_finish() to get the result +of the operation. +During an async request no other sync and async calls are allowed, +and will result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes skipped will be passed to the callback. +It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file, but generally we try to skip +as many bytes as requested. Zero is returned on end of file +(or if @count is zero), but never otherwise. +Any outstanding i/o request with higher priority (lower numerical value) +will be executed before an outstanding request with lower priority. +Default priority is %G_PRIORITY_DEFAULT. +The asynchronous methods have a default fallback that uses threads to +implement asynchronicity, so they are optional for inheriting classes. +However, if you override one, you must override all. - + the number of bytes that will be skipped from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - - + + the data to pass to callback function + + Finishes a stream skip operation. - + the size of the bytes skipped, or %-1 on error. + + a #GAsyncResult. - + + Clears the pending flag on @stream. + + + + + + Closes the stream, releasing resources related to it. +Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED. +Closing a stream multiple times will not return an error. +Streams will be automatically closed when the last reference +is dropped, but you might want to call this function to make sure +resources are released as early as possible. +Some streams might keep the backing store of the stream (e.g. a file descriptor) +open after the stream is closed. See the documentation for the individual +stream for details. +On failure the first error that happened will be reported, but the close +operation will finish as much as possible. A stream that failed to +close will still return %G_IO_ERROR_CLOSED for all operations. Still, it +is important to check and report the error to the user. +If @cancellable is not NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Cancelling a close will still leave the stream closed, but some streams +can use a faster close that doesn't block to e.g. check errors. + + %TRUE on success, %FALSE on failure + + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Requests an asynchronous closes of the stream, releasing resources related to it. +When the operation is finished @callback will be called. +You can then call g_input_stream_close_finish() to get the result of the +operation. +For behaviour details see g_input_stream_close(). +The asyncronous methods have a default fallback that uses threads to implement +asynchronicity, so they are optional for inheriting classes. However, if you +override one you must override all. - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional cancellable object - + + callback to call when the request is satisfied - - + + the data to pass to callback function + - - + + + Finishes closing a stream asynchronously, started from g_input_stream_close_async(). - + %TRUE if the stream was closed successfully. + + a #GAsyncResult. - - + + + Checks if an input stream has pending actions. - + %TRUE if @stream has pending actions. + + + + + Checks if an input stream is closed. + + %TRUE if the stream is closed. + + + + + Tries to read @count bytes from the stream into the buffer starting at +If count is zero returns zero and does nothing. A value of @count +larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes read into the buffer is returned. +It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file. Zero is returned on end of file +(or if @count is zero), but never otherwise. +If @cancellable is not NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +On error -1 is returned and @error is set accordingly. + + Number of bytes read, or -1 on error + - + a buffer to read data into (which should be at least count bytes long). + - + the number of bytes that will be read from the stream + + optional #GCancellable object, %NULL to ignore. @@ -13792,194 +25887,213 @@ may fail." + Tries to read @count bytes from the stream into the buffer starting at +This function is similar to g_input_stream_read(), except it tries to +read as many bytes as requested, only stopping on an error or end of stream. +On a successful read of @count bytes, or if we reached the end of the +stream, %TRUE is returned, and @bytes_read is set to the number of bytes +read into @buffer. +If there is an error during the operation %FALSE is returned and @error +is set to indicate the error status, @bytes_read is updated to contain +the number of bytes read into @buffer before the error occurred. - + %TRUE on success, %FALSE if there was an error + - + a buffer to read data into (which should be at least count bytes long). + - + the number of bytes that will be read from the stream + - - + + location to store the number of bytes that was read from the stream + - - - - - - - - - - - - - - - - - - - - - - - + optional #GCancellable object, %NULL to ignore. + Request an asynchronous read of @count bytes from the stream into the buffer +starting at @buffer. When the operation is finished @callback will be called. +You can then call g_input_stream_read_finish() to get the result of the +operation. +During an async request no other sync and async calls are allowed on @stream, and will +result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes read into the buffer will be passed to the +callback. It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file, but generally we try to read +as many bytes as requested. Zero is returned on end of file +(or if @count is zero), but never otherwise. +Any outstanding i/o request with higher priority (lower numerical value) will +be executed before an outstanding request with lower priority. Default +priority is %G_PRIORITY_DEFAULT. +The asyncronous methods have a default fallback that uses threads to implement +asynchronicity, so they are optional for inheriting classes. However, if you +override one you must override all. - + a buffer to read data into (which should be at least count bytes long). + - + the number of bytes that will be read from the stream + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + callback to call when the request is satisfied - + the data to pass to callback function + - + Finishes an asynchronous stream read operation. - + number of bytes read in, or -1 on error. + + a #GAsyncResult. - + + Sets @stream to have actions pending. If the pending flag is +already set or @stream is closed, it will return %FALSE and set - + %TRUE if pending was previously unset and is now set. + + + + + Tries to skip @count bytes from the stream. Will block during the operation. +This is identical to g_input_stream_read(), from a behaviour standpoint, +but the bytes that are skipped are not returned to the user. Some +streams have an implementation that is more efficient than reading the data. +This function is optional for inherited classes, as the default implementation +emulates it using read. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. + + Number of bytes skipped, or -1 on error + - - + + the number of bytes that will be skipped from the stream + + optional #GCancellable object, %NULL to ignore. + + + + + + Request an asynchronous skip of @count bytes from the stream. +When the operation is finished @callback will be called. +You can then call g_input_stream_skip_finish() to get the result +of the operation. +During an async request no other sync and async calls are allowed, +and will result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes skipped will be passed to the callback. +It is not an error if this is not the same as the requested size, as it +can happen e.g. near the end of a file, but generally we try to skip +as many bytes as requested. Zero is returned on end of file +(or if @count is zero), but never otherwise. +Any outstanding i/o request with higher priority (lower numerical value) +will be executed before an outstanding request with lower priority. +Default priority is %G_PRIORITY_DEFAULT. +The asynchronous methods have a default fallback that uses threads to +implement asynchronicity, so they are optional for inheriting classes. +However, if you override one, you must override all. + + + + + + the number of bytes that will be skipped from the stream + + + + the <link linkend="io-priority">I/O priority</link> of the request. + + + + optional #GCancellable object, %NULL to ignore. + callback to call when the request is satisfied - + the data to pass to callback function + - + Finishes a stream skip operation. - + the size of the bytes skipped, or %-1 on error. + + a #GAsyncResult. - - - - - - - - - - - - - - - - - - - - @@ -13994,67 +26108,66 @@ may fail." - + - + - + - + - + - + - + Number of bytes skipped, or -1 on error + - + the number of bytes that will be skipped from the stream + + optional #GCancellable object, %NULL to ignore. - + - + - + - + @@ -14063,45 +26176,56 @@ may fail." - + a buffer to read data into (which should be at least count bytes long). + - + the number of bytes that will be read from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + number of bytes read in, or -1 on error. + + a #GAsyncResult. - + @@ -14110,42 +26234,52 @@ may fail." - + the number of bytes that will be skipped from the stream + - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + the size of the bytes skipped, or %-1 on error. + + a #GAsyncResult. - + @@ -14154,225 +26288,265 @@ may fail." - + the <link linkend="io-priority">I/O priority</link> of the request. + + optional cancellable object - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if the stream was closed successfully. + + a #GAsyncResult. - - + + - - + + - - + + - - + + - - + + - + - + Structure used for scatter/gather data input. You generally pass in an array of #GInputVector<!-- -->s and the operation will store the read data starting in the -first buffer, switching to the next as needed." - version="2.22"> +first buffer, switching to the next as needed. - + - + + Generic type for all kinds of icons that can be loaded +as a stream. + Loads a loadable icon. For the asynchronous version of this function, +see g_loadable_icon_load_async(). + a #GInputStream to read the icon from. - + an integer. + - - - + a location to store the type of the loaded icon, %NULL to ignore. + + optional #GCancellable object, %NULL to ignore. + Loads an icon asynchronously. To finish this function, see +g_loadable_icon_load_finish(). For the synchronous, blocking +version of this function, see g_loadable_icon_load(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + an integer. + + optional #GCancellable object, %NULL to ignore. + closure="3"> + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes an asynchronous icon load started in g_loadable_icon_load_async(). + + a #GInputStream to read the icon from. + + + + + a #GAsyncResult. + + + + a location to store the type of the loaded icon, %NULL to ignore. + + + + + + Loads a loadable icon. For the asynchronous version of this function, +see g_loadable_icon_load_async(). + + a #GInputStream to read the icon from. + + + + + an integer. + + + + a location to store the type of the loaded icon, %NULL to ignore. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Loads an icon asynchronously. To finish this function, see +g_loadable_icon_load_finish(). For the synchronous, blocking +version of this function, see g_loadable_icon_load(). + + + + + + an integer. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Finishes an asynchronous icon load started in g_loadable_icon_load_async(). + a #GInputStream to read the icon from. + a #GAsyncResult. - - - + a location to store the type of the loaded icon, %NULL to ignore. + + glib:is-gtype-struct-for="LoadableIcon"> + Interface for icons that can be loaded as a stream. - + + a #GInputStream to read the icon from. @@ -14380,23 +26554,24 @@ as a stream." - + an integer. + - - - + a location to store the type of the loaded icon, %NULL to ignore. + + optional #GCancellable object, %NULL to ignore. - + @@ -14405,25 +26580,33 @@ as a stream." - + an integer. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GInputStream to read the icon from. @@ -14431,59 +26614,71 @@ as a stream." + a #GAsyncResult. - - - + a location to store the type of the loaded icon, %NULL to ignore. + + Implements #GInputStream for arbitrary memory chunks. + Creates a new empty #GMemoryInputStream. - + a new #GInputStream + + Creates a new #GMemoryInputStream with data in memory of a given size. - + new #GInputStream read from @data of @len bytes. + - + input data + - + length of the data, may be -1 if @data is a nul-terminated string + - + + function that is called to free @data, or %NULL + Appends @data to data that can be read from the input stream - + input data + - + length of the data, may be -1 if @data is a nul-terminated string + - + + function that is called to free @data, or %NULL @@ -14502,106 +26697,184 @@ as a stream." - - + + - - + + - - + + - - + + - - + + - + + Implements #GOutputStream for arbitrary memory chunks. - + + Creates a new #GMemoryOutputStream. +If @data is non-%NULL, the stream will use that for its internal storage. +If @realloc_fn is non-%NULL, it will be used for resizing the internal +storage when necessary. To construct a fixed-size output stream, +pass %NULL as @realloc_fn. +|[ +/&ast; a stream that can grow &ast;/ +stream = g_memory_output_stream_new (NULL, 0, realloc, free); +/&ast; another stream that can grow &ast;/ +stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free); +/&ast; a fixed-size stream &ast;/ +data = malloc (200); +stream3 = g_memory_output_stream_new (data, 200, NULL, free); +]| - + A newly created #GMemoryOutputStream object. + - + pointer to a chunk of memory to use, or %NULL + - + the size of @data + + a function with realloc() semantics (like g_realloc()) to be called when @data needs to be grown, or %NULL + scope="async"> + a function to be called on @data when the stream is finalized, or %NULL - - - - - - - - + + Gets any loaded data from the @ostream. +Note that the returned pointer may become invalid on the next +write or truncate operation on the stream. + + pointer to the stream's data + + c:identifier="g_memory_output_stream_get_data_size" + version="2.18"> + Returns the number of bytes from the start up +to including the last byte written in the stream +that has not been truncated away. - + the number of bytes written to the stream + - - + + Gets the size of the currently allocated data area (availible from +g_memory_output_stream_get_data()). If the stream isn't +growable (no realloc was passed to g_memory_output_stream_new()) then +this is the maximum size of the stream and further writes +will return %G_IO_ERROR_NO_SPACE. +Note that for growable streams the returned size may become invalid on +the next write or truncate operation on the stream. +If you want the number of bytes currently written to the stream, use +g_memory_output_stream_get_data_size(). + + the number of bytes allocated for the data buffer + + + + + Gets any loaded data from the @ostream. Ownership of the data +is transferred to the caller; when no longer needed it must be +freed using the free function set in @ostream's +#GMemoryOutputStream:destroy-function property. + + the stream's data + + + + + Pointer to buffer where data will be written. + - - + + Size of data written to the buffer. + - - + + Function called with the buffer as argument when the stream is destroyed. + - - + + Function with realloc semantics called to enlarge the buffer. + - - + + Current size of the data buffer. + @@ -14617,36 +26890,36 @@ as a stream." - - + + - - + + - - + + - - + + - - + + @@ -14654,625 +26927,970 @@ as a stream." + c:type="GMemoryOutputStreamPrivate" + disguised="1"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - + A handle to an object implementing the #GMountIface interface. + + Checks if @mount can be eject. + + %TRUE if the @mount can be ejected. + + Checks if @mount can be mounted. - + %TRUE if the @mount can be unmounted. + - - - - - - + + Ejects a mount. This is an asynchronous operation, and is +finished by calling g_mount_eject_finish() with the @mount +and #GAsyncResult data returned in the @callback. + flags affecting the unmount if required for eject + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - - + + user data passed to @callback. + - + Finishes ejecting a mount. If any errors occurred during the operation, - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. + invoker="eject_with_operation" + version="2.22"> + Ejects a mount. This is an asynchronous operation, and is +finished by calling g_mount_eject_with_operation_finish() with the @mount +and #GAsyncResult data returned in the @callback. + flags affecting the unmount if required for eject + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - - + + user data passed to @callback. + + Finishes ejecting a mount. If any errors occurred during the operation, - + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. + Gets the default location of @mount. The default location of the given +the home directory, or the root of the volume). +The returned object should be unreffed with +g_object_unref() when no longer needed. + a #GFile. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the drive for the @mount. +This is a convenience method for getting the #GVolume and then +using that object to get the #GDrive. +The returned object should be unreffed with +g_object_unref() when no longer needed. + a #GDrive or %NULL if @mount is not associated with a volume or a drive. - - - - + + + Gets the icon for @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GIcon. + - - - - + + + Gets the name of @mount. +The returned string should be freed with g_free() +when no longer needed. + + the name for the given @mount. + - - - - + + + Gets the root directory on @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GFile. + - - - - - - - - - - - - - - - - - - + + + Gets the UUID for the @mount. The reference is typically based on +the file system UUID for the mount in question and should be +considered an opaque string. Returns %NULL if there is no UUID +available. +The returned string should be freed with g_free() +when no longer needed. + + the UUID for @mount or %NULL if no UUID can be computed. + - - - - - - - - - + + + Gets the volume for the @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GVolume or %NULL if @mount is not associated with a volume. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Tries to guess the type of content stored on @mount. Returns one or +more textual identifiers of well-known content types (typically +prefixed with "x-content/"), e.g. x-content/image-dcf for camera +memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> +specification for more on x-content types. +This is an asynchronous operation (see +g_mount_guess_content_type_sync() for the synchronous version), and +is finished by calling g_mount_guess_content_type_finish() with the - + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + optional #GCancellable object, %NULL to ignore + closure="3"> + a #GAsyncReadyCallback - - + + user data passed to @callback + - - + + + Finishes guessing content types of @mount. If any errors occured +during the operation, @error will be set to contain the errors and +%FALSE will be returned. In particular, you may get an +%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content +guessing. +Caller should free this array with g_strfreev() when done with it. + a %NULL-terminated array of content types or %NULL on error. + a #GAsyncResult + + + + + + Tries to guess the type of content stored on @mount. Returns one or +more textual identifiers of well-known content types (typically +prefixed with "x-content/"), e.g. x-content/image-dcf for camera +memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> +specification for more on x-content types. +This is an synchronous operation and as such may block doing IO; +see g_mount_guess_content_type() for the asynchronous version. +Caller should free this array with g_strfreev() when done with it. + + a %NULL-terminated array of content types or %NULL on error. + + + + + + + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + + + optional #GCancellable object, %NULL to ignore + + + + + + Remounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_remount_finish() with the @mount +and #GAsyncResults data returned in the @callback. +Remounting is useful when some setting affecting the operation +of the volume has been changed, as these may need a remount to +take affect. While this is semantically equivalent with unmounting +and then remounting not all backends might need to actually be +unmounted. + + + + + + flags affecting the operation + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes remounting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully remounted. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Unmounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_unmount_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes unmounting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Unmounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_unmount_with_operation_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the operation + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes unmounting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Checks if @mount can be eject. + + %TRUE if the @mount can be ejected. + + + + + Checks if @mount can be mounted. + + %TRUE if the @mount can be unmounted. + + + + + Ejects a mount. This is an asynchronous operation, and is +finished by calling g_mount_eject_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the unmount if required for eject + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Ejects a mount. This is an asynchronous operation, and is +finished by calling g_mount_eject_with_operation_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the unmount if required for eject + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Gets the default location of @mount. The default location of the given +the home directory, or the root of the volume). +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GFile. + + + + + Gets the drive for the @mount. +This is a convenience method for getting the #GVolume and then +using that object to get the #GDrive. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GDrive or %NULL if @mount is not associated with a volume or a drive. + + + + + Gets the icon for @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GIcon. + + + + + Gets the name of @mount. +The returned string should be freed with g_free() +when no longer needed. + + the name for the given @mount. + + + + + Gets the root directory on @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GFile. + + + + + Gets the UUID for the @mount. The reference is typically based on +the file system UUID for the mount in question and should be +considered an opaque string. Returns %NULL if there is no UUID +available. +The returned string should be freed with g_free() +when no longer needed. + + the UUID for @mount or %NULL if no UUID can be computed. + + + + + Gets the volume for the @mount. +The returned object should be unreffed with +g_object_unref() when no longer needed. + + a #GVolume or %NULL if @mount is not associated with a volume. + + + + + Tries to guess the type of content stored on @mount. Returns one or +more textual identifiers of well-known content types (typically +prefixed with "x-content/"), e.g. x-content/image-dcf for camera +memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> +specification for more on x-content types. +This is an asynchronous operation (see +g_mount_guess_content_type_sync() for the synchronous version), and +is finished by calling g_mount_guess_content_type_finish() with the + + + + + + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + + + optional #GCancellable object, %NULL to ignore + + + + a #GAsyncReadyCallback + + + + user data passed to @callback + + + + + + Finishes guessing content types of @mount. If any errors occured +during the operation, @error will be set to contain the errors and +%FALSE will be returned. In particular, you may get an +%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content +guessing. +Caller should free this array with g_strfreev() when done with it. + + a %NULL-terminated array of content types or %NULL on error. + + + + + + + a #GAsyncResult + Tries to guess the type of content stored on @mount. Returns one or +more textual identifiers of well-known content types (typically +prefixed with "x-content/"), e.g. x-content/image-dcf for camera +memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> +specification for more on x-content types. +This is an synchronous operation and as such may block doing IO; +see g_mount_guess_content_type() for the asynchronous version. +Caller should free this array with g_strfreev() when done with it. + a %NULL-terminated array of content types or %NULL on error. - + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + optional #GCancellable object, %NULL to ignore - + + Determines if @mount is shadowed. Applications or libraries should +avoid displaying @mount in the user interface if it is shadowed. +A mount is said to be shadowed if there exists one or more user +visible objects (currently #GMount objects) with a root that is +inside the root of @mount. +One application of shadow mounts is when exposing a single file +system that is used to address several logical volumes. In this +situation, a #GVolumeMonitor implementation would create two +#GVolume objects (for example, one for the camera functionality of +the device and one for a SD card reader on the device) with +activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal> +and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the +underlying mount (with root +<literal>gphoto2://[usb:001,002]/</literal>) is mounted, said +#GVolumeMonitor implementation would create two #GMount objects +(each with their root matching the corresponding volume activation +root) that would shadow the original mount. +The proxy monitor in GVfs 2.26 and later, automatically creates and +manage shadow mounts (and shadows the underlying mount) if the +activation root on a #GVolume is set. - + %TRUE if @mount is shadowed. + - - - - - - - - - - - + + Remounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_remount_finish() with the @mount +and #GAsyncResults data returned in the @callback. +Remounting is useful when some setting affecting the operation +of the volume has been changed, as these may need a remount to +take affect. While this is semantically equivalent with unmounting +and then remounting not all backends might need to actually be +unmounted. - + flags affecting the operation + + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. + closure="4"> + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + + + + + + Finishes remounting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully remounted. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Increments the shadow count on @mount. Usually used by +#GVolumeMonitor implementations when creating a shadow mount for +will need to emit the #GMount::changed signal on @mount manually. + + + + + + Unmounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_unmount_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the operation + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes unmounting a mount. If any errors occurred during the operation, + + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Unmounts a mount. This is an asynchronous operation, and is +finished by calling g_mount_unmount_with_operation_finish() with the @mount +and #GAsyncResult data returned in the @callback. + + + + + + flags affecting the operation + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + Finishes unmounting a mount. If any errors occurred during the operation, - + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + a #GAsyncResult. - + + Decrements the shadow count on @mount. Usually used by +#GVolumeMonitor implementations when destroying a shadow mount for +will need to emit the #GMount::changed signal on @mount manually. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emitted when the mount has been changed. + + - - - + + This signal is emitted when the #GMount is about to be +unmounted. + + - - + This signal is emitted when the #GMount have been +unmounted. If the recipient is holding references to the +object they should release them so the object can be +finalized. + + + glib:is-gtype-struct-for="Mount"> + Interface for implementing operations for mounts. - + @@ -15284,7 +27902,7 @@ Interface for implementing operations for mounts."> - + @@ -15296,8 +27914,9 @@ Interface for implementing operations for mounts."> - + + a #GFile. @@ -15308,8 +27927,9 @@ Interface for implementing operations for mounts."> - + + the name for the given @mount. @@ -15320,8 +27940,9 @@ Interface for implementing operations for mounts."> - + + a #GIcon. @@ -15332,8 +27953,9 @@ Interface for implementing operations for mounts."> - + + the UUID for @mount or %NULL if no UUID can be computed. @@ -15344,8 +27966,9 @@ Interface for implementing operations for mounts."> - + + a #GVolume or %NULL if @mount is not associated with a volume. @@ -15356,8 +27979,9 @@ Interface for implementing operations for mounts."> - + + a #GDrive or %NULL if @mount is not associated with a volume or a drive. @@ -15368,9 +27992,10 @@ Interface for implementing operations for mounts."> - + - + %TRUE if the @mount can be unmounted. + @@ -15380,9 +28005,10 @@ Interface for implementing operations for mounts."> - + - + %TRUE if the @mount can be ejected. + @@ -15392,7 +28018,7 @@ Interface for implementing operations for mounts."> - + @@ -15401,39 +28027,48 @@ Interface for implementing operations for mounts."> + flags affecting the operation + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + a #GAsyncResult. - + @@ -15442,39 +28077,48 @@ Interface for implementing operations for mounts."> + flags affecting the unmount if required for eject + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. - + @@ -15483,42 +28127,52 @@ Interface for implementing operations for mounts."> + flags affecting the operation + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the mount was successfully remounted. %FALSE otherwise. + + a #GAsyncResult. - + @@ -15527,27 +28181,33 @@ Interface for implementing operations for mounts."> - + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + optional #GCancellable object, %NULL to ignore - + + a #GAsyncReadyCallback - + user data passed to @callback + - + + a %NULL-terminated array of content types or %NULL on error. @@ -15557,16 +28217,16 @@ Interface for implementing operations for mounts."> + a #GAsyncResult - + + a %NULL-terminated array of content types or %NULL on error. @@ -15576,18 +28236,20 @@ Interface for implementing operations for mounts."> - + Whether to force a rescan of the content. Otherwise a cached result will be used if available + + optional #GCancellable object, %NULL to ignore - + @@ -15599,8 +28261,7 @@ Interface for implementing operations for mounts."> - + @@ -15609,44 +28270,52 @@ Interface for implementing operations for mounts."> + flags affecting the operation + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the mount was successfully unmounted. %FALSE otherwise. + + a #GAsyncResult. - + @@ -15655,45 +28324,54 @@ Interface for implementing operations for mounts."> + flags affecting the unmount if required for eject + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the mount was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. - + + a #GFile. @@ -15705,153 +28383,191 @@ Interface for implementing operations for mounts."> + Flags used when mounting a mount. + Class for providing authentication methods for mounting operations, +such as mounting a file locally, or authenticating with a server. + Creates a new mount operation. + a #GMountOperation. + + Check to see whether the mount operation is being used +for an anonymous user. + + %TRUE if mount operation is anonymous. + + + + + Gets a choice from the mount operation. +the choice's list, or %0. + + an integer containing an index of the user's choice from + + + + + Gets the domain of the mount operation. + + a string set to the domain. + + + + + Gets a password from the mount operation. + + a string containing the password within @op. + + + + + Gets the state of saving passwords for the mount operation. + + a #GPasswordSave flag. + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emits the #GMountOperation::reply signal. + a #GMountOperationResult - - + + Sets the mount operation to use an anonymous user if @anonymous is %TRUE. + + + + + + boolean value. + + + + + + Sets a default choice for the mount operation. + + + + + + an integer. + + + + + + Sets the mount operation's domain. + + + + + + the domain to set. + + + + + + Sets the mount operation's password to @password. + + + + + + password to set. + + + + + + Sets the state of saving passwords for the mount operation. + + + + + + a set of #GPasswordSave flags. + + + + + + Sets the user name within @op to @username. + + + + + + input username. + + + + + + Whether to use an anonymous user when authenticating. + - - + + The index of the user's choice when a question is asked during the +mount operation. See the #GMountOperation::ask-question signal. + - - + + The domain to use for the mount operation. + - - + + The password that is used for authentication when carrying out +the mount operation. + - - + + Determines if and how the password information should be saved. + - - + + The user name that is used for authentication when carrying out +the mount operation. + @@ -15859,66 +28575,102 @@ such as mounting a file locally, or authenticating with a server." - - - + + Emitted by the backend when e.g. a device becomes unavailable +while a mount operation is in progress. +Implementations of GMountOperation should handle this signal +by dismissing open password dialogs. + + - - + Emitted when a mount operation asks the user for a password. +If the message contains a line break, the first line should be +presented as a heading. For example, it may be used as the +primary text in a #GtkMessageDialog. + + - + string containing a message to display to the user. + - + string containing the default user name. + - + string containing the default domain. + - + a set of #GAskPasswordFlags. + - - - + + Emitted when asking the user a question and gives a list of +choices for the user to choose from. +If the message contains a line break, the first line should be +presented as a heading. For example, it may be used as the +primary text in a #GtkMessageDialog. + + - + string containing a message to display to the user. + - + an array of strings for each possible choice. + - - + Emitted when the user has replied to the mount operation. + + - + a #GMountOperationResult indicating how the request was handled + - - - + + Emitted when one or more processes are blocking an operation +e.g. unmounting/ejecting a #GMount or stopping a #GDrive. +Note that this signal may be emitted several times to update the +list of blocking processes as processes close files. The +application should only respond with g_mount_operation_reply() to +the latest signal (setting #GMountOperation:choice to the choice +the user made). +If the message contains a line break, the first line should be +presented as a heading. For example, it may be used as the +primary text in a #GtkMessageDialog. + + - + string containing a message to display to the user. + - + an array of #GPid for processes blocking the operation. + + + - + an array of strings for each possible choice. + @@ -15930,7 +28682,7 @@ such as mounting a file locally, or authenticating with a server." - + @@ -15954,7 +28706,7 @@ such as mounting a file locally, or authenticating with a server." - + @@ -15965,14 +28717,14 @@ such as mounting a file locally, or authenticating with a server." - + - + @@ -15988,7 +28740,7 @@ such as mounting a file locally, or authenticating with a server." - + @@ -16000,7 +28752,7 @@ such as mounting a file locally, or authenticating with a server." - + @@ -16012,96 +28764,97 @@ such as mounting a file locally, or authenticating with a server." - + + + - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + + #GMountOperationResult is returned as a result when a request for +information is send by the mounting operation. + Flags used when an unmounting a mount. - + - - - + + + - + @@ -16171,54 +28921,131 @@ Flags used when an unmounting a mount." + A #GSocketConnectable for resolving a hostname and connecting to +that host. - + + Creates a new #GSocketConnectable for connecting to the given - + the new #GNetworkAddress + + the hostname - + the port + - - + + + Creates a new #GSocketConnectable for connecting to the given +parsing @host_and_port fails. +address, an IPv4 address, or a domain name (in which case a DNS +lookup is performed). Quoting with [] is supported for all address +types. A port override may be specified in the usual way with a +colon. Ports may be given as decimal numbers or symbolic names (in +which case an /etc/services lookup is performed). +If no port is specified in @host_and_port then @default_port will be +used as the port number to connect to. +In general, @host_and_port is expected to be provided by the user +(allowing them to give the hostname, and a port overide if necessary) +and @default_port is expected to be provided by the application. + the new #GNetworkAddress, or %NULL on error + the hostname and optionally a port - + the default port if not in @host_and_port + + + + + + Creates a new #GSocketConnectable for connecting to the given +Using this rather than g_network_address_new() or +g_network_address_parse_host() allows #GSocketClient to determine +when to use application-specific proxy protocols. + + the new #GNetworkAddress, or %NULL on error + + + + + the hostname and optionally a port + + + + The default port if none is found in the URI + + c:identifier="g_network_address_get_hostname" + version="2.22"> + Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded, +depending on what @addr was created with. + @addr's hostname - + + Gets @addr's port number - + @addr's port (which may be 0) + - - + + Gets @addr's scheme + + @addr's scheme (%NULL if not built from URI) + + + + + - - + + + + + @@ -16234,55 +29061,115 @@ Flags used when an unmounting a mount." - + + A #GSocketConnectable for resolving a SRV record and connecting to +that service. - + + Creates a new #GNetworkService representing the given @service, +#GSocketConnectable interface to resolve it. - + a new #GNetworkService + + the service type to look up (eg, "ldap") + the networking protocol to use for @service (eg, "tcp") + the DNS domain to look up the service in - - + + + Gets the domain that @srv serves. This might be either UTF-8 or +ASCII-encoded, depending on what @srv was created with. + @srv's domain name + c:identifier="g_network_service_get_protocol" + version="2.22"> + Gets @srv's protocol name (eg, "tcp"). + @srv's protocol name - + + Get's the URI scheme used to resolve proxies. By default, the service name +is used as scheme. + @srv's scheme name - - + + Gets @srv's service name (eg, "ldap"). + + @srv's service name + + + + + Set's the URI scheme used to resolve proxies. By default, the service name +is used as scheme. + + + + + + a URI scheme + + + + + + - - + + - - + + + + + @@ -16298,230 +29185,633 @@ Flags used when an unmounting a mount." - + - + Base class for writing output. +All classes derived from GOutputStream should implement synchronous +writing, splicing, flushing and closing streams, but may implement +asynchronous versions. + + Requests an asynchronous close of the stream, releasing resources +related to it. When the operation is finished @callback will be +called. You can then call g_output_stream_close_finish() to get +the result of the operation. +For behaviour details see g_output_stream_close(). +The asyncronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. - + - - - - - + + the io priority of the request. + + optional cancellable object + + callback to call when the request is satisfied + + + + the data to pass to callback function + + - + + Closes an output stream. - + %TRUE if stream was successfully closed, %FALSE otherwise. + - - - - - - - - - - - - - - - - - - + + a #GAsyncResult. + - + + + + + + + + + + Flushed any outstanding buffers in the stream. Will block during +the operation. Closing the stream will implicitly cause a flush. +This function is optional for inherited classes. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE on success, %FALSE on error + + optional cancellable object - + + Flushes a stream asynchronously. +For behaviour details see g_output_stream_flush(). +When the operation is finished @callback will be +called. You can then call g_output_stream_flush_finish() to get the +result of the operation. - - - - - - - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + - + + Finishes flushing an output stream. - + %TRUE if flush operation suceeded, %FALSE otherwise. + + a GAsyncResult. - + + Splices an input stream into an output stream. +-1 if an error occurred. + + a #gssize containing the size of the data spliced, or + + + + + a #GInputStream. + + + + a set of #GOutputStreamSpliceFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Splices a stream asynchronously. +When the operation is finished @callback will be called. +You can then call g_output_stream_splice_finish() to get the +result of the operation. +For the synchronous, blocking version of this function, see +g_output_stream_splice(). + a #GInputStream. + a set of #GOutputStreamSpliceFlags. - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback. - + + Finishes an asynchronous stream splice operation. - + a #gssize of the number of bytes spliced. + + a #GAsyncResult. - + + Request an asynchronous write of @count bytes from @buffer into +the stream. When the operation is finished @callback will be called. +You can then call g_output_stream_write_finish() to get the result of the +operation. +During an async request no other sync and async calls are allowed, +and will result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a +%G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes written will be passed to the +requested size, as it can happen e.g. on a partial I/O error, +but generally we try to write as many bytes as requested. +You are guaranteed that this method will never fail with +%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the +method will just wait until this changes. +Any outstanding I/O request with higher priority (lower numerical +value) will be executed before an outstanding request with lower +priority. Default priority is %G_PRIORITY_DEFAULT. +The asyncronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. +For the synchronous, blocking version of this function, see +g_output_stream_write(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the buffer containing the data to write. + + + - + the number of bytes to write + + + + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. + + + + callback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes a stream write operation. + + a #gssize containing the number of bytes written to the stream. + + + + + a #GAsyncResult. + + + + + + + + + + + + + + + + + + + + + + Clears the pending flag on @stream. + + + + + + Closes the stream, releasing resources related to it. +Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED. +Closing a stream multiple times will not return an error. +Closing a stream will automatically flush any outstanding buffers in the +stream. +Streams will be automatically closed when the last reference +is dropped, but you might want to call this function to make sure +resources are released as early as possible. +Some streams might keep the backing store of the stream (e.g. a file descriptor) +open after the stream is closed. See the documentation for the individual +stream for details. +On failure the first error that happened will be reported, but the close +operation will finish as much as possible. A stream that failed to +close will still return %G_IO_ERROR_CLOSED for all operations. Still, it +is important to check and report the error to the user, otherwise +there might be a loss of data as all data might not be written. +If @cancellable is not NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +Cancelling a close will still leave the stream closed, but there some streams +can use a faster close that doesn't block to e.g. check errors. On +cancellation (as with any error) there is no guarantee that all written +data will reach the target. + + %TRUE on success, %FALSE on failure + + + + + optional cancellable object + + + + + + Requests an asynchronous close of the stream, releasing resources +related to it. When the operation is finished @callback will be +called. You can then call g_output_stream_close_finish() to get +the result of the operation. +For behaviour details see g_output_stream_close(). +The asyncronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. + + + + + + the io priority of the request. + + + + optional cancellable object + + + + callback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Closes an output stream. + + %TRUE if stream was successfully closed, %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Flushed any outstanding buffers in the stream. Will block during +the operation. Closing the stream will implicitly cause a flush. +This function is optional for inherited classes. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + %TRUE on success, %FALSE on error + + + + + optional cancellable object + + + + + + Flushes a stream asynchronously. +For behaviour details see g_output_stream_flush(). +When the operation is finished @callback will be +called. You can then call g_output_stream_flush_finish() to get the +result of the operation. + + + + + + the io priority of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to callback function + + + + + + Finishes flushing an output stream. + + %TRUE if flush operation suceeded, %FALSE otherwise. + + + + + a GAsyncResult. + + + + + + Checks if an ouput stream has pending actions. + + %TRUE if @stream has pending actions. + + + + + Checks if an output stream has already been closed. + + %TRUE if @stream is closed. %FALSE otherwise. + + + + + Checks if an output stream is being closed. This can be +used inside e.g. a flush implementation to see if the +flush (or other i/o operation) is called from within +the closing operation. + + %TRUE if @stream is being closed. %FALSE otherwise. + + + + + Sets @stream to have actions pending. If the pending flag is +already set or @stream is closed, it will return %FALSE and set + + %TRUE if pending was previously unset and is now set. + + + + + Splices an input stream into an output stream. +-1 if an error occurred. + + a #gssize containing the size of the data spliced, or + + + + + a #GInputStream. + + + + a set of #GOutputStreamSpliceFlags. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Splices a stream asynchronously. +When the operation is finished @callback will be called. +You can then call g_output_stream_splice_finish() to get the +result of the operation. +For the synchronous, blocking version of this function, see +g_output_stream_splice(). + + + + + + a #GInputStream. + + + + a set of #GOutputStreamSpliceFlags. + + + + the io priority of the request. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback. + + + + user data passed to @callback. + + + + + + Finishes an asynchronous stream splice operation. + + a #gssize of the number of bytes spliced. + + + + + a #GAsyncResult. + + + + + + Tries to write @count bytes from @buffer into the stream. Will block +during the operation. +If count is 0, returns 0 and does nothing. A value of @count +larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes written to the stream is returned. +It is not an error if this is not the same as the requested size, as it +can happen e.g. on a partial I/O error, or if there is not enough +storage in the stream. All writes block until at least one byte +is written or an error occurs; 0 is never returned (unless +If @cancellable is not NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +On error -1 is returned and @error is set accordingly. + + Number of bytes written, or -1 on error + + + + + the buffer containing the data to write. + + + + + + the number of bytes to write + + + + optional cancellable object @@ -16529,256 +29819,117 @@ asynchronous versions." + Tries to write @count bytes from @buffer into the stream. Will block +during the operation. +This function is similar to g_output_stream_write(), except it tries to +write as many bytes as requested, only stopping on an error. +On a successful write of @count bytes, %TRUE is returned, and @bytes_written +is set to @count. +If there is an error during the operation FALSE is returned and @error +is set to indicate the error status, @bytes_written is updated to contain +the number of bytes written into the stream before the error occurred. - + %TRUE on success, %FALSE if there was an error + - + the buffer containing the data to write. + + + - + the number of bytes to write + - - + + location to store the number of bytes that was written to the stream + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + optional #GCancellable object, %NULL to ignore. + Request an asynchronous write of @count bytes from @buffer into +the stream. When the operation is finished @callback will be called. +You can then call g_output_stream_write_finish() to get the result of the +operation. +During an async request no other sync and async calls are allowed, +and will result in %G_IO_ERROR_PENDING errors. +A value of @count larger than %G_MAXSSIZE will cause a +%G_IO_ERROR_INVALID_ARGUMENT error. +On success, the number of bytes written will be passed to the +requested size, as it can happen e.g. on a partial I/O error, +but generally we try to write as many bytes as requested. +You are guaranteed that this method will never fail with +%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the +method will just wait until this changes. +Any outstanding I/O request with higher priority (lower numerical +value) will be executed before an outstanding request with lower +priority. Default priority is %G_PRIORITY_DEFAULT. +The asyncronous methods have a default fallback that uses threads +to implement asynchronicity, so they are optional for inheriting +classes. However, if you override one you must override all. +For the synchronous, blocking version of this function, see +g_output_stream_write(). - + the buffer containing the data to write. + + + - + the number of bytes to write + - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. + closure="5"> + callback to call when the request is satisfied - + the data to pass to callback function + + Finishes a stream write operation. - + a #gssize containing the number of bytes written to the stream. + + a #GAsyncResult. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -16793,56 +29944,59 @@ asynchronous versions." - + - + - + - + - + - + - + a #gssize containing the size of the data spliced, or + + a #GInputStream. + a set of #GOutputStreamSpliceFlags. + optional #GCancellable object, %NULL to ignore. - + - + %TRUE on success, %FALSE on error + @@ -16851,30 +30005,29 @@ asynchronous versions." + optional cancellable object - + - + - + - + @@ -16883,45 +30036,58 @@ asynchronous versions." - + the buffer containing the data to write. + + + - + the number of bytes to write + - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + a #gssize containing the number of bytes written to the stream. + + a #GAsyncResult. - + @@ -16930,46 +30096,56 @@ asynchronous versions." + a #GInputStream. + a set of #GOutputStreamSpliceFlags. - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback. - + - + - + a #gssize of the number of bytes spliced. + + a #GAsyncResult. - + @@ -16978,39 +30154,48 @@ asynchronous versions." - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if flush operation suceeded, %FALSE otherwise. + + a GAsyncResult. - + @@ -17019,103 +30204,112 @@ asynchronous versions." - + the io priority of the request. + + optional cancellable object - + + callback to call when the request is satisfied - + the data to pass to callback function + - + - + %TRUE if stream was successfully closed, %FALSE otherwise. + + a #GAsyncResult. - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + + GOutputStreamSpliceFlags determine how streams should be spliced. - + Structure used for scatter/gather data output. You generally pass in an array of #GOutputVector<!-- -->s and the operation will use all the buffers as if they were -one buffer." - version="2.22"> +one buffer. - + - + + + + + + + + #GPasswordSave is used to indicate the lifespan of a saved password. +#Gvfs stores passwords in the Gnome keyring when this flag allows it +to, and later retrieves it again from there. - - - + + #GPermission is an opaque data structure and can only be accessed +using the following functions. + + Attempts to acquire the permission represented by @permission. +The precise method by which this happens depends on the permission +and the underlying authentication mechanism. A simple example is +that a dialog may appear asking the user to enter their password. +You should check with g_permission_get_can_acquire() before calling +this function. +If the permission is acquired then %TRUE is returned. Otherwise, +%FALSE is returned and @error is set appropriately. +This call is blocking, likely for a very long time (in the case that +user interaction is required). See g_permission_acquire_async() for +the non-blocking version. + + %TRUE if the permission was successfully acquired + + + + + a #GCancellable, or %NULL + + + + + + Attempts to acquire the permission represented by @permission. +This is the first half of the asynchronous version of +g_permission_acquire(). + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + Collects the result of attempting to acquire the permission +represented by @permission. +This is the second half of the asynchronous version of +g_permission_acquire(). + + %TRUE if the permission was successfully acquired + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + Attempts to release the permission represented by @permission. +The precise method by which this happens depends on the permission +and the underlying authentication mechanism. In most cases the +permission will be dropped immediately without further action. +You should check with g_permission_get_can_release() before calling +this function. +If the permission is released then %TRUE is returned. Otherwise, +%FALSE is returned and @error is set appropriately. +This call is blocking, likely for a very long time (in the case that +user interaction is required). See g_permission_release_async() for +the non-blocking version. + + %TRUE if the permission was successfully released + + + + + a #GCancellable, or %NULL + + + + + + Attempts to release the permission represented by @permission. +This is the first half of the asynchronous version of +g_permission_release(). + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + Collects the result of attempting to release the permission +represented by @permission. +This is the second half of the asynchronous version of +g_permission_release(). + + %TRUE if the permission was successfully released + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + Attempts to acquire the permission represented by @permission. +The precise method by which this happens depends on the permission +and the underlying authentication mechanism. A simple example is +that a dialog may appear asking the user to enter their password. +You should check with g_permission_get_can_acquire() before calling +this function. +If the permission is acquired then %TRUE is returned. Otherwise, +%FALSE is returned and @error is set appropriately. +This call is blocking, likely for a very long time (in the case that +user interaction is required). See g_permission_acquire_async() for +the non-blocking version. + + %TRUE if the permission was successfully acquired + + + + + a #GCancellable, or %NULL + + + + + + Attempts to acquire the permission represented by @permission. +This is the first half of the asynchronous version of +g_permission_acquire(). + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + Collects the result of attempting to acquire the permission +represented by @permission. +This is the second half of the asynchronous version of +g_permission_acquire(). + + %TRUE if the permission was successfully acquired + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + Gets the value of the 'allowed' property. This property is %TRUE if +the caller currently has permission to perform the action that + + the value of the 'allowed' property + + + + + Gets the value of the 'can-acquire' property. This property is %TRUE +if it is generally possible to acquire the permission by calling +g_permission_acquire(). + + the value of the 'can-acquire' property + + + + + Gets the value of the 'can-release' property. This property is %TRUE +if it is generally possible to release the permission by calling +g_permission_release(). + + the value of the 'can-release' property + + + + + This function is called by the #GPermission implementation to update +the properties of the permission. You should never call this +function except from a #GPermission implementation. +GObject notify signals are generated, as appropriate. + + + + + + the new value for the 'allowed' property + + + + the new value for the 'can-acquire' property + + + + the new value for the 'can-release' property + + + + + + Attempts to release the permission represented by @permission. +The precise method by which this happens depends on the permission +and the underlying authentication mechanism. In most cases the +permission will be dropped immediately without further action. +You should check with g_permission_get_can_release() before calling +this function. +If the permission is released then %TRUE is returned. Otherwise, +%FALSE is returned and @error is set appropriately. +This call is blocking, likely for a very long time (in the case that +user interaction is required). See g_permission_release_async() for +the non-blocking version. + + %TRUE if the permission was successfully released + + + + + a #GCancellable, or %NULL + + + + + + Attempts to release the permission represented by @permission. +This is the first half of the asynchronous version of +g_permission_release(). + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + Collects the result of attempting to release the permission +represented by @permission. +This is the second half of the asynchronous version of +g_permission_release(). + + %TRUE if the permission was successfully released + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + %TRUE if the caller currently has permission to perform the action that + + + + %TRUE if it is generally possible to acquire the permission by calling +g_permission_acquire(). + + + + %TRUE if it is generally possible to release the permission by calling +g_permission_release(). + + + + + + + + + + + + + + + + + %TRUE if the permission was successfully acquired + + + + + + + + a #GCancellable, or %NULL + + + + + + + + + + + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + + + + %TRUE if the permission was successfully acquired + + + + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + + + + %TRUE if the permission was successfully released + + + + + + + + a #GCancellable, or %NULL + + + + + + + + + + + + + + + + a #GCancellable, or %NULL + + + + the #GAsyncReadyCallback to call when done + + + + the user data to pass to @callback + + + + + + + + + %TRUE if the permission was successfully released + + + + + + + + the #GAsyncResult given to the #GAsyncReadyCallback + + + + + + + + + + + + + + + Interface that handles proxy connection and payload. + + Given @connection to communicate with a proxy (eg, a +#GSocketConnection that is connected to the proxy server), this +does the necessary handshake to connect to @proxy_address, and if +required, wraps the #GIOStream to handle proxy payload. +be the same as @connection, in which case a reference +will be added. + + a #GIOStream that will replace @connection. This might + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + + + Asynchronous version of g_proxy_connect(). + + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + a #GAsyncReadyCallback + + + + callback data + + + + + + See g_proxy_connect(). + + a #GIOStream. + + + + + a #GAsyncRetult + + + + + + Some proxy protocols expect to be passed a hostname, which they +will resolve to an IP address themselves. Others, like SOCKS4, do +not allow this. This function will return %FALSE if @proxy is +implementing such a protocol. When %FALSE is returned, the caller +should resolve the destination hostname first, and then pass a +#GProxyAddress containing the stringified IP address to +g_proxy_connect() or g_proxy_connect_async(). + + %TRUE if hostname resolution is supported. + + + + + Given @connection to communicate with a proxy (eg, a +#GSocketConnection that is connected to the proxy server), this +does the necessary handshake to connect to @proxy_address, and if +required, wraps the #GIOStream to handle proxy payload. +be the same as @connection, in which case a reference +will be added. + + a #GIOStream that will replace @connection. This might + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + + + Asynchronous version of g_proxy_connect(). + + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + a #GAsyncReadyCallback + + + + callback data + + + + + + See g_proxy_connect(). + + a #GIOStream. + + + + + a #GAsyncRetult + + + + + + Some proxy protocols expect to be passed a hostname, which they +will resolve to an IP address themselves. Others, like SOCKS4, do +not allow this. This function will return %FALSE if @proxy is +implementing such a protocol. When %FALSE is returned, the caller +should resolve the destination hostname first, and then pass a +#GProxyAddress containing the stringified IP address to +g_proxy_connect() or g_proxy_connect_async(). + + %TRUE if hostname resolution is supported. + + + + + + A #GInetSocketAddress representing a connection via a proxy server + + + Creates a new #GProxyAddress for @inetaddr with @protocol that should +tunnel through @dest_hostname and @dest_port. + + a new #GProxyAddress + + + + + The proxy server #GInetAddress. + + + + The proxy server port. + + + + The proxy protocol to support, in lower case (e.g. socks, http). + + + + The destination hostname the the proxy should tunnel to. + + + + The destination port to tunnel to. + + + + The username to authenticate to the proxy server (or %NULL). + + + + The password to authenticate to the proxy server (or %NULL). + + + + + + + + + + + + + + + + + + + + + Gets @proxy's protocol. + + the @proxy's protocol + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A subclass of #GSocketAddressEnumerator that takes another address +enumerator and wraps its results in #GProxyAddress<!-- -->es as +directed by the default #GProxyResolver. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Provides an interface for handling proxy connection and payload. + + + + + + + a #GIOStream that will replace @connection. This might + + + + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + + + + + + + + + + + + + a #GIOStream + + + + a #GProxyAddress + + + + a #GCancellable + + + + a #GAsyncReadyCallback + + + + callback data + + + + + + + + + a #GIOStream. + + + + + + + + a #GAsyncRetult + + + + + + + + + %TRUE if hostname resolution is supported. + + + + + + + + + + + + Interface that can be used to resolve proxy address. + + Checks if @resolver can be used on this system. (This is used +internally; g_proxy_resolver_get_default() will only return a proxy +resolver that returns %TRUE for this method.) + + %TRUE if @resolver is supported. + + + + + Looks into the system proxy configuration to determine what proxy, +if any, to use to connect to @uri. The returned proxy URIs are of the +form <literal>&lt;protocol&gt;://[user[:password]@]host:port</literal> +or <literal>direct://</literal>, where &lt;protocol&gt; could be +http, rtsp, socks or other proxying protocol. +If you don't know what network protocol is being used on the +socket, you should use <literal>none</literal> as the URI protocol. +In this case, the resolver might still return a generic proxy type +(such as SOCKS), but would not return protocol-specific proxy types +(such as http). +<literal>direct://</literal> is used when no proxy is needed. +Direct connection should not be attempted unless it is part of the +returned array of proxies. +g_strfreev(). + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + + + Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more +details. + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + Call this function to obtain the array of proxy URIs when +g_proxy_resolver_lookup_async() is complete. See +g_proxy_resolver_lookup() for more details. +g_strfreev(). + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + the result passed to your #GAsyncReadyCallback + + + + + + Checks if @resolver can be used on this system. (This is used +internally; g_proxy_resolver_get_default() will only return a proxy +resolver that returns %TRUE for this method.) + + %TRUE if @resolver is supported. + + + + + Looks into the system proxy configuration to determine what proxy, +if any, to use to connect to @uri. The returned proxy URIs are of the +form <literal>&lt;protocol&gt;://[user[:password]@]host:port</literal> +or <literal>direct://</literal>, where &lt;protocol&gt; could be +http, rtsp, socks or other proxying protocol. +If you don't know what network protocol is being used on the +socket, you should use <literal>none</literal> as the URI protocol. +In this case, the resolver might still return a generic proxy type +(such as SOCKS), but would not return protocol-specific proxy types +(such as http). +<literal>direct://</literal> is used when no proxy is needed. +Direct connection should not be attempted unless it is part of the +returned array of proxies. +g_strfreev(). + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + + + Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more +details. + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + Call this function to obtain the array of proxy URIs when +g_proxy_resolver_lookup_async() is complete. See +g_proxy_resolver_lookup() for more details. +g_strfreev(). + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + the result passed to your #GAsyncReadyCallback + + + + + + + + + + + + + %TRUE if @resolver is supported. + + + + + + + + + + + + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + + + + + + + + + + + + + a URI representing the destination to connect to + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + + + + A NULL-terminated array of proxy URIs. Must be freed with + + + + + + + + + + the result passed to your #GAsyncReadyCallback + + + + + + + + Changes the size of the memory block pointed to by @data to +The function should have the same semantics as realloc(). + + a pointer to the reallocated memory + - + memory block to reallocate + - + size to reallocate @data to + - - - - - - + The object that handles DNS resolution. Use g_resolver_get_default() +to get the default resolver. + + Frees @addresses (which should be the return value from +g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()). +(This is a convenience method; you can also simply free the results +by hand.) - + a #GList of #GInetAddress + + + - + + Frees @targets (which should be the return value from +g_resolver_lookup_service() or g_resolver_lookup_service_finish()). +(This is a convenience method; you can also simply free the +results by hand.) - + a #GList of #GSrvTarget + + + - + + Gets the default #GResolver. You should unref it when you are done +with it. #GResolver may use its reference count as a hint about how +many threads/processes, etc it should allocate for concurrent DNS +resolutions. - + the default #GResolver. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Synchronously reverse-resolves @address to determine its +associated hostname. +If the DNS resolution fails, @error (if non-%NULL) will be set to +a value from #GResolverError. +If @cancellable is non-%NULL, it can be used to cancel the +operation, in which case @error (if non-%NULL) will be set to +%G_IO_ERROR_CANCELLED. +form), or %NULL on error. + a hostname (either ASCII-only, or in ASCII-encoded + the address to reverse-resolve + a #GCancellable, or %NULL + invoker="lookup_by_address_async" + version="2.22"> + Begins asynchronously reverse-resolving @address to determine its +associated hostname, and eventually calls @callback, which must +call g_resolver_lookup_by_address_finish() to get the final result. + the address to reverse-resolve + a #GCancellable, or %NULL - + + callback to call after resolution completes - - + + data for @callback + + Retrieves the result of a previous call to +g_resolver_lookup_by_address_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +form), or %NULL on error. + a hostname (either ASCII-only, or in ASCII-encoded + the result passed to your #GAsyncReadyCallback - + + Synchronously resolves @hostname to determine its associated IP +address(es). @hostname may be an ASCII-only or UTF-8 hostname, or +the textual form of an IP address (in which case this just becomes +a wrapper around g_inet_address_new_from_string()). +On success, g_resolver_lookup_by_name() will return a #GList of +#GInetAddress, sorted in order of preference. (That is, you should +attempt to connect to the first address first, then the second if +the first fails, etc.) +If the DNS resolution fails, @error (if non-%NULL) will be set to a +value from #GResolverError. +If @cancellable is non-%NULL, it can be used to cancel the +operation, in which case @error (if non-%NULL) will be set to +%G_IO_ERROR_CANCELLED. +If you are planning to connect to a socket on the resolved IP +address, it may be easier to create a #GNetworkAddress and use its +#GSocketConnectable interface. +of #GInetAddress, or %NULL on error. You +must unref each of the addresses and free the list when you are +done with it. (You can use g_resolver_free_addresses() to do this.) - + a #GList + + + - + + the hostname to look up + a #GCancellable, or %NULL + + + + + + Begins asynchronously resolving @hostname to determine its +associated IP address(es), and eventually calls @callback, which +must call g_resolver_lookup_by_name_finish() to get the result. +See g_resolver_lookup_by_name() for more details. + + + + + + the hostname to look up the address of + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + Retrieves the result of a call to +g_resolver_lookup_by_name_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() +for more details. + + a #GList + + + + + + + the result passed to your #GAsyncReadyCallback + + + + + + + + + + + + + + + @@ -17335,210 +32010,348 @@ The function should have the same semantics as realloc()."> - + - + - - + + + Retrieves the result of a previous call to +g_resolver_lookup_service_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +or %NULL on error. See g_resolver_lookup_service() for more details. - + a #GList of #GSrvTarget, + + + + the result passed to your #GAsyncReadyCallback - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Synchronously reverse-resolves @address to determine its +associated hostname. +If the DNS resolution fails, @error (if non-%NULL) will be set to +a value from #GResolverError. +If @cancellable is non-%NULL, it can be used to cancel the +operation, in which case @error (if non-%NULL) will be set to +%G_IO_ERROR_CANCELLED. +form), or %NULL on error. + a hostname (either ASCII-only, or in ASCII-encoded + the address to reverse-resolve + a #GCancellable, or %NULL + c:identifier="g_resolver_lookup_by_address_async" + version="2.22"> + Begins asynchronously reverse-resolving @address to determine its +associated hostname, and eventually calls @callback, which must +call g_resolver_lookup_by_address_finish() to get the final result. + the address to reverse-resolve + a #GCancellable, or %NULL + closure="3"> + callback to call after resolution completes - + data for @callback + + Retrieves the result of a previous call to +g_resolver_lookup_by_address_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +form), or %NULL on error. + a hostname (either ASCII-only, or in ASCII-encoded + the result passed to your #GAsyncReadyCallback + + + + + + Synchronously resolves @hostname to determine its associated IP +address(es). @hostname may be an ASCII-only or UTF-8 hostname, or +the textual form of an IP address (in which case this just becomes +a wrapper around g_inet_address_new_from_string()). +On success, g_resolver_lookup_by_name() will return a #GList of +#GInetAddress, sorted in order of preference. (That is, you should +attempt to connect to the first address first, then the second if +the first fails, etc.) +If the DNS resolution fails, @error (if non-%NULL) will be set to a +value from #GResolverError. +If @cancellable is non-%NULL, it can be used to cancel the +operation, in which case @error (if non-%NULL) will be set to +%G_IO_ERROR_CANCELLED. +If you are planning to connect to a socket on the resolved IP +address, it may be easier to create a #GNetworkAddress and use its +#GSocketConnectable interface. +of #GInetAddress, or %NULL on error. You +must unref each of the addresses and free the list when you are +done with it. (You can use g_resolver_free_addresses() to do this.) + + a #GList + + + + + + + the hostname to look up + + + + a #GCancellable, or %NULL + + + + + + Begins asynchronously resolving @hostname to determine its +associated IP address(es), and eventually calls @callback, which +must call g_resolver_lookup_by_name_finish() to get the result. +See g_resolver_lookup_by_name() for more details. + + + + + + the hostname to look up the address of + + + + a #GCancellable, or %NULL + + + + callback to call after resolution completes + + + + data for @callback + + + + + + Retrieves the result of a call to +g_resolver_lookup_by_name_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name() +for more details. + + a #GList + + + + + + + the result passed to your #GAsyncReadyCallback + Synchronously performs a DNS SRV lookup for the given @service and +include the leading underscore that appears in the actual DNS +entry. +On success, g_resolver_lookup_service() will return a #GList of +#GSrvTarget, sorted in order of preference. (That is, you should +attempt to connect to the first target first, then the second if +the first fails, etc.) +If the DNS resolution fails, @error (if non-%NULL) will be set to +a value from #GResolverError. +If @cancellable is non-%NULL, it can be used to cancel the +operation, in which case @error (if non-%NULL) will be set to +%G_IO_ERROR_CANCELLED. +If you are planning to connect to the service, it is usually easier +to create a #GNetworkService and use its #GSocketConnectable +interface. +or %NULL on error. You must free each of the targets and the list when you are +done with it. (You can use g_resolver_free_targets() to do this.) - + a #GList of #GSrvTarget, + + + + the service type to look up (eg, "ldap") + the networking protocol to use for @service (eg, "tcp") + the DNS domain to look up the service in + a #GCancellable, or %NULL + c:identifier="g_resolver_lookup_service_async" + version="2.22"> + Begins asynchronously performing a DNS SRV lookup for the given +get the final result. See g_resolver_lookup_service() for more +details. + the service type to look up (eg, "ldap") + the networking protocol to use for @service (eg, "tcp") + the DNS domain to look up the service in + a #GCancellable, or %NULL + closure="5"> + callback to call after resolution completes - + data for @callback + + Retrieves the result of a previous call to +g_resolver_lookup_service_async(). +If the DNS resolution failed, @error (if non-%NULL) will be set to +a value from #GResolverError. If the operation was cancelled, +or %NULL on error. See g_resolver_lookup_service() for more details. - + a #GList of #GSrvTarget, + + + + the result passed to your #GAsyncReadyCallback + + Sets @resolver to be the application's default resolver (reffing +Future calls to g_resolver_get_default() will return this resolver. +This can be used if an application wants to perform any sort of DNS +caching or "pinning"; it can implement its own #GResolver that +calls the original default resolver for DNS operations, and +implements its own cache policies on top of that, and then set +itself as the default resolver for all later code to use. + + + + @@ -17546,8 +32359,10 @@ The function should have the same semantics as realloc()."> - - + Emitted when the resolver notices that the system resolver +configuration has changed. + + @@ -17558,7 +32373,7 @@ The function should have the same semantics as realloc()."> - + @@ -17570,27 +32385,32 @@ The function should have the same semantics as realloc()."> - + - + a #GList + + + + the hostname to look up + a #GCancellable, or %NULL - + @@ -17599,44 +32419,52 @@ The function should have the same semantics as realloc()."> + the hostname to look up the address of + a #GCancellable, or %NULL - + + callback to call after resolution completes - + data for @callback + - + - + a #GList + + + + the result passed to your #GAsyncReadyCallback - + + a hostname (either ASCII-only, or in ASCII-encoded @@ -17644,19 +32472,20 @@ The function should have the same semantics as realloc()."> + the address to reverse-resolve + a #GCancellable, or %NULL - + @@ -17665,27 +32494,33 @@ The function should have the same semantics as realloc()."> + the address to reverse-resolve + a #GCancellable, or %NULL - + + callback to call after resolution completes - + data for @callback + - + + a hostname (either ASCII-only, or in ASCII-encoded @@ -17693,15 +32528,18 @@ The function should have the same semantics as realloc()."> + the result passed to your #GAsyncReadyCallback - - - - + + + + + + @@ -17710,16 +32548,14 @@ The function should have the same semantics as realloc()."> - + - + @@ -17730,74 +32566,77 @@ The function should have the same semantics as realloc()."> - + - + - + - + - + a #GList of #GSrvTarget, + + + + the result passed to your #GAsyncReadyCallback - - + + - - + + - - + + - - + + - - + + - - + + @@ -17805,15 +32644,13 @@ The function should have the same semantics as realloc()."> + An error code used with %G_RESOLVER_ERROR in a #GError returned +from a #GResolver routine. - + + + + - - - + Seek object for streaming operations. + + Tests if the stream supports the #GSeekableIface. + + %TRUE if @seekable can be seeked. %FALSE otherwise. + - + + Tests if the stream can be truncated. - + %TRUE if the stream can be truncated, %FALSE otherwise. + + Seeks in the stream by the given @offset, modified by @type. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + - + a #goffset. + + a #GSeekType. + optional #GCancellable object, %NULL to ignore. - + + Tells the current position within the stream. - + the offset from the beginning of the buffer. + - + + Truncates a stream with a given #offset. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + - + a #goffset. + + optional #GCancellable object, %NULL to ignore. - - - + + Tests if the stream supports the #GSeekableIface. + + %TRUE if @seekable can be seeked. %FALSE otherwise. + - + + Tests if the stream can be truncated. - + %TRUE if the stream can be truncated, %FALSE otherwise. + + Seeks in the stream by the given @offset, modified by @type. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + - + a #goffset. + + a #GSeekType. + optional #GCancellable object, %NULL to ignore. - + + Tells the current position within the stream. - + the offset from the beginning of the buffer. + + Truncates a stream with a given #offset. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an +operation was partially finished when the operation was cancelled the +partial result will be returned, without an error. +has occurred, this function will return %FALSE and set @error +appropriately if present. - + %TRUE if successful. If an error + - + a #goffset. + + optional #GCancellable object, %NULL to ignore. @@ -17934,15 +32830,16 @@ from a #GResolver routine." + glib:is-gtype-struct-for="Seekable"> + Provides an interface for implementing seekable functionality on I/O Streams. - - - + + + the offset from the beginning of the buffer. + @@ -17952,9 +32849,10 @@ from a #GResolver routine." - + - + %TRUE if @seekable can be seeked. %FALSE otherwise. + @@ -17964,32 +32862,37 @@ from a #GResolver routine." - + - + %TRUE if successful. If an error + - + a #goffset. + + a #GSeekType. + optional #GCancellable object, %NULL to ignore. - + - + %TRUE if the stream can be truncated, %FALSE otherwise. + @@ -17999,81 +32902,1961 @@ from a #GResolver routine." - + - + %TRUE if successful. If an error + - + a #goffset. + + optional #GCancellable object, %NULL to ignore. + + + Creates a new #GSettings object with a given schema. +Signals on the newly created #GSettings object will be dispatched +via the thread-default #GMainContext in effect at the time of the +call to g_settings_new(). The new #GSettings will hold a reference +on the context. See g_main_context_push_thread_default(). + + a new #GSettings object + + + + + the name of the schema + + + + + + Creates a new #GSettings object with a given schema and backend. +Creating settings objects with an different backend allows accessing settings +from a database other than the usual one. For example, it may make +sense to pass a backend corresponding to the "defaults" settings database on +the system to get a settings object that modifies the system default +settings instead of the settings for this user. + + a new #GSettings object + + + + + the name of the schema + + + + the #GSettingsBackend to use + + + + + + Creates a new #GSettings object with a given schema, backend and +path. +This is a mix of g_settings_new_with_backend() and +g_settings_new_with_path(). + + a new #GSettings object + + + + + the name of the schema + + + + the #GSettingsBackend to use + + + + the path to use + + + + + + Creates a new #GSettings object with a given schema and path. +You only need to do this if you want to directly create a settings +object with a schema that doesn't have a specified path of its own. +That's quite rare. +It is a programmer error to call this function for a schema that +has an explicitly specified path. + + a new #GSettings object + + + + + the name of the schema + + + + the path to use + + + + + + must not be modified or freed. + + a list of GSettings schemas that are available. The list + + + + + + + Ensures that all pending operations for the given are complete for +the default backend. +Writes made to a #GSettings are handled asynchronously. For this +reason, it is very unlikely that the changes have it to disk by the +time g_settings_set() returns. +This call will block until all of the writes have made it to the +backend. Since the mainloop is not running, no change notifications +will be dispatched during this call (but some may be queued by the +time the call is done). + + + + + + Removes an existing binding for @property on @object. +Note that bindings are automatically removed when the +object is finalized, so it is rarely necessary to call this +function. + + + + + + the object + + + + the property whose binding is removed + + + + + + Applies any changes that have been made to the settings. This +function does nothing unless @settings is in 'delay-apply' mode; +see g_settings_delay(). In the normal case settings are always +applied immediately. + + + + + + Create a binding between the @key in the @settings object +and the property @property of @object. +The binding uses the default GIO mapping functions to map +between the settings and property values. These functions +handle booleans, numeric types and string types in a +straightforward way. Use g_settings_bind_with_mapping() if +you need a custom mapping, or map between types that are not +supported by the default mapping functions. +Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this +function also establishes a binding between the writability of +a boolean property by that name). See g_settings_bind_writable() +for more details about writable bindings. +Note that the lifecycle of the binding is tied to the object, +and that you can have only one binding per object property. +If you bind the same property twice on the same object, the second +binding overrides the first one. + + + + + + the key to bind + + + + a #GObject + + + + the name of the property to bind + + + + flags for the binding + + + + + + Create a binding between the @key in the @settings object +and the property @property of @object. +The binding uses the provided mapping functions to map between +settings and property values. +Note that the lifecycle of the binding is tied to the object, +and that you can have only one binding per object property. +If you bind the same property twice on the same object, the second +binding overrides the first one. + + + + + + the key to bind + + + + a #GObject + + + + the name of the property to bind + + + + flags for the binding + + + + a function that gets called to convert values from @settings to @object, or %NULL to use the default GIO mapping + + + + a function that gets called to convert values from @object to @settings, or %NULL to use the default GIO mapping + + + + data that gets passed to @get_mapping and @set_mapping + + + + #GDestroyNotify function for @user_data + + + + + + Create a binding between the writability of @key in the +The property must be boolean; "sensitive" or "visible" +properties of widgets are the most likely candidates. +Writable bindings are always uni-directional; changes of the +writability of the setting will be propagated to the object +property, not the other way. +When the @inverted argument is %TRUE, the binding inverts the +value as it passes from the setting to the object, i.e. @property +will be set to %TRUE if the key is <emphasis>not</emphasis> +writable. +Note that the lifecycle of the binding is tied to the object, +and that you can have only one binding per object property. +If you bind the same property twice on the same object, the second +binding overrides the first one. + + + + + + the key to bind + + + + a #GObject + + + + the name of a boolean property to bind + + + + whether to 'invert' the value + + + + + + Changes the #GSettings object into 'delay-apply' mode. In this +mode, changes to @settings are not immediately propagated to the +backend, but kept locally until g_settings_apply() is called. + + + + + + Gets the value that is stored at @key in @settings. +A convenience function that combines g_settings_get_value() with +g_variant_get(). +It is a programmer error to give a @key that isn't contained in the +schema for @settings or for the #GVariantType of @format to mismatch +the type given in the schema. + + + + + + the key to get the value for + + + + a #GVariant format string + + + + + + + + + + Gets the value that is stored at @key in @settings. +A convenience variant of g_settings_get() for booleans. +It is a programmer error to give a @key that isn't specified as +having a boolean type in the schema for @settings. + + a boolean + + + + + the key to get the value for + + + + + + Creates a 'child' settings object which has a base path of +<replaceable>base-path</replaceable>/@name", where +<replaceable>base-path</replaceable> is the base path of @settings. +The schema for the child settings object must have been declared +in the schema of @settings using a <tag class="starttag">child</tag> element. + + a 'child' settings object + + + + + the name of the 'child' schema + + + + + + Gets the value that is stored at @key in @settings. +A convenience variant of g_settings_get() for doubles. +It is a programmer error to give a @key that isn't specified as +having a 'double' type in the schema for @settings. + + a double + + + + + the key to get the value for + + + + + + Gets the value that is stored in @settings for @key and converts it +to the enum value that it represents. +In order to use this function the type of the value must be a string +and it must be marked in the schema file as an enumerated type. +It is a programmer error to give a @key that isn't contained in the +schema for @settings or is not marked as an enumerated type. +If the value stored in the configuration database is not a valid +value for the enumerated type then this function will return the +default value. + + the enum value + + + + + the key to get the value for + + + + + + Gets the value that is stored in @settings for @key and converts it +to the flags value that it represents. +In order to use this function the type of the value must be an array +of strings and it must be marked in the schema file as an flags type. +It is a programmer error to give a @key that isn't contained in the +schema for @settings or is not marked as a flags type. +If the value stored in the configuration database is not a valid +value for the flags type then this function will return the default +value. + + the flags value + + + + + the key to get the value for + + + + + + Returns whether the #GSettings object has any unapplied +changes. This can only be the case if it is in 'delayed-apply' mode. + + %TRUE if @settings has unapplied changes + + + + + Gets the value that is stored at @key in @settings. +A convenience variant of g_settings_get() for 32-bit integers. +It is a programmer error to give a @key that isn't specified as +having a int32 type in the schema for @settings. + + an integer + + + + + the key to get the value for + + + + + + Gets the value that is stored at @key in @settings, subject to +application-level validation/mapping. +You should use this function when the application needs to perform +some processing on the value of the key (for example, parsing). The +indicates that the processing was unsuccessful (due to a parse error, +for example) then the mapping is tried again with another value. +This allows a robust 'fall back to defaults' behaviour to be +implemented somewhat automatically. +The first value that is tried is the user's setting for the key. If +the mapping function fails to map this value, other values may be +tried in an unspecified order (system or site defaults, translated +schema default values, untranslated schema default values, etc). +If the mapping function fails for all possible values, one additional +If the mapping function still indicates failure at this point then +the application will be aborted. +The result parameter for the @mapping function is pointed to a +#gpointer which is initially set to %NULL. The same pointer is given +to each invocation of @mapping. The final value of that #gpointer is +what is returned by this function. %NULL is valid; it is returned +just as any other value would be. + + the result, which may be %NULL + + + + + the key to get the value for + + + + the function to map the value in the settings database to the value used by the application + + + + user data for @mapping + + + + + + Gets the value that is stored at @key in @settings. +A convenience variant of g_settings_get() for strings. +It is a programmer error to give a @key that isn't specified as +having a string type in the schema for @settings. + + a newly-allocated string + + + + + the key to get the value for + + + + + + A convenience variant of g_settings_get() for string arrays. +It is a programmer error to give a @key that isn't specified as +having an array of strings type in the schema for @settings. +stored at @key in @settings. + + the value that is + + + + + + + the key to get the value for + + + + + + Gets the value that is stored in @settings for @key. +It is a programmer error to give a @key that isn't contained in the +schema for @settings. + + a new #GVariant + + + + + the key to get the value for + + + + + + Finds out if a key can be written or not + + %TRUE if the key @name is writable + + + + + the name of a key + + + + + + Gets the list of children on @settings. +The list is exactly the list of strings for which it is not an error +to call g_settings_get_child(). +For GSettings objects that are lists, this value can change at any +time and you should connect to the "children-changed" signal to watch +request a child after listing it only for it to have been destroyed +in the meantime. For this reason, g_settings_get_chuld() may return +%NULL even for a child that was listed by this function. +For GSettings objects that are not lists, you should probably not be +calling this function from "normal" code (since you should already +know what children are in your schema). This function may still be +useful there for introspection reasons, however. +You should free the return value with g_strfreev() when you are done +with it. + + a list of the children on @settings + + + + + + + Introspects the list of keys on @settings. +You should probably not be calling this function from "normal" code +(since you should already know what keys are in your schema). This +function is intended for introspection reasons. +You should free the return value with g_strfreev() when you are done +with it. + + a list of the keys on @settings + + + + + + + Resets @key to its default value. +This call resets the key, as much as possible, to its default value. +That might the value specified in the schema or the one set by the +administrator. + + + + + + the name of a key + + + + + + Reverts all non-applied changes to the settings. This function +does nothing unless @settings is in 'delay-apply' mode; see +g_settings_delay(). In the normal case settings are always applied +immediately. +Change notifications will be emitted for affected keys. + + + + + + Sets @key in @settings to @value. +A convenience function that combines g_settings_set_value() with +g_variant_new(). +It is a programmer error to give a @key that isn't contained in the +schema for @settings or for the #GVariantType of @format to mismatch +the type given in the schema. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + a #GVariant format string + + + + + + + + + + Sets @key in @settings to @value. +A convenience variant of g_settings_set() for booleans. +It is a programmer error to give a @key that isn't specified as +having a boolean type in the schema for @settings. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + the value to set it to + + + + + + Sets @key in @settings to @value. +A convenience variant of g_settings_set() for doubles. +It is a programmer error to give a @key that isn't specified as +having a 'double' type in the schema for @settings. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + the value to set it to + + + + + + Looks up the enumerated type nick for @value and writes it to @key, +within @settings. +It is a programmer error to give a @key that isn't contained in the +schema for @settings or is not marked as an enumerated type, or for +After performing the write, accessing @key directly with +g_settings_get_string() will return the 'nick' associated with + + %TRUE, if the set succeeds + + + + + a key, within @settings + + + + an enumerated value + + + + + + Looks up the flags type nicks for the bits specified by @value, puts +them in an array of strings and writes the array to @key, withing +It is a programmer error to give a @key that isn't contained in the +schema for @settings or is not marked as a flags type, or for @value +to contain any bits that are not value for the named type. +After performing the write, accessing @key directly with +g_settings_get_strv() will return an array of 'nicks'; one for each +bit in @value. + + %TRUE, if the set succeeds + + + + + a key, within @settings + + + + a flags value + + + + + + Sets @key in @settings to @value. +A convenience variant of g_settings_set() for 32-bit integers. +It is a programmer error to give a @key that isn't specified as +having a int32 type in the schema for @settings. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + the value to set it to + + + + + + Sets @key in @settings to @value. +A convenience variant of g_settings_set() for strings. +It is a programmer error to give a @key that isn't specified as +having a string type in the schema for @settings. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + the value to set it to + + + + + + Sets @key in @settings to @value. +A convenience variant of g_settings_set() for string arrays. If +It is a programmer error to give a @key that isn't specified as +having an array of strings type in the schema for @settings. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + the value to set it to, or %NULL + + + + + + + + Sets @key in @settings to @value. +It is a programmer error to give a @key that isn't contained in the +schema for @settings or for @value to have the incorrect type, per +the schema. +If @value is floating then this function consumes the reference. + + %TRUE if setting the key succeeded, %FALSE if the key was not writable + + + + + the name of the key to set + + + + a #GVariant of the correct type + + + + + + + + + If this property is %TRUE, the #GSettings object has outstanding +changes that will be applied when g_settings_apply() is called. + + + + The path within the backend where the settings are stored. + + + + The name of the schema that describes the types of keys +for this #GSettings object. + + + + + + + + + + The "change-event" signal is emitted once per change event that +affects this settings object. You should connect to this signal +only if you are interested in viewing groups of changes before they +are split out into multiple emissions of the "changed" signal. +For most use cases it is more appropriate to use the "changed" signal. +In the event that the change event applies to one or more specified +keys, @keys will be an array of #GQuark of length @n_keys. In the +event that the change event applies to the #GSettings object as a +be %NULL and @n_keys will be 0. +The default handler for this signal invokes the "changed" signal +for each affected key. If any other connected handler returns +%TRUE then this default functionality will be supressed. + + %TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. + + + + + an array of #GQuark<!-- -->s for the changed keys, or %NULL + + + + the length of the @keys array, or 0 + + + + + + The "changed" signal is emitted when a key has potentially changed. +You should call one of the g_settings_get() calls to check the new +value. +This signal supports detailed connections. You can connect to the +detailed signal "changed::x" in order to only receive callbacks +when key "x" changes. + + + + + + the name of the key that changed + + + + + + The "writable-change-event" signal is emitted once per writability +change event that affects this settings object. You should connect +to this signal if you are interested in viewing groups of changes +before they are split out into multiple emissions of the +"writable-changed" signal. For most use cases it is more +appropriate to use the "writable-changed" signal. +In the event that the writability change applies only to a single +key, @key will be set to the #GQuark for that key. In the event +that the writability change affects the entire settings object, +The default handler for this signal invokes the "writable-changed" +and "changed" signals for each affected key. This is done because +changes in writability might also imply changes in value (if for +example, a new mandatory setting is introduced). If any other +connected handler returns %TRUE then this default functionality +will be supressed. + + %TRUE to stop other handlers from being invoked for the event. FALSE to propagate the event further. + + + + + the quark of the key, or 0 + + + + + + The "writable-changed" signal is emitted when the writability of a +key has potentially changed. You should call +g_settings_is_writable() in order to determine the new status. +This signal supports detailed connections. You can connect to the +detailed signal "writable-changed::x" in order to only receive +callbacks when the writability of "x" changes. + + + + + + the key + + + + + + + An implementation of a settings storage repository. + + Calculate the longest common prefix of all keys in a tree and write +out an array of the key names relative to that prefix and, +optionally, the value to store at each of those keys. +You must free the value returned in @path, @keys and @values using +g_free(). You should not attempt to free or unref the contents of + + + + + + a #GTree containing the changes + + + + the location to save the path + + + + the location to save the relative keys + + + + the location to save the values, or %NULL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Signals that a single key has possibly changed. Backend +implementations should call this if a key has possibly changed its +value. +'//', and not ending with a slash). +The implementation must call this function during any call to +g_settings_backend_write(), before the call returns (except in the +case that no keys are actually changed and it cares to detect this +fact). It may not rely on the existence of a mainloop for +dispatching the signal later. +The implementation may call this function at any other time it likes +in response to other events (such as changes occuring outside of the +program). These calls may originate from a mainloop or may originate +in response to any other action (including from calls to +g_settings_backend_write()). +In the case that this call is in response to a call to +g_settings_backend_write() then @origin_tag must be set to the same +value that was passed to that call. + + + + + + the name of the key + + + + the origin tag + + + + + + This call is a convenience wrapper. It gets the list of changes from +g_settings_backend_changed(). + + + + + + a #GTree containing the changes + + + + the origin tag + + + + + + Signals that a list of keys have possibly changed. Backend +implementations should call this if keys have possibly changed their +values. +not containing '//'). Each string in @items must form a valid key +end with '/' and must not contain '//'). +The meaning of this signal is that any of the key names resulting +from the contatenation of @path with each item in @items may have +changed. +The same rules for when notifications must occur apply as per +g_settings_backend_changed(). These two calls can be used +interchangeably if exactly one item has changed (although in that +case g_settings_backend_changed() is definitely preferred). +For efficiency reasons, the implementation should strive for @path to +keys that were changed) but this is not strictly required. + + + + + + the path containing the changes + + + + the %NULL-terminated list of changed keys + + + + the origin tag + + + + + + Signals that all keys below a given path may have possibly changed. +Backend implementations should call this if an entire path of keys +have possibly changed their values. +not containing '//'). +The meaning of this signal is that any of the key which has a name +starting with @path may have changed. +The same rules for when notifications must occur apply as per +g_settings_backend_changed(). This call might be an appropriate +reasponse to a 'reset' call but implementations are also free to +explicitly list the keys that were affected by that call if they can +easily do so. +For efficiency reasons, the implementation should strive for @path to +keys that were changed) but this is not strictly required. As an +example, if this function is called with the path of "/" then every +single key in the application will be notified of a possible change. + + + + + + the path containing the changes + + + + the origin tag + + + + + + Signals that the writability of all keys below a given path may have +changed. +Since GSettings performs no locking operations for itself, this call +will always be made in response to external events. + + + + + + the name of the path + + + + + + Signals that the writability of a single key has possibly changed. +Since GSettings performs no locking operations for itself, this call +will always be made in response to external events. + + + + + + the name of the key + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Flags used when creating a binding. These flags determine in which +direction the binding works. The default is to synchronize in both +directions. + + + + + + + + + The type for the function that is used to convert from #GSettings to +an object property. The @value is already initialized to hold values +of the appropriate type. + + %TRUE if the conversion succeeded, %FALSE in case of an error + + + + + return location for the property value + + + + the #GVariant + + + + user data that was specified when the binding was created + + + + + + The type for the function that is used to convert an object property +value to a #GVariant for storing it in #GSettings. + + a new #GVariant holding the data from @value, or %NULL in case of an error + + + + + a #GValue containing the property value to map + + + + the #GVariantType to create + + + + user data that was specified when the binding was created + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The type of the function that is used to convert from a value stored +in a #GSettings to a value that is useful to the application. +If the value is successfully mapped, the result should be stored at +is not in the right format) then %FALSE should be returned. +If @value is %NULL then it means that the mapping function is being +given a "last chance" to successfully return a valid value. %TRUE +must be returned in this case. + + %TRUE if the conversion succeeded, %FALSE in case of an error + + + + + the #GVariant to map, or %NULL + + + + the result of the mapping + + + + the user data that was passed to g_settings_get_mapped() + + + + + + + + The <structname>GSimpleAction</structname> structure contains private +data and should only be accessed using the provided API + + + Creates a new action. +The created action is stateless. See g_simple_action_new_stateful(). + + a new #GSimpleAction + + + + + the name of the action + + + + the type of parameter to the activate function + + + + + + Creates a new stateful action. +must have the same #GVariantType as the initial state. +If the @state GVariant is floating, it is consumed. + + a new #GSimpleAction + + + + + the name of the action + + + + the type of the parameter to the activate function + + + + the initial state of the action + + + + + + Sets the action as enabled or not. +An action must be enabled in order to be activated or in order to +have its state changed from outside callers. + + + + + + whether the action is enabled + + + + + + If @action is currently enabled. +If the action is disabled then calls to g_simple_action_activate() and +g_simple_action_set_state() have no effect. + + + + The name of the action. This is mostly meaningful for identifying +the action once it has been added to a #GSimpleActionGroup. + + + + The type of the parameter that must be given when activating the +action. + + + + The state of the action, or %NULL if the action is stateless. + + + + The #GVariantType of the state that the action has, or %NULL if the +action is stateless. + + + + + + + + + + Indicates that the action was just activated. +an incorrect type was given, no signal will be emitted. + + + + + + the parameter to the activation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The #GSimpleActionGroup structure contains private data and should only be accessed using the provided API. + + + Creates a new, empty, #GSimpleActionGroup. + + a new #GSimpleActionGroup + + + + + Adds an action to the action group. +If the action group already contains an action with the same name as +The action group takes its own reference on @action. + + + + + + a #GAction + + + + + + Looks up the action with the name @action_name in the group. +If no such action exists, returns %NULL. + + a #GAction, or %NULL + + + + + the name of an action + + + + + + Removes the named action from the action group. +If no action of this name is in the group then nothing happens. + + + + + + the name of the action + + + + + + + + + + + + + + + + + + + + + + + + + + A simple implementation of #GAsyncResult. + Creates a #GSimpleAsyncResult. + a #GSimpleAsyncResult. + a #GObject the asynchronous function was called with, or %NULL. + a #GAsyncReadyCallback. - + user data passed to @callback. + - + the asynchronous function. + + c:identifier="g_simple_async_result_new_error" + introspectable="0"> + Creates a new #GSimpleAsyncResult with a set error. + a #GSimpleAsyncResult. + a #GObject, or %NULL. + a #GAsyncReadyCallback. - + user data passed to @callback. + + a #GQuark. - + an error code. + + a string with format characters. @@ -18082,138 +34865,179 @@ from a #GResolver routine." + + Creates a #GSimpleAsyncResult from an error condition. + + a #GSimpleAsyncResult. + + + + + a #GObject, or %NULL. + + + + a #GAsyncReadyCallback. + + + + user data passed to @callback. + + + + a #GError location. + + + + + Ensures that the data passed to the _finish function of an async +operation is consistent. Three checks are performed. +First, @result is checked to ensure that it is really a +#GSimpleAsyncResult. Second, @source is checked to ensure that it +matches the source object of @result. Third, @source_tag is +checked to ensure that it is either %NULL (as it is when the result was +created by g_simple_async_report_error_in_idle() or +g_simple_async_report_gerror_in_idle()) or equal to the +convention, is a pointer to the _async function corresponding to the +_finish function from which this function is called). - + #TRUE if all checks passed or #FALSE if any failed. + + the #GAsyncResult passed to the _finish function. + the #GObject passed to the _finish function. - + the asynchronous function. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Completes an asynchronous I/O job immediately. Must be called in +the thread where the asynchronous result was to be delivered, as it +invokes the callback directly. If you are in a different thread use +g_simple_async_result_complete_in_idle(). +Calling this function takes a reference to @simple for as long as +is needed to complete the call. + Completes an asynchronous function in an idle handler in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread that @simple was initially created in. +Calling this function takes a reference to @simple for as long as +is needed to complete the call. + + Gets the operation result boolean from within the asynchronous result. +if the operation's result was %FALSE. + + %TRUE if the operation's result was %TRUE, %FALSE + + + + + Gets a pointer result as returned by the asynchronous function. + + a pointer from the result. + + + + + Gets a gssize from the asynchronous result. + + a gssize returned from the asynchronous function. + + + + + Gets the source tag for the #GSimpleAsyncResult. + + a #gpointer to the source object for the #GSimpleAsyncResult. + + + + + Propagates an error from within the simple asynchronous result to +a given destination. + + %TRUE if the error was propagated to @dest. %FALSE otherwise. + + + + c:identifier="g_simple_async_result_run_in_thread" + introspectable="0"> + Runs the asynchronous job in a separate thread and then calls +g_simple_async_result_complete_in_idle() on @simple to return +the result to the appropriate main loop. +Calling this function takes a reference to @simple for as long as +is needed to run the job and report its completion. - + + a #GSimpleAsyncThreadFunc. - + the io priority of the request. + + optional #GCancellable object, %NULL to ignore. - + + Sets an error within the asynchronous result without a #GError. + a #GQuark (usually #G_IO_ERROR). - + an error code. + + a formatted error reporting string. @@ -18222,455 +35046,1165 @@ from a #GResolver routine." + + Sets an error within the asynchronous result without a #GError. +Unless writing a binding, see g_simple_async_result_set_error(). + + + + + + a #GQuark (usually #G_IO_ERROR). + + + + an error code. + + + + a formatted error reporting string. + + + + va_list of arguments. + + + + + + Sets the result from a #GError. + + + + + + #GError. + + + + + + Sets whether to handle cancellation within the asynchronous operation. + + + + + + a #gboolean. + + + + + + Sets the operation result to a boolean within the asynchronous result. + + + + + + a #gboolean. + + + + + + Sets the operation result within the asynchronous result to a pointer. + + + + + + a pointer result from an asynchronous function. + + + + a #GDestroyNotify function. + + + + + + Sets the operation result within the asynchronous result to +the given @op_res. + + + + + + a #gssize. + + + + - + + Simple thread function that runs an asynchronous operation and +checks for cancellation. + a #GSimpleAsyncResult. + a #GObject. + optional #GCancellable object, %NULL to ignore. + + #GSimplePermission is an opaque data structure. There are no methods +except for those defined by #GPermission. + + Creates a new #GPermission instance that represents an action that is +either always or never allowed. + + the #GSimplePermission, as a #GPermission + + + + + %TRUE if the action is allowed + + + + + + A lowlevel network socket object. - + + Creates a new #GSocket with the defined family, type and protocol. +If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type +for the family and type is used. +The @protocol is a family and type specific int that specifies what +kind of protocol to use. #GSocketProtocol lists several common ones. +Many families only support one protocol, and use 0 for this, others +support several and using 0 means to use the default protocol for +the family and type. +The protocol id is passed directly to the operating +system, so you can use protocols not listed in #GSocketProtocol if you +know the protocol number used for it. +Free the returned object with g_object_unref(). + a #GSocket or %NULL on error. + the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4. + the socket type to use. + the id of the protocol to use, or 0 for default. + Creates a new #GSocket from a native file descriptor +or winsock SOCKET handle. +This reads all the settings from the file descriptor so that +all properties should work. Note that the file descriptor +will be set to non-blocking mode, independent on the blocking +mode of the #GSocket. +Free the returned object with g_object_unref(). + a #GSocket or %NULL on error. - + a native socket file descriptor. + - - - - - - - - - - - - - - - - - - - - - + Accept incoming connections on a connection-based socket. This removes +the first outstanding connection request from the listening socket and +creates a #GSocket object for it. +The @socket must be bound to a local address with g_socket_bind() and +must be listening for incoming connections (g_socket_listen()). +If there are no outstanding connections then the operation will block +or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled. +To be notified of an incoming connection, wait for the %G_IO_IN condition. +Free the returned object with g_object_unref(). - - - - - - - - - - - + a new #GSocket, or %NULL on error. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a %GCancellable or %NULL + + When a socket is created it is attached to an address family, but it +doesn't have an address in this family. g_socket_bind() assigns the +address (sometimes called name) of the socket. +It is generally required to bind to a local address before you can +receive connections. (See g_socket_listen() and g_socket_accept() ). +In certain situations, you may also want to bind a socket that will be +used to initiate connections, though this is not normally required. +eventually call g_socket_accept() on), and %FALSE for client sockets. +(Specifically, if it is %TRUE, then g_socket_bind() will set the +%SO_REUSEADDR flag on the socket, allowing it to bind @address even if +that address was previously used by another socket that has not yet been +fully cleaned-up by the kernel. Failing to set this flag on a server +socket may cause the bind call to return %G_IO_ERROR_ADDRESS_IN_USE if +the server program is stopped and then immediately restarted.) + + %TRUE on success, %FALSE on error. + + + + + a #GSocketAddress specifying the local address. + + + + whether to allow reusing this address + + + + + Checks and resets the pending connect error for the socket. +This is used to check for errors when g_socket_connect() is +used in non-blocking mode. - + %TRUE if no error, %FALSE otherwise, setting @error to the error + - - - + + Closes the socket, shutting down any active connection. +Closing a socket does not wait for all outstanding I/O operations +to finish, so the caller should not rely on them to be guaranteed +to complete even if the close returns with no error. +Once the socket is closed, all other operations will return +%G_IO_ERROR_CLOSED. Closing a socket multiple times will not +return an error. +Sockets will be automatically closed when the last reference +is dropped, but you might want to call this function to make sure +resources are released as early as possible. +Beware that due to the way that TCP works, it is possible for +recently-sent data to be lost if either you close a socket while the +%G_IO_IN condition is set, or else if the remote connection tries to +send something to you after you close the socket but before it has +finished reading all of the data you sent. There is no easy generic +way to avoid this problem; the easiest fix is to design the network +protocol such that the client will never send data "out of turn". +Another solution is for the server to half-close the connection by +calling g_socket_shutdown() with only the @shutdown_write flag set, +and then wait for the client to notice this and close its side of the +connection, after which the server can safely call g_socket_close(). +(This is what #GTcpConnection does if you call +g_tcp_connection_set_graceful_disconnect(). But of course, this +only works if the client will close its connection after the server +does.) + + %TRUE on success, %FALSE on error + + + + + Checks on the readiness of @socket to perform operations. +The operations specified in @condition are checked for and masked +against the currently-satisfied conditions on @socket. The result +is returned. +Note that on Windows, it is possible for an operation to return +%G_IO_ERROR_WOULD_BLOCK even immediately after +g_socket_condition_check() has claimed that the socket is ready for +writing. Rather than calling g_socket_condition_check() and then +writing to the socket if it succeeds, it is generally better to +simply try writing to the socket right away, and try again later if +the initial attempt returns %G_IO_ERROR_WOULD_BLOCK. +It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition; +these conditions will always be set in the output if they are true. +This call never blocks. + + the @GIOCondition mask of the current state + - + a #GIOCondition mask to check + + Waits for @condition to become true on @socket. When the condition +is met, %TRUE is returned. +If @cancellable is cancelled before the condition is met, or if the +socket has a timeout set and it is reached before the condition is +met, then %FALSE is returned and @error, if non-%NULL, is set to +the appropriate value (%G_IO_ERROR_CANCELLED or +%G_IO_ERROR_TIMED_OUT). - + %TRUE if the condition was met, %FALSE otherwise + - + a #GIOCondition mask to wait for + + a #GCancellable, or %NULL - + + Connect the socket to the specified remote address. +For connection oriented socket this generally means we attempt to make +a connection to the @address. For a connection-less socket it sets +the default address for g_socket_send() and discards all incoming datagrams +from other sources. +Generally connection oriented sockets can only connect once, but +connection-less sockets can connect multiple times to change the +default address. +If the connect call needs to do network I/O it will block, unless +non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned +and the user can be notified of the connection finishing by waiting +for the G_IO_OUT condition. The result of the connection can then be +checked with g_socket_check_connect_result(). + + %TRUE if connected, %FALSE on error. + + + + + a #GSocketAddress specifying the remote address. + + + + a %GCancellable or %NULL + + + + + + Creates a #GSocketConnection subclass of the right type for - + a #GSocketConnection + + + + + Creates a %GSource that can be attached to a %GMainContext to monitor +for the availibility of the specified @condition on the socket. +The callback on the source is of the #GSocketSourceFunc type. +It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; +these conditions will always be reported output if they are true. +cause the source to trigger, reporting the current condition (which +is likely 0 unless cancellation happened at the same time as a +condition change). You can check for this in the callback using +g_cancellable_is_cancelled(). +If @socket has a timeout set, and it is reached before @condition +occurs, the source will then trigger anyway, reporting %G_IO_IN or +%G_IO_OUT depending on @condition. However, @socket will have been +marked as having had a timeout, and so the next #GSocket I/O method +you call will then fail with a %G_IO_ERROR_TIMED_OUT. + + a newly allocated %GSource, free with g_source_unref(). + + + a #GIOCondition mask to monitor + + + a %GCancellable or %NULL - + + Gets the blocking mode of the socket. For details on blocking I/O, +see g_socket_set_blocking(). - + %TRUE if blocking I/O is used, %FALSE otherwise. + - + + Returns the credentials of the foreign process connected to this +socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX +sockets). +If this operation isn't supported on the OS, the method fails with +the %G_IO_ERROR_NOT_SUPPORTED error. On Linux this is implemented +by reading the %SO_PEERCRED option on the underlying socket. +Other ways to obtain credentials from a foreign peer includes the +#GUnixCredentialsMessage type and +g_unix_connection_send_credentials() / +g_unix_connection_receive_credentials() functions. +that must be freed with g_object_unref(). + + %NULL if @error is set, otherwise a #GCredentials object + + + + + Gets the socket family of the socket. - + a #GSocketFamily + + + + + Returns the underlying OS socket object. On unix this +is a socket file descriptor, and on windows this is +a Winsock2 SOCKET handle. This may be useful for +doing platform specific or otherwise unusual operations +on the socket. + + the file descriptor of the socket. + + + + + Gets the keepalive mode of the socket. For details on this, +see g_socket_set_keepalive(). + + %TRUE if keepalive is active, %FALSE otherwise. + + + + + Gets the listen backlog setting of the socket. For details on this, +see g_socket_set_listen_backlog(). + + the maximum number of pending connections. + + + + + Try to get the local address of a bound socket. This is only +useful if the socket has been bound to a local address, +either explicitly or implicitly when connecting. +Free the returned object with g_object_unref(). + + a #GSocketAddress or %NULL on error. + + + + + Gets the socket protocol id the socket was created with. +In case the protocol is unknown, -1 is returned. + + a protocol id, or -1 if unknown + + + + + Try to get the remove address of a connected socket. This is only +useful for connection oriented sockets that have been connected. +Free the returned object with g_object_unref(). + + a #GSocketAddress or %NULL on error. + + + + + Gets the socket type of the socket. + + a #GSocketType + + + + + Gets the timeout setting of the socket. For details on this, see +g_socket_set_timeout(). + + the timeout in seconds + + + + + Checks whether a socket is closed. + + %TRUE if socket is closed, %FALSE otherwise + + + + + Check whether the socket is connected. This is only useful for +connection-oriented sockets. + + %TRUE if socket is connected, %FALSE otherwise. + + + + + Marks the socket as a server socket, i.e. a socket that is used +to accept incoming requests using g_socket_accept(). +Before calling this the socket must be bound to a local address using +g_socket_bind(). +To set the maximum amount of outstanding clients, use +g_socket_set_listen_backlog(). + + %TRUE on success, %FALSE on error. + + + + + Receive data (up to @size bytes) from a socket. This is mainly used by +connection-oriented sockets; it is identical to g_socket_receive_from() +with @address set to %NULL. +For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets, +g_socket_receive() will always read either 0 or 1 complete messages from +the socket. If the received message is too large to fit in @buffer, then +the data beyond @size bytes will be discarded, without any explicit +indication that this has occurred. +For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any +number of bytes, up to @size. If more than @size bytes have been +received, the additional data will be returned in future calls to +g_socket_receive(). +If the socket is in blocking mode the call will block until there is +some data to receive or there is an error. If there is no data available +and the socket is in non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error +will be returned. To be notified when data is available, wait for the +%G_IO_IN condition. +On error -1 is returned and @error is set accordingly. + + Number of bytes read, or -1 on error + - + + a buffer to read data into (which should be at least @size bytes long). - + the number of bytes you want to read from the socket + + a %GCancellable or %NULL + Receive data (up to @size bytes) from a socket. +If @address is non-%NULL then @address will be set equal to the +source address of the received packet. +See g_socket_receive() for additional information. - + Number of bytes read, or -1 on error + + a pointer to a #GSocketAddress pointer, or %NULL - - - - - - - - - - - - - - - - + a buffer to read data into (which should be at least @size bytes long). - - - - - - - - - - - - - - - - - - - - + the number of bytes you want to read from the socket + + a %GCancellable or %NULL + Receive data from a socket. This is the most complicated and +fully-featured version of this call. For easier use, see +g_socket_receive() and g_socket_receive_from(). +If @address is non-%NULL then @address will be set equal to the +source address of the received packet. +describe the buffers that received data will be scattered into. +If @num_vectors is -1, then @vectors is assumed to be terminated +by a #GInputVector with a %NULL buffer pointer. +As a special case, if @num_vectors is 0 (in which case, @vectors +may of course be %NULL), then a single byte is received and +discarded. This is to facilitate the common practice of sending a +single '\0' byte for the purposes of transferring ancillary data. +array of #GSocketControlMessage instances or %NULL if no such +messages was received. These correspond to the control messages +received from the kernel, one #GSocketControlMessage per message +from the kernel. This array is %NULL-terminated and must be freed +by the caller using g_free() after calling g_object_unref() on each +element. If @messages is %NULL, any control messages received will +be discarded. +messages received. +If both @messages and @num_messages are non-%NULL, then +for this are available in the #GSocketMsgFlags enum, but the +values there are the same as the system values, and the flags +are passed in as-is, so you can pass in system-specific flags too +(and g_socket_receive_message() may pass system-specific flags out). +As with g_socket_receive(), data may be discarded if @socket is +%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not +provide enough buffer space to read a complete message. You can pass +%G_SOCKET_MSG_PEEK in @flags to peek at the current message without +removing it from the receive queue, but there is no portable way to find +out the length of the message other than by reading it into a +sufficiently-large buffer. +If the socket is in blocking mode the call will block until there +is some data to receive or there is an error. If there is no data +available and the socket is in non-blocking mode, a +%G_IO_ERROR_WOULD_BLOCK error will be returned. To be notified when +data is available, wait for the %G_IO_IN condition. +On error -1 is returned and @error is set accordingly. - + Number of bytes read, or -1 on error + + a pointer to a #GSocketAddress pointer, or %NULL + an array of #GInputVector structs - + the number of elements in @vectors, or -1 + + a pointer which may be filled with an array of #GSocketControlMessages, or %NULL - - + + a pointer which will be filled with the number of elements in @messages, or %NULL + - - + + a pointer to an int containing #GSocketMsgFlags flags + + a %GCancellable or %NULL + + + + + + This behaves exactly the same as g_socket_receive(), except that +the choice of blocking or non-blocking behavior is determined by +the @blocking argument rather than by @socket's properties. + + Number of bytes read, or -1 on error + + + + + a buffer to read data into (which should be at least @size bytes long). + + + + the number of bytes you want to read from the socket + + + + whether to do blocking or non-blocking I/O + + + + a %GCancellable or %NULL + + + + + + Tries to send @size bytes from @buffer on the socket. This is +mainly used by connection-oriented sockets; it is identical to +g_socket_send_to() with @address set to %NULL. +If the socket is in blocking mode the call will block until there is +space for the data in the socket queue. If there is no space available +and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error +will be returned. To be notified when space is available, wait for the +%G_IO_OUT condition. Note though that you may still receive +%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously +notified of a %G_IO_OUT condition. (On Windows in particular, this is +very common due to the way the underlying APIs work.) +On error -1 is returned and @error is set accordingly. +on error + + Number of bytes written (which may be less than @size), or -1 + + + + + the buffer containing the data to send. + + + + the number of bytes to send + + + + a %GCancellable or %NULL + Send data to @address on @socket. This is the most complicated and +fully-featured version of this call. For easier use, see +g_socket_send() and g_socket_send_to(). +If @address is %NULL then the message is sent to the default receiver +(set by g_socket_connect()). +then @vectors is assumed to be terminated by a #GOutputVector with a +%NULL buffer pointer.) The #GOutputVector structs describe the buffers +that the sent data will be gathered from. Using multiple +#GOutputVector<!-- -->s is more memory-efficient than manually copying +data from multiple sources into a single buffer, and more +network-efficient than making multiple calls to g_socket_send(). +#GSocketControlMessage instances. These correspond to the control +messages to be sent on the socket. +If @num_messages is -1 then @messages is treated as a %NULL-terminated +array. +for this are available in the #GSocketMsgFlags enum, but the +values there are the same as the system values, and the flags +are passed in as-is, so you can pass in system-specific flags too. +If the socket is in blocking mode the call will block until there is +space for the data in the socket queue. If there is no space available +and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error +will be returned. To be notified when space is available, wait for the +%G_IO_OUT condition. Note though that you may still receive +%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously +notified of a %G_IO_OUT condition. (On Windows in particular, this is +very common due to the way the underlying APIs work.) +On error -1 is returned and @error is set accordingly. +on error - + Number of bytes written (which may be less than @size), or -1 + + a #GSocketAddress, or %NULL + an array of #GOutputVector structs - + the number of elements in @vectors, or -1 + + a pointer to an array of #GSocketControlMessages, or %NULL. - + number of elements in @messages, or -1. + - + an int containing #GSocketMsgFlags flags + + a %GCancellable or %NULL - + + Tries to send @size bytes from @buffer to @address. If @address is +%NULL then the message is sent to the default receiver (set by +g_socket_connect()). +See g_socket_send() for additional information. +on error - + Number of bytes written (which may be less than @size), or -1 + + + + a #GSocketAddress, or %NULL + + + + the buffer containing the data to send. + + + + the number of bytes to send + + + + a %GCancellable or %NULL + + + - + + This behaves exactly the same as g_socket_send(), except that +the choice of blocking or non-blocking behavior is determined by +the @blocking argument rather than by @socket's properties. +on error - + Number of bytes written (which may be less than @size), or -1 + + + + + the buffer containing the data to send. + + + + the number of bytes to send + + + + whether to do blocking or non-blocking I/O + + + + a %GCancellable or %NULL + + + + + + Sets the blocking mode of the socket. In blocking mode +all operations block until they succeed or there is an error. In +non-blocking mode all functions return results immediately or +with a %G_IO_ERROR_WOULD_BLOCK error. +All sockets are created in blocking mode. However, note that the +platform level socket is always non-blocking, and blocking mode +is a GSocket level feature. + + + + + + Whether to use blocking I/O or not. + + + + + + Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When +this flag is set on a socket, the system will attempt to verify that the +remote socket endpoint is still present if a sufficiently long period of +time passes with no data being exchanged. If the system is unable to +verify the presence of the remote endpoint, it will automatically close +the connection. +This option is only functional on certain kinds of sockets. (Notably, +%G_SOCKET_PROTOCOL_TCP sockets.) +The exact time between pings is system- and protocol-dependent, but will +normally be at least two hours. Most commonly, you would set this flag +on a server socket if you want to allow clients to remain idle for long +periods of time, but also want to ensure that connections are eventually +garbage-collected if clients crash or become unreachable. + + + + + + Value for the keepalive flag + + + + + + Sets the maximum number of outstanding connections allowed +when listening on this socket. If more clients than this are +connecting to the socket and the application is not handling them +on time then the new connections will be refused. +Note that this must be called before g_socket_listen() and has no +effect if called after that. + + + + + + the maximum number of pending connections. + + + + + + Sets the time in seconds after which I/O operations on @socket will +time out if they have not yet completed. +On a blocking socket, this means that any blocking #GSocket +operation will time out after @timeout seconds of inactivity, +returning %G_IO_ERROR_TIMED_OUT. +On a non-blocking socket, calls to g_socket_condition_wait() will +also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources +created with g_socket_create_source() will trigger after +set, at which point calling g_socket_receive(), g_socket_send(), +g_socket_check_connect_result(), etc, will fail with +%G_IO_ERROR_TIMED_OUT. +If @timeout is 0 (the default), operations will never time out +on their own. +Note that if an I/O operation is interrupted by a signal, this may +cause the timeout to be reset. + + + + + + the timeout for @socket, in seconds, or 0 for none + + + + + + Shut down part of a full-duplex connection. +If @shutdown_read is %TRUE then the recieving side of the connection +is shut down, and further reading is disallowed. +If @shutdown_write is %TRUE then the sending side of the connection +is shut down, and further writing is disallowed. +It is allowed for both @shutdown_read and @shutdown_write to be %TRUE. +One example where this is used is graceful disconnect for TCP connections +where you close the sending side, then wait for the other side to close +the connection, thus ensuring that the other side saw all sent data. + + %TRUE on success, %FALSE on error + - + whether to shut down the read side + - + whether to shut down the write side + - + + Checks if a socket is capable of speaking IPv4. +IPv4 sockets are capable of speaking IPv4. On some operating systems +and under some combinations of circumstances IPv6 sockets are also +capable of speaking IPv4. See RFC 3493 section 3.7 for more +information. +No other types of sockets are currently considered as being capable +of speaking IPv4. - + %TRUE if this socket can be used with IPv4. + - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + The timeout in seconds on socket I/O + + + + @@ -18680,78 +36214,127 @@ checks for cancellation."> + A socket endpoint address, corresponding to <type>struct sockaddr</type> +or one of its subtypes. + c:identifier="g_socket_address_new_from_native" + version="2.22"> + Creates a #GSocketAddress subclass corresponding to the native +<type>struct sockaddr</type> @native. +otherwise %NULL. + a new #GSocketAddress if @native could successfully be converted, - + a pointer to a <type>struct sockaddr</type> + - + the size of the memory location pointed to by @native + - - + + Gets the socket family type of @address. + + the socket family type of @address. - + + Gets the size of @address's native <type>struct sockaddr</type>. +You can use this to allocate memory to pass to +g_socket_address_to_native(). - + the size of the native <type>struct sockaddr</type> that + - + + Converts a #GSocketAddress to a native <type>struct +sockaddr</type>, which can be passed to low-level functions like +connect() or bind(). +If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is +returned. If the address type is not known on the system +then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - + %TRUE if @dest was filled in, %FALSE on error + - + a pointer to a memory location that will contain the native <type>struct sockaddr</type>. + - + the size of @dest. Must be at least as large as g_socket_address_get_native_size(). + - - + + Gets the socket family type of @address. + + the socket family type of @address. + + Gets the size of @address's native <type>struct sockaddr</type>. +You can use this to allocate memory to pass to +g_socket_address_to_native(). + + the size of the native <type>struct sockaddr</type> that + + + + Converts a #GSocketAddress to a native <type>struct +sockaddr</type>, which can be passed to low-level functions like +connect() or bind(). +If not enough space is availible, a %G_IO_ERROR_NO_SPACE error is +returned. If the address type is not known on the system +then a %G_IO_ERROR_NOT_SUPPORTED error is returned. - + %TRUE if @dest was filled in, %FALSE on error + - + a pointer to a memory location that will contain the native <type>struct sockaddr</type>. + - + the size of @dest. Must be at least as large as g_socket_address_get_native_size(). + - - - - - - - + + @@ -18764,8 +36347,9 @@ checks for cancellation."> - - + + + the socket family type of @address. @@ -18776,9 +36360,10 @@ checks for cancellation."> - + - + the size of the native <type>struct sockaddr</type> that + @@ -18788,46 +36373,69 @@ checks for cancellation."> - + - + %TRUE if @dest was filled in, %FALSE on error + - + a pointer to a memory location that will contain the native <type>struct sockaddr</type>. + - + the size of @dest. Must be at least as large as g_socket_address_get_native_size(). + + Enumerator type for objects that contain or generate +#GSocketAddress<!-- -->es. + Retrieves the next #GSocketAddress from @enumerator. Note that this +may block for some amount of time. (Eg, a #GNetworkAddress may need +to do a DNS lookup before it can return an address.) Use +g_socket_address_enumerator_next_async() if you need to avoid +blocking. +If @enumerator is expected to yield addresses, but for some reason +is unable to (eg, because of a DNS error), then the first call to +g_socket_address_enumerator_next() will return an appropriate error +in *@error. However, if the first call to +g_socket_address_enumerator_next() succeeds, then any further +internal errors (other than @cancellable being triggered) will be +ignored. +error (in which case *@error will be set) or if there are no +more addresses. + a #GSocketAddress (owned by the caller), or %NULL on + optional #GCancellable object, %NULL to ignore. + Asynchronously retrieves the next #GSocketAddress from @enumerator +and then calls @callback, which must call +g_socket_address_enumerator_next_finish() to get the result. @@ -18835,22 +36443,36 @@ checks for cancellation."> + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - - + + the data to pass to callback function + + Retrieves the result of a completed call to +g_socket_address_enumerator_next_async(). See +g_socket_address_enumerator_next() for more information about +error handling. +error (in which case *@error will be set) or if there are no +more addresses. + a #GSocketAddress (owned by the caller), or %NULL on + a #GAsyncResult @@ -18858,19 +36480,38 @@ checks for cancellation."> + Retrieves the next #GSocketAddress from @enumerator. Note that this +may block for some amount of time. (Eg, a #GNetworkAddress may need +to do a DNS lookup before it can return an address.) Use +g_socket_address_enumerator_next_async() if you need to avoid +blocking. +If @enumerator is expected to yield addresses, but for some reason +is unable to (eg, because of a DNS error), then the first call to +g_socket_address_enumerator_next() will return an appropriate error +in *@error. However, if the first call to +g_socket_address_enumerator_next() succeeds, then any further +internal errors (other than @cancellable being triggered) will be +ignored. +error (in which case *@error will be set) or if there are no +more addresses. + a #GSocketAddress (owned by the caller), or %NULL on + optional #GCancellable object, %NULL to ignore. + Asynchronously retrieves the next #GSocketAddress from @enumerator +and then calls @callback, which must call +g_socket_address_enumerator_next_finish() to get the result. @@ -18878,27 +36519,38 @@ checks for cancellation."> + optional #GCancellable object, %NULL to ignore. + closure="2"> + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + + Retrieves the result of a completed call to +g_socket_address_enumerator_next_async(). See +g_socket_address_enumerator_next() for more information about +error handling. +error (in which case *@error will be set) or if there are no +more addresses. + a #GSocketAddress (owned by the caller), or %NULL on + a #GAsyncResult @@ -18914,8 +36566,9 @@ checks for cancellation."> - + + a #GSocketAddress (owned by the caller), or %NULL on @@ -18926,13 +36579,14 @@ checks for cancellation."> + optional #GCancellable object, %NULL to ignore. - + @@ -18944,20 +36598,27 @@ checks for cancellation."> + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback to call when the request is satisfied - + the data to pass to callback function + - + + a #GSocketAddress (owned by the caller), or %NULL on @@ -18966,6 +36627,7 @@ checks for cancellation."> c:type="GSocketAddressEnumerator*"/> + a #GAsyncResult @@ -18978,71 +36640,71 @@ checks for cancellation."> - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -19050,265 +36712,617 @@ checks for cancellation."> - + A helper class for network servers to listen for and accept connections. + + Creates a new #GSocketClient with the default options. +Free the returned object with g_object_unref(). + a #GSocketClient. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Enable proxy protocols to be handled by the application. When the +indicated proxy protocol is returned by the #GProxyResolver, +#GSocketClient will consider this protocol as supported but will +not try find a #GProxy instance to handle handshaking. The +application must check for this case by calling +g_socket_connection_get_remote_address() on the returned +#GSocketConnection, and seeing if it's a #GProxyAddress of the +appropriate type, to determine whether or not it needs to handle +the proxy handshaking itself. +This should be used for proxy protocols that are dialects of +another protocol such as HTTP proxy. It also allows cohabitation of +proxy protocols that are reused between protocols. A good example +is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also +be use as generic socket proxy through the HTTP CONNECT method. - + The proxy protocol + - - - - - - - - - - - - - - - - + + Tries to resolve the @connectable and make a network connection to it.. +Upon a successful connection, a new #GSocketConnection is constructed +and returned. The caller owns this new object and must drop their +reference to it when finished with it. +The type of the #GSocketConnection object returned depends on the type of +the underlying socket that is used. For instance, for a TCP/IP connection +it will be a #GTcpConnection. +The socket created will be the same family as the the address that the +or indirectly via g_socket_client_set_local_address(). The socket type +defaults to %G_SOCKET_TYPE_STREAM but can be set with +g_socket_client_set_socket_type(). +If a local address is specified with g_socket_client_set_local_address() the +socket will be bound to this address before connecting. + a #GSocketConnection on success, %NULL on error. + a #GSocketConnectable specifying the remote address. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + optional #GCancellable object, %NULL to ignore. + c:identifier="g_socket_client_connect_async" + version="2.22"> + This is the asynchronous version of g_socket_client_connect(). +When the operation is finished @callback will be +called. You can then call g_socket_client_connect_finish() to get +the result of the operation. + a #GSocketConnectable specifying the remote address. + a #GCancellable, or %NULL + + + + a #GAsyncReadyCallback + + + + user data for the callback + + + + + + Finishes an async connect operation. See g_socket_client_connect_async() + + a #GSocketConnection on success, %NULL on error. + + + + + a #GAsyncResult. + + + + + + This is a helper function for g_socket_client_connect(). +Attempts to create a TCP connection to the named host. +address, an IPv4 address, or a domain name (in which case a DNS +lookup is performed). Quoting with [] is supported for all address +types. A port override may be specified in the usual way with a +colon. Ports may be given as decimal numbers or symbolic names (in +which case an /etc/services lookup is performed). +If no port override is given in @host_and_port then @default_port will be +used as the port number to connect to. +In general, @host_and_port is expected to be provided by the user (allowing +them to give the hostname, and a port overide if necessary) and +In the case that an IP address is given, a single connection +attempt is made. In the case that a name is given, multiple +connection attempts may be made, in turn and according to the +number of address records in DNS, until a connection succeeds. +Upon a successful connection, a new #GSocketConnection is constructed +and returned. The caller owns this new object and must drop their +reference to it when finished with it. +In the event of any failure (DNS error, service not found, no hosts +connectable) %NULL is returned and @error (if non-%NULL) is set +accordingly. + + a #GSocketConnection on success, %NULL on error. + + + + + the name and optionally port of the host to connect to + + + + the default port to connect to + + + + a #GCancellable, or %NULL + + + + + + This is the asynchronous version of g_socket_client_connect_to_host(). +When the operation is finished @callback will be +called. You can then call g_socket_client_connect_to_host_finish() to get +the result of the operation. + + + + + + the name and optionally the port of the host to connect to + + + + the default port to connect to + + + + a #GCancellable, or %NULL + a #GAsyncReadyCallback - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + user data for the callback + + Finishes an async connect operation. See g_socket_client_connect_to_host_async() + a #GSocketConnection on success, %NULL on error. + a #GAsyncResult. - - - + + Attempts to create a TCP connection to a service. +This call looks up the SRV record for @service at @domain for the +"tcp" protocol. It then attempts to connect, in turn, to each of +the hosts providing the service until either a connection succeeds +or there are no hosts remaining. +Upon a successful connection, a new #GSocketConnection is constructed +and returned. The caller owns this new object and must drop their +reference to it when finished with it. +In the event of any failure (DNS error, service not found, no hosts +connectable) %NULL is returned and @error (if non-%NULL) is set +accordingly. + + a #GSocketConnection if successful, or %NULL on error + + a domain name + the name of the service to connect to + a #GCancellable, or %NULL + + + + + + This is the asynchronous version of +g_socket_client_connect_to_service(). + + + + + + a domain name + + + + the name of the service to connect to + + + + a #GCancellable, or %NULL + closure="4"> + a #GAsyncReadyCallback - + user data for the callback + + Finishes an async connect operation. See g_socket_client_connect_to_service_async() + a #GSocketConnection on success, %NULL on error. + a #GAsyncResult. - - + + This is a helper function for g_socket_client_connect(). +Attempts to create a TCP connection with a network URI. +component. If a port is not specified in the URI, @default_port +will be used. +Using this rather than g_socket_client_connect() or +g_socket_client_connect_to_host() allows #GSocketClient to +determine when to use application-specific proxy protocols. +Upon a successful connection, a new #GSocketConnection is constructed +and returned. The caller owns this new object and must drop their +reference to it when finished with it. +In the event of any failure (DNS error, service not found, no hosts +connectable) %NULL is returned and @error (if non-%NULL) is set +accordingly. + + a #GSocketConnection on success, %NULL on error. + + + + + A network URI + + + + the default port to connect to + + + + a #GCancellable, or %NULL + + + + + + This is the asynchronous version of g_socket_client_connect_to_uri(). +When the operation is finished @callback will be +called. You can then call g_socket_client_connect_to_uri_finish() to get +the result of the operation. + + + + + + a network uri + + + + the default port to connect to + + + + a #GCancellable, or %NULL + + + + a #GAsyncReadyCallback + + + + user data for the callback + + + + + + Finishes an async connect operation. See g_socket_client_connect_to_uri_async() + + a #GSocketConnection on success, %NULL on error. + + + + + a #GAsyncResult. + + + + + + Gets the proxy enable state; see g_socket_client_set_enable_proxy() + + whether proxying is enabled + + + + + Gets the socket family of the socket client. +See g_socket_client_set_family() for details. + + a #GSocketFamily + + + + + Gets the local address of the socket client. +See g_socket_client_set_local_address() for details. + + a #GSocketAddres or %NULL. don't free + + + + + Gets the protocol name type of the socket client. +See g_socket_client_set_protocol() for details. + + a #GSocketProtocol + + + + + Gets the socket type of the socket client. +See g_socket_client_set_socket_type() for details. + + a #GSocketFamily + + + + + Gets the I/O timeout time for sockets created by @client. +See g_socket_client_set_timeout() for details. + + the timeout in seconds + + + + + Sets whether or not @client attempts to make connections via a +proxy server. When enabled (the default), #GSocketClient will use a +#GProxyResolver to determine if a proxy protocol such as SOCKS is +needed, and automatically do the necessary proxy negotiation. + + + + + + whether to enable proxies + + + + + + Sets the socket family of the socket client. +If this is set to something other than %G_SOCKET_FAMILY_INVALID +then the sockets created by this object will be of the specified +family. +This might be useful for instance if you want to force the local +connection to be an ipv4 socket, even though the address might +be an ipv6 mapped to ipv4 address. + + + + + + a #GSocketFamily + + + + + + Sets the local address of the socket client. +The sockets created by this object will bound to the +specified address (if not %NULL) before connecting. +This is useful if you want to ensure the the local +side of the connection is on a specific port, or on +a specific interface. + + + + + + a #GSocketAddress, or %NULL + + + + + + Sets the protocol of the socket client. +The sockets created by this object will use of the specified +protocol. +If @protocol is %0 that means to use the default +protocol for the socket family and type. + + + + + + a #GSocketProtocol + + + + + + Sets the socket type of the socket client. +The sockets created by this object will be of the specified +type. +It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM, +as GSocketClient is used for connection oriented services. + + + + + + a #GSocketType + + + + + + Sets the I/O timeout for sockets created by @client. @timeout is a +time in seconds, or 0 for no timeout (the default). +The timeout value affects the initial connection attempt as well, +so setting this may cause calls to g_socket_client_connect(), etc, +to fail with %G_IO_ERROR_TIMED_OUT. + + + + + + the timeout + + + + + + - - + + - - + + - - + + + + + + + + @@ -19323,58 +37337,97 @@ checks for cancellation."> - - + + - - + + - - + + - - + + - - + + - + - + Interface for objects that contain or generate #GSocketAddress<!-- -->es. + + Creates a #GSocketAddressEnumerator for @connectable. + a new #GSocketAddressEnumerator. - + + Creates a #GSocketAddressEnumerator for @connectable that will +return #GProxyAddress<!-- -->es for addresses that you must connect +to via a proxy. +If @connectable does not implement +g_socket_connectable_proxy_enumerate(), this will fall back to +calling g_socket_connectable_enumerate(). + a new #GSocketAddressEnumerator. + + + + + Creates a #GSocketAddressEnumerator for @connectable. + + a new #GSocketAddressEnumerator. + + + + + Creates a #GSocketAddressEnumerator for @connectable that will +return #GProxyAddress<!-- -->es for addresses that you must connect +to via a proxy. +If @connectable does not implement +g_socket_connectable_proxy_enumerate(), this will fall back to +calling g_socket_connectable_enumerate(). + + a new #GSocketAddressEnumerator. @@ -19382,14 +37435,30 @@ checks for cancellation."> + glib:is-gtype-struct-for="SocketConnectable"> + Provides an interface for returning a #GSocketAddressEnumerator +and #GProxyAddressEnumerator - + + a new #GSocketAddressEnumerator. + + + + + + + + + + + + + a new #GSocketAddressEnumerator. @@ -19402,71 +37471,105 @@ checks for cancellation."> + A socket connection GIOStream object for connection-oriented sockets. + + Looks up the #GType to be used when creating socket connections on +sockets with the specified @family,@type and @protocol_id. +If no type is registered, the #GSocketConnection base type is returned. + + a #GType + + + + + a #GSocketFamily + + + + a #GSocketType + + + + a protocol id + + + + + c:identifier="g_socket_connection_factory_register_type" + version="2.22"> + Looks up the #GType to be used when creating socket connections on +sockets with the specified @family,@type and @protocol. +If no type is registered, the #GSocketConnection base type is returned. + a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION + a #GSocketFamily + a #GSocketType - + a protocol id + - - - - - - - - - - - - - - - - - - - - - + Try to get the local address of a socket connection. +Free the returned object with g_object_unref(). + a #GSocketAddress or %NULL on error. + Try to get the remote address of a socket connection. +Free the returned object with g_object_unref(). + a #GSocketAddress or %NULL on error. - - + + Gets the underlying #GSocket object of the connection. +This can be useful if you want to do something unusual on it +not supported by the #GSocketConnection APIs. + + a #GSocketAddress or %NULL on error. + + + + + @@ -19482,130 +37585,174 @@ checks for cancellation."> - - + + - - + + - - + + - - + + - - + + - - + + - + + Base class for socket-type specific control messages that can be sent and +received over #GSocket. + c:identifier="g_socket_control_message_deserialize" + version="2.22"> + Tries to deserialize a socket control message of a given +of #GSocketControlMessage if they can understand this kind +of message and if so deserialize it into a #GSocketControlMessage. +If there is no implementation for this kind of control message, %NULL +will be returned. + the deserialized message or %NULL - + a socket level + - + a socket control message type for the given @level + - + the size of the data in bytes + - + pointer to the message data + - + + Returns the "level" (i.e. the originating protocol) of the control message. +This is often SOL_SOCKET. - + an integer describing the level + - + + Returns the space required for the control message, not including +headers or alignment. - + The number of bytes required. + - + - + + Converts the data in the message to bytes placed in the +message. +returned by g_socket_control_message_get_size() on this +object. - + A buffer to write data to + - - - - - + c:identifier="g_socket_control_message_get_level" + version="2.22"> + Returns the "level" (i.e. the originating protocol) of the control message. +This is often SOL_SOCKET. - + an integer describing the level + + c:identifier="g_socket_control_message_get_msg_type" + version="2.22"> + Returns the protocol specific type of the control message. +For instance, for UNIX fd passing this would be SCM_RIGHTS. - + an integer describing the type of control message + + + + + Returns the space required for the control message, not including +headers or alignment. + + The number of bytes required. + + c:identifier="g_socket_control_message_serialize" + version="2.22"> + Converts the data in the message to bytes placed in the +message. +returned by g_socket_control_message_get_size() on this +object. - + A buffer to write data to + @@ -19624,9 +37771,10 @@ received over #GSocket." - + - + The number of bytes required. + @@ -19637,9 +37785,10 @@ received over #GSocket." - + - + an integer describing the level + @@ -19650,9 +37799,9 @@ received over #GSocket." - + - + @@ -19663,7 +37812,7 @@ received over #GSocket." - + @@ -19673,62 +37822,63 @@ received over #GSocket." c:type="GSocketControlMessage*"/> - + A buffer to write data to + - - - + + + - + - + - + - + - - + + - - + + - - + + - - + + - - + + @@ -19736,16 +37886,17 @@ received over #GSocket." + c:type="GSocketControlMessagePrivate" + disguised="1"> + The protocol family of a #GSocketAddress. (These values are +identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX, +if available.) - + + Creates a new #GSocketListener with no sockets to listen for. +New listeners can be added with e.g. g_socket_listener_add_address() +or g_socket_listener_add_inet_port(). + a new #GSocketListener. @@ -19779,153 +37937,47 @@ if available.)" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Blocks waiting for a client to connect to any of the sockets added +to the listener. Returns a #GSocketConnection for the socket that was +accepted. +If @source_object is not %NULL it will be filled out with the source +object specified when the corresponding socket or address was added +to the listener. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a #GSocketConnection on success, %NULL on error. - + + location where #GObject pointer will be stored, or %NULL + optional #GCancellable object, %NULL to ignore. + c:identifier="g_socket_listener_accept_async" + version="2.22"> + This is the asynchronous version of g_socket_listener_accept(). +When the operation is finished @callback will be +called. You can then call g_socket_listener_accept_socket() +to get the result of the operation. @@ -19933,41 +37985,277 @@ if available.)" + a #GCancellable, or %NULL + closure="2"> + a #GAsyncReadyCallback - + user data for the callback + + Finishes an async accept operation. See g_socket_listener_accept_async() + a #GSocketConnection on success, %NULL on error. + a #GAsyncResult. + Optional #GObject identifying this source - + + Blocks waiting for a client to connect to any of the sockets added +to the listener. Returns the #GSocket that was accepted. +If you want to accept the high-level #GSocketConnection, not a #GSocket, +which is often the case, then you should use g_socket_listener_accept() +instead. +If @source_object is not %NULL it will be filled out with the source +object specified when the corresponding socket or address was added +to the listener. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the cancellable object from another thread. If the operation +was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. + + a #GSocket on success, %NULL on error. + + + + + location where #GObject pointer will be stored, or %NULL. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + This is the asynchronous version of g_socket_listener_accept_socket(). +When the operation is finished @callback will be +called. You can then call g_socket_listener_accept_socket_finish() +to get the result of the operation. + + + + + + a #GCancellable, or %NULL + + + + a #GAsyncReadyCallback + + + + user data for the callback + + + + + + Finishes an async accept operation. See g_socket_listener_accept_socket_async() + + a #GSocket on success, %NULL on error. + + + + + a #GAsyncResult. + + + + Optional #GObject identifying this source + + + + + + Creates a socket of type @type and protocol @protocol, binds +it to @address and adds it to the set of sockets we're accepting +sockets from. +Note that adding an IPv6 address, depending on the platform, +may or may not result in a listener that also accepts IPv4 +connections. For more determinstic behaviour, see +g_socket_listener_add_inet_port(). +to accept to identify this particular source, which is +useful if you're listening on multiple addresses and do +different things depending on what address is connected to. +If successful and @effective_address is non-%NULL then it will +be set to the address that the binding actually occured at. This +is helpful for determining the port number that was used for when +requested, belongs to the caller and must be freed. + + %TRUE on success, %FALSE on error. + + + + + a #GSocketAddress + + + + a #GSocketType + + + + a #GSocketProtocol + + + + Optional #GObject identifying this source + + + + location to store the address that was bound to, or %NULL. + + + + + + Listens for TCP connections on any available port number for both +IPv6 and IPv4 (if each are available). +This is useful if you need to have a socket for incoming connections +but don't care about the specific port number. +to accept to identify this particular source, which is +useful if you're listening on multiple addresses and do +different things depending on what address is connected to. + + the port number, or 0 in case of failure. + + + + + Optional #GObject identifying this source + + + + + + Helper function for g_socket_listener_add_address() that +creates a TCP/IP socket listening on IPv4 and IPv6 (if +supported) on the specified port on all interfaces. +to accept to identify this particular source, which is +useful if you're listening on multiple addresses and do +different things depending on what address is connected to. + + %TRUE on success, %FALSE on error. + + + + + an IP port number (non-zero) + + + + Optional #GObject identifying this source + + + + + + Adds @socket to the set of sockets that we try to accept +new clients from. The socket must be bound to a local +address and listened to. +to accept to identify this particular source, which is +useful if you're listening on multiple addresses and do +different things depending on what address is connected to. + + %TRUE on success, %FALSE on error. + + + + + a listening #GSocket + + + + Optional #GObject identifying this source + + + + + + Closes all the sockets in the listener. - - + + Sets the listen backlog on the sockets in the listener. +See g_socket_set_listen_backlog() for details + + + + + + an integer + + + + + + @@ -19983,7 +38271,7 @@ if available.)" - + @@ -19994,63 +38282,63 @@ if available.)" - - + + - - + + - - + + - - + + - - + + - - + + - + + Flags used in g_socket_receive_message() and g_socket_send_message(). +The flags listed in the enum are some commonly available flags, but the +values used for them are the same as on the platform, and any other flags +are passed in/out as is. So to use a platform specific flag, just include +the right system header and pass in the flag. - + + A protocol identifier is specified when creating a #GSocket, which is a +family/type specific identifier, where 0 means the default protocol for +the particular family/type. +This enum contains a set of commonly available and used protocols. You +can also pass any other identifiers handled by the platform in order to +use protocols not listed here. - + A helper class for handling accepting incomming connections in the +glib mainloop. + + Creates a new #GSocketService with no sockets to listen for. +New listeners can be added with e.g. g_socket_listener_add_address() +or g_socket_listener_add_inet_port(). + a new #GSocketService. - + + Check whether the service is active or not. An active +service will accept new clients that connect, while +a non-active service will let connecting clients queue +up until the service is started. + + %TRUE if the service is active, %FALSE otherwise + + + + + Starts the service, i.e. start accepting connections +from the added sockets when the mainloop runs. +This call is threadsafe, so it may be called from a thread +handling an incomming client request. - + + Stops the service, i.e. stops accepting connections +from the added sockets when the mainloop runs. +This call is threadsafe, so it may be called from a thread +handling an incomming client request. - - - - - - - - + + The ::incoming signal is emitted when a new incoming connection +to @service needs to be handled. The handler must initiate the +handling of @connection, but may not block; in essence, +asynchronous operations must be used. + + %TRUE to stop other handlers from being called + - + a new #GSocketConnection object. + - + the source_object passed to g_socket_listener_add_address(). + @@ -20158,9 +38477,9 @@ glib mainloop." - + - + @@ -20175,80 +38494,84 @@ glib mainloop." - - + + - - + + - - + + - - + + - - + + - - + + - + + This is the function type of the callback used for the #GSource +returned by g_socket_create_source(). - + it should return %FALSE if the source should be removed. + + the #GSocket - + the current condition at the source fired. + - + data passed in by the user. + + Flags used when creating a #GSocket. Some protocols may not implement +all the socket types. - + glib:get-type="g_srv_target_get_type" + c:symbol-prefix="srv_target"> + A single target host/port that a network service is running on. + + Creates a new #GSrvTarget with the given parameters. +You should not need to use this; normally #GSrvTarget<!-- -->s are +created by #GResolver. + a new #GSrvTarget. + the host that the service is running on - + the port that the service is running on + - + the target's priority + - + the target's weight + - + + Copies @target + a copy of @target - + + Frees @target - + + Gets @target's hostname (in ASCII form; if you are going to present +this to the user, you should use g_hostname_is_ascii_encoded() to +check if it contains encoded Unicode segments, and use +g_hostname_to_unicode() to convert it if it does.) + @target's hostname - + + Gets @target's port - + @target's port + - + + Gets @target's priority. You should not need to look at this; +#GResolver already sorts the targets according to the algorithm in +RFC 2782. - + @target's priority + - + + Gets @target's weight. You should not need to look at this; +#GResolver already sorts the targets according to the algorithm in +RFC 2782. - + @target's weight + + A #GSocketConnection for UNIX domain socket connections. + + Checks if graceful disconnects are used. See +g_tcp_connection_set_graceful_disconnect(). + + %TRUE if graceful disconnect is used on close, %FALSE otherwise + + + + c:identifier="g_tcp_connection_set_graceful_disconnect" + version="2.22"> + This enabled graceful disconnects on close. A graceful disconnect +means that we signal the recieving end that the connection is terminated +and wait for it to close the connection before closing the connection. +A graceful disconnect means that we can be sure that we successfully sent +all the outstanding data to the other end, or get an error reported. +However, it also means we have to wait for all the data to reach the +other side and for it to acknowledge this by closing the socket, which may +take a while. For this reason it is disabled by default. - + Whether to do graceful disconnects or not + - - - - - - - + + @@ -20362,115 +38738,192 @@ all the socket types." - + + An implementation of #GIcon for themed icons. - + + Creates a new themed icon for @iconname. - + a new #GThemedIcon. + + a string containing an icon name. - - + + + Creates a new themed icon for @iconnames. - - - - - - - - - - - + a new #GThemedIcon + - - - + an array of strings containing icon names. + - + the length of the @iconnames array, or -1 if @iconnames is %NULL-terminated + - - - - + + + Creates a new themed icon for @iconname, and all the names +that can be created by shortening @iconname at '-' characters. +In the following example, @icon1 and @icon2 are equivalent: +|[ +const char *names[] = { +"gnome-dev-cdrom-audio", +"gnome-dev-cdrom", +"gnome-dev", +"gnome" +}; +icon1 = g_themed_icon_new_from_names (names, 4); +icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio"); +]| + + a new #GThemedIcon. + + a string containing an icon name - + + Append a name to the list of icons from within @icon. +<note><para> +Note that doing so invalidates the hash computed by prior calls +to g_icon_hash(). +</para></note> + name of icon to append to list of icons from within @icon. + Gets the names of icons from within @icon. + a list of icon names. - - + + Prepend a name to the list of icons from within @icon. +<note><para> +Note that doing so invalidates the hash computed by prior calls +to g_icon_hash(). +</para></note> + + + + + + name of icon to prepend to list of icons from within @icon. + + + + + + The icon name. + - - + + A %NULL-terminated array of icon names. + - - + + Whether to use the default fallbacks found by shortening the icon name +at '-' characters. If the "names" array has more than one element, +ignores any past the first. +For example, if the icon name was "gnome-dev-cdrom-audio", the array +would become +|[ +{ +"gnome-dev-cdrom-audio", +"gnome-dev-cdrom", +"gnome-dev", +"gnome", +NULL +}; +]| + - + A helper class for handling accepting incomming connections in the +glib mainloop and handling them in a thread. + + Creates a new #GThreadedSocketService with no listeners. Listeners +must be added with g_socket_service_add_listeners(). - + a new #GSocketService. + - + the maximal number of threads to execute concurrently handling incoming clients, -1 means no limit + - - + + @@ -20480,15 +38933,21 @@ glib mainloop and handling them in a thread." c:type="GThreadedSocketServicePrivate*"/> - - + The ::run signal is emitted in a worker thread in response to an +incoming connection. This thread is dedicated to handling +not return until the connection is closed. + + %TRUE to stope further signal handlers from being called + - + a new #GSocketConnection object. + - + the source_object passed to g_socket_listener_add_address(). + @@ -20500,9 +38959,9 @@ glib mainloop and handling them in a thread." - + - + @@ -20518,36 +38977,36 @@ glib mainloop and handling them in a thread." - - + + - - + + - - + + - - + + - - + + @@ -20555,41 +39014,114 @@ glib mainloop and handling them in a thread." + c:type="GThreadedSocketServicePrivate" + disguised="1"> - - - + Receives credentials from the sending end of the connection. The +sending end has to call g_unix_connection_send_credentials() (or +similar) for this to work. +As well as reading the credentials this also reads (and discards) a +single byte from the stream, as this is required for credentials +passing to work on some implementations. +Other ways to exchange credentials with a foreign peer includes the +#GUnixCredentialsMessage type and g_socket_get_credentials() function. +g_object_unref()), %NULL if @error is set. + + Received credentials on success (free with + - - - + A #GCancellable or %NULL. + Receives a file descriptor from the sending end of the connection. +The sending end has to call g_unix_connection_send_fd() for this +to work. +As well as reading the fd this also reads a single byte from the +stream, as this is required for fd passing to work on some +implementations. - + a file descriptor on success, -1 on error. + + optional #GCancellable object, %NULL to ignore + + + + + + Passes the credentials of the current user the receiving side +of the connection. The recieving end has to call +g_unix_connection_receive_credentials() (or similar) to accept the +credentials. +As well as sending the credentials this also writes a single NUL +byte to the stream, as this is required for credentials passing to +work on some implementations. +Other ways to exchange credentials with a foreign peer includes the +#GUnixCredentialsMessage type and g_socket_get_credentials() function. + + %TRUE on success, %FALSE if @error is set. + + + + + A #GCancellable or %NULL. + + + + + + Passes a file descriptor to the recieving side of the +connection. The recieving end has to call g_unix_connection_receive_fd() +to accept the file descriptor. +As well as sending the fd this also writes a single byte to the +stream, as this is required for fd passing to work on some +implementations. + + a %TRUE on success, %NULL on error. + + + + + a file descriptor + + + + optional #GCancellable object, %NULL to ignore. @@ -20608,75 +39140,248 @@ glib mainloop and handling them in a thread." - + + + + The #GUnixCredentialsMessage structure contains only private data +and should only be accessed using the provided API. + + Creates a new #GUnixCredentialsMessage with credentials matching the current processes. + + a new #GUnixCredentialsMessage + + + + + Creates a new #GUnixCredentialsMessage holding @credentials. + + a new #GUnixCredentialsMessage + + + + + A #GCredentials object. + + + + + + Checks if passing a #GCredential on a #GSocket is supported on this platform. + + %TRUE if supported, %FALSE otherwise + + + + + Gets the credentials stored in @message. + + A #GCredentials instance. Do not free, it is owned by @message. + + + + + The credentials stored in the message. + + + + + + + + + + + Class structure for #GUnixCredentialsMessage. + + + + + + + + + + + + + + + + + + + - + + Creates a new #GUnixFDList containing no file descriptors. + a new #GUnixFDList + c:identifier="g_unix_fd_list_new_from_array" + version="2.24"> + Creates a new #GUnixFDList containing the file descriptors given in +may no longer be used by the caller. The array itself is owned by +the caller. +Each file descriptor in the array should be set to close-on-exec. +If @n_fds is -1 then @fds must be terminated with -1. + a new #GUnixFDList - - + + the initial list of file descriptors + - + the length of #fds, or -1 + - + + Adds a file descriptor to @list. +The file descriptor is duplicated using dup(). You keep your copy +of the descriptor and the copy contained in @list will be closed +when @list is finalized. +A possible cause of failure is exceeding the per-process or +system-wide file descriptor limit. +The index of the file descriptor in the list is returned. If you use +this index with g_unix_fd_list_get() then you will receive back a +duplicated copy of the same file descriptor. +(and @error is set) - + the index of the appended fd in case of success, else -1 + - + a valid open file descriptor + - + + Gets a file descriptor out of @list. +programmer error for @index_ to be out of range; see +g_unix_fd_list_get_length(). +The file descriptor is duplicated using dup() and set as +close-on-exec before being returned. You must call close() on it +when you are done. +A possible cause of failure is exceeding the per-process or +system-wide file descriptor limit. - - - - - - + the file descriptor, or -1 in case of error + - + the index into the list + - + + contained within). - + the length of @list + + + + + Returns the array of file descriptors that is contained in this +object. +After this call, the descriptors remain the property of @list. The +caller must not close them and must not free the array. The array is +valid only until @list is changed in any way. +If @length is non-%NULL then it is set to the number of file +descriptors in the returned array. The returned array is also +terminated with -1. +This function never returns %NULL. In case there are no file +descriptors contained in @list, an empty array is returned. + + an array of file descriptors + - - + + pointer to the length of the returned array, or %NULL + - - - + + Returns the array of file descriptors that is contained in this +object. +After this call, the descriptors are no longer contained in +descriptors have been added). +The return result of this function must be freed with g_free(). +The caller is also responsible for closing all of the file +descriptors. The file descriptors in the array are set to +close-on-exec. +If @length is non-%NULL then it is set to the number of file +descriptors in the returned array. The returned array is also +terminated with -1. +This function never returns %NULL. In case there are no file +descriptors contained in @list, an empty array is returned. + + an array of file descriptors + - - + + pointer to the length of the returned array, or %NULL + @@ -20693,95 +39398,139 @@ glib mainloop and handling them in a thread." - - + + - - + + - - + + - - + + - - + + - + - + + Creates a new #GUnixFDMessage containing an empty file descriptor +list. - + a new #GUnixFDMessage + + + + + Creates a new #GUnixFDMessage containing @list. + + a new #GUnixFDMessage + + a #GUnixFDList - - - - - - - - - - - - - - - - - - - - + Adds a file descriptor to @message. +The file descriptor is duplicated using dup(). You keep your copy +of the descriptor and the copy contained in @message will be closed +when @message is finalized. +A possible cause of failure is exceeding the per-process or +system-wide file descriptor limit. - + %TRUE in case of success, else %FALSE (and @error is set) + - + a valid open file descriptor + - - + + Gets the #GUnixFDList contained in @message. This function does not +return a reference to the caller, but the returned list is valid for +the lifetime of @message. + + the #GUnixFDList from @message + + + + + Returns the array of file descriptors that is contained in this +object. +After this call, the descriptors are no longer contained in +descriptors have been added). +The return result of this function must be freed with g_free(). +The caller is also responsible for closing all of the file +descriptors. +If @length is non-%NULL then it is set to the number of file +descriptors in the returned array. The returned array is also +terminated with -1. +This function never returns %NULL. In case there are no file +descriptors contained in @message, an empty array is returned. + + an array of file descriptors + + + + + pointer to the length of the returned array, or %NULL + + + + + + @@ -20797,70 +39546,100 @@ glib mainloop and handling them in a thread." - - + + - - + + - + + Implements #GInputStream for reading from selectable unix file descriptors + Creates a new #GUnixInputStream for the given @fd. +If @close_fd is %TRUE, the file descriptor will be closed +when the stream is closed. - + a new #GUnixInputStream + - + a UNIX file descriptor + - + %TRUE to close the file descriptor when done + + + Returns whether the file descriptor of @stream will be +closed when the stream is closed. + + %TRUE if the file descriptor is closed when done + + + + + Return the UNIX file descriptor that the stream reads from. + + The file descriptor of @stream + + + + c:identifier="g_unix_input_stream_set_close_fd" + version="2.20"> + Sets whether the file descriptor of @stream shall be closed +when the stream is closed. - + %TRUE to close the file descriptor when done + - - - - - - - - - - - - + + Whether to close the file descriptor when the stream is closed. + - - + + The file descriptor that the stream reads from. + @@ -20875,203 +39654,269 @@ glib mainloop and handling them in a thread." - - + + - - + + - - + + - - + + - - + + - + - + + Defines a Unix mount entry (e.g. <filename>/media/cdrom</filename>). +This corresponds roughly to a mtab entry. + Watches #GUnixMount<!-- -->s for changes. + Gets a new #GUnixMountMonitor. The default rate limit for which the +monitor will report consecutive changes for the mount and mount +point entry files is the default for a #GFileMonitor. Use +g_unix_mount_monitor_set_rate_limit() to change this. + a #GUnixMountMonitor. + c:identifier="g_unix_mount_monitor_set_rate_limit" + version="2.18"> + Sets the rate limit to which the @mount_monitor will report +consecutive change events to the mount and mount point entry files. - + a integer with the limit in milliseconds to poll for changes. + - - + Emitted when the unix mount points have changed. + + - - + Emitted when the unix mounts have changed. + + - - - - - - + + Defines a Unix mount point (e.g. <filename>/dev</filename>). +This corresponds roughly to a fstab entry. + Compares two unix mount points. +or less than @mount2, respectively. - + 1, 0 or -1 if @mount1 is greater than, equal to, + + a #GUnixMount. - + + Frees a unix mount point. - + + Gets the device path for a unix mount point. + a string containing the device path. + Gets the file system type for the mount point. + a string containing the file system type. - + + Gets the mount path for a unix mount point. - - - - - - - - - - - + a string containing the mount path. + + Guesses whether a Unix mount point can be ejected. - - - - - - + %TRUE if @mount_point is deemed to be ejectable. + + Guesses the icon of a Unix mount point. + a #GIcon + + Guesses the name of a Unix mount point. +The result is a translated string. +be freed with g_free() + + A newly allocated string that must + + + + + Checks if a unix mount point is a loopback device. + + %TRUE if the mount point is a loopback. %FALSE otherwise. + + + + + Checks if a unix mount point is read only. + + %TRUE if a mount point is read only. + + + + + Checks if a unix mount point is mountable by the user. + + %TRUE if the mount point is user mountable. + + + + Implements #GOutputStream for outputting to selectable unix file descriptors + Creates a new #GUnixOutputStream for the given @fd. +If @close_fd, is %TRUE, the file descriptor will be closed when +the output stream is destroyed. - + a new #GOutputStream + - + a UNIX file descriptor + - + %TRUE to close the file descriptor when done + + + Returns whether the file descriptor of @stream will be +closed when the stream is closed. + + %TRUE if the file descriptor is closed when done + + + + + Return the UNIX file descriptor that the stream writes to. + + The file descriptor of @stream + + + + c:identifier="g_unix_output_stream_set_close_fd" + version="2.20"> + Sets whether the file descriptor of @stream shall be closed +when the stream is closed. - + %TRUE to close the file descriptor when done + - - - - - - - - - - - - + + Whether to close the file descriptor when the stream is closed. + - - + + The file descriptor that the stream writes to. + @@ -21087,106 +39932,218 @@ This corresponds roughly to a fstab entry."> - - + + - - + + - - + + - - + + - - + + - + + A UNIX-domain (local) socket address, corresponding to a +<type>struct sockaddr_un</type>. - + + Creates a new #GUnixSocketAddress for @path. +To create abstract socket addresses, on systems that support that, +use g_unix_socket_address_new_abstract(). - + a new #GUnixSocketAddress + + the socket path + c:identifier="g_unix_socket_address_new_abstract" + deprecated="Use g_unix_socket_address_new_with_type()."> + Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED +#GUnixSocketAddress for @path. - + a new #GUnixSocketAddress + + the abstract name - + the length of @path, or -1 + + + + + + Creates a new #GUnixSocketAddress of type @type with name @path. +If @type is %G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to +calling g_unix_socket_address_new(). +If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT, then @path_len +bytes of @path will be copied to the socket's path, and only those +bytes will be considered part of the name. (If @path_len is -1, +then @path is assumed to be NUL-terminated.) For example, if @path +was "test", then calling g_socket_address_get_native_size() on the +returned socket would return 7 (2 bytes of overhead, 1 byte for the +abstract-socket indicator byte, and 4 bytes for the name "test"). +If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED, then +rest of the path will be padded with 0 bytes, and the entire +zero-padded buffer will be considered the name. (As above, if +this case, g_socket_address_get_native_size() will always return +the full size of a <literal>struct sockaddr_un</literal>, although +g_unix_socket_address_get_path_len() will still return just the +length of @path. +%G_UNIX_SOCKET_ADDRESS_ABSTRACT is preferred over +%G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED for new programs. Of course, +when connecting to a server created by another process, you must +use the appropriate type corresponding to how that process created +its listening socket. + + a new #GUnixSocketAddress + + + + + the name + + + + the length of @path, or -1 + + + + a #GUnixSocketAddressType + + c:identifier="g_unix_socket_address_abstract_names_supported" + version="2.22"> + Checks if abstract unix domain socket names are supported. - + %TRUE if supported, %FALSE otherwise + - + + Gets @address's type. + a #GUnixSocketAddressType + + + + + Tests if @address is abstract. + + %TRUE if the address is abstract, %FALSE otherwise + + + + + Gets @address's path, or for abstract sockets the "name". +Guaranteed to be zero-terminated, but an abstract socket +may contain embedded zeros, and thus you should use +g_unix_socket_address_get_path_len() to get the true length +of this string. + + the path for @address + c:identifier="g_unix_socket_address_get_path_len" + version="2.22"> + Gets the length of @address's path. +For details, see g_unix_socket_address_get_path(). - + the length of the path + - - - - - - - + + Whether or not this is an abstract address +distinguishes between zero-padded and non-zero-padded +abstract addresses. + - - + + - - + + + + + + + @@ -21203,120 +40160,92 @@ This corresponds roughly to a fstab entry."> - + + + The type of name used by a #GUnixSocketAddress. +%G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain +socket bound to a filesystem path. %G_UNIX_SOCKET_ADDRESS_ANONYMOUS +indicates a socket not bound to any name (eg, a client-side socket, +or a socket created with socketpair()). +For abstract sockets, there are two incompatible ways of naming +sockaddr_un</literal> as the name, padding the unused parts of the +%sun_path field with zeroes; this corresponds to +%G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED. However, many programs +instead just use a portion of %sun_path, and pass an appropriate +smaller length to bind() or connect(). This is +%G_UNIX_SOCKET_ADDRESS_ABSTRACT. + + + + + + - + - + - + - + - + - + - + + Virtual File System object. - + Gets the default #GVfs for the system. + + a #GVfs. - + Gets the local #GVfs for the system. + + a #GVfs. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -21328,28 +40257,57 @@ This corresponds roughly to a fstab entry."> - - - + + Gets a #GFile for @path. +Free the returned object with g_object_unref(). + + a #GFile. + - + + a string containing a VFS path. - - - - - - - - - - + + Gets a #GFile for @uri. +This operation never fails, but the returned object +might not support any I/O operation if the URI +is malformed or if the URI scheme is not supported. +Free the returned object with g_object_unref(). + + a #GFile. + + + + + a string containing a URI + + + + + + Gets a list of URI schemes supported by @vfs. +The returned array belongs to GIO and must +not be freed or modified. + + a %NULL-terminated array of strings. + + + + + + + Checks if the VFS is active. + + %TRUE if construction of the @vfs was successful and it is now active. + + + + @@ -21357,6 +40315,26 @@ This corresponds roughly to a fstab entry."> + + + + + + + + + + + + + + + + + + @@ -21372,45 +40350,113 @@ This corresponds roughly to a fstab entry."> - + - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + This operation never fails, but the returned object might +not support any I/O operations if the @parse_name cannot +be parsed by the #GVfs module. +Free the returned object with g_object_unref(). + a #GFile for the given @parse_name. + + + + + a string to be parsed by the VFS module. + + + + + + Gets a #GFile for @path. +Free the returned object with g_object_unref(). + + a #GFile. + a string containing a VFS path. + Gets a #GFile for @uri. +This operation never fails, but the returned object +might not support any I/O operation if the URI +is malformed or if the URI scheme is not supported. +Free the returned object with g_object_unref(). + a #GFile. + a string containing a URI - + Gets a list of URI schemes supported by @vfs. +The returned array belongs to GIO and must +not be freed or modified. + + a %NULL-terminated array of strings. + + Checks if the VFS is active. + + %TRUE if construction of the @vfs was successful and it is now active. + + + + This operation never fails, but the returned object might +not support any I/O operations if the @parse_name cannot +be parsed by the #GVfs module. +Free the returned object with g_object_unref(). + a #GFile for the given @parse_name. + a string to be parsed by the VFS module. @@ -21424,9 +40470,10 @@ This corresponds roughly to a fstab entry."> - + - + %TRUE if construction of the @vfs was successful and it is now active. + @@ -21436,8 +40483,9 @@ This corresponds roughly to a fstab entry."> - + + a #GFile. @@ -21445,14 +40493,16 @@ This corresponds roughly to a fstab entry."> + a string containing a VFS path. - + + a #GFile. @@ -21460,15 +40510,16 @@ This corresponds roughly to a fstab entry."> + a string containing a URI - - + + + a %NULL-terminated array of strings. @@ -21481,8 +40532,9 @@ This corresponds roughly to a fstab entry."> - + + a #GFile for the given @parse_name. @@ -21490,13 +40542,14 @@ This corresponds roughly to a fstab entry."> + a string to be parsed by the VFS module. - + @@ -21508,7 +40561,7 @@ This corresponds roughly to a fstab entry."> - + - + - + - + - + @@ -21549,11 +40601,9 @@ This corresponds roughly to a fstab entry."> - + - + @@ -21568,16 +40618,14 @@ This corresponds roughly to a fstab entry."> - + - + @@ -21592,7 +40640,7 @@ This corresponds roughly to a fstab entry."> - + @@ -21609,50 +40657,50 @@ This corresponds roughly to a fstab entry."> - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -21660,383 +40708,612 @@ This corresponds roughly to a fstab entry."> - - - - - - - - - - - - - - - - - - - - - - - + Opaque mountable volume object. + + Checks if a volume can be ejected. + + %TRUE if the @volume can be ejected. %FALSE otherwise. + + Checks if a volume can be mounted. - + %TRUE if the @volume can be mounted. %FALSE otherwise. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Ejects a volume. This is an asynchronous operation, and is +finished by calling g_volume_eject_finish() with the @volume +and #GAsyncResult returned in the @callback. + flags affecting the unmount if required for eject - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + optional #GCancellable object, %NULL to ignore. + closure="3"> + a #GAsyncReadyCallback, or %NULL. - - + + user data that gets passed to @callback + - - + + + Finishes ejecting a volume. If any errors occured during the operation, - + %TRUE, %FALSE if operation failed. + + a #GAsyncResult. - - + + + Ejects a volume. This is an asynchronous operation, and is +finished by calling g_volume_eject_with_operation_finish() with the @volume +and #GAsyncResult data returned in the @callback. + flags affecting the unmount if required for eject + + a #GMountOperation or %NULL to avoid user interaction. + + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a volume. If any errors occurred during the operation, + + %TRUE if the volume was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + + + + + Gets the kinds of <link linkend="volume-identifier">identifiers</link> +that @volume has. Use g_volume_get_identifer() to obtain +the identifiers themselves. +of strings containing kinds of identifiers. Use g_strfreev() to free. + + a %NULL-terminated array + + + + + + + Gets the activation root for a #GVolume if it is known ahead of +mount time. Returns %NULL otherwise. If not %NULL and if @volume +is mounted, then the result of g_mount_get_root() on the +#GMount object obtained from g_volume_get_mount() will always +either be equal or a prefix of what this function returns. In +other words, in code +<programlisting> +GMount *mount; +GFile *mount_root +GFile *volume_activation_root; +mount = g_volume_get_mount (volume); /&ast; mounted, so never NULL &ast;/ +mount_root = g_mount_get_root (mount); +volume_activation_root = g_volume_get_activation_root(volume); /&ast; assume not NULL &ast;/ +</programlisting> +then the expression +<programlisting> +(g_file_has_prefix (volume_activation_root, mount_root) || +</programlisting> +will always be %TRUE. +Activation roots are typically used in #GVolumeMonitor +implementations to find the underlying mount to shadow, see +g_mount_is_shadowed() for more details. +g_object_unref() to free. + + the activation root of @volume or %NULL. Use + + + + + Gets the drive for the @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GDrive or %NULL if @volume is not associated with a drive. + + + + + Gets the icon for @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GIcon. + + + + + Gets the identifier of the given kind for @volume. +See the <link linkend="volume-identifier">introduction</link> +for more information about volume identifiers. +requested identfier, or %NULL if the #GVolume +doesn't have this kind of identifier + + a newly allocated string containing the + + + + + the kind of identifier to return + + + + + + Gets the mount for the @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GMount or %NULL if @volume isn't mounted. + + + + + Gets the name of @volume. +be freed with g_free() when no longer needed. + + the name for the given @volume. The returned string should + + + + + Gets the UUID for the @volume. The reference is typically based on +the file system UUID for the volume in question and should be +considered an opaque string. Returns %NULL if there is no UUID +available. +The returned string should be freed with g_free() +when no longer needed. + + the UUID for @volume or %NULL if no UUID can be computed. + + + + + Finishes mounting a volume. If any errors occured during the operation, +If the mount operation succeeded, g_volume_get_mount() on @volume +is guaranteed to return the mount right after calling this +function; there's no need to listen for the 'mount-added' signal on +#GVolumeMonitor. + + %TRUE, %FALSE if operation failed. + + + + + a #GAsyncResult + + + + + + Mounts a volume. This is an asynchronous operation, and is +finished by calling g_volume_mount_finish() with the @volume +and #GAsyncResult returned in the @callback. + + + + + + flags affecting the operation + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data that gets passed to @callback + + + + + + Returns whether the volume should be automatically mounted. + + %TRUE if the volume should be automatically mounted. + + + + + Checks if a volume can be ejected. + + %TRUE if the @volume can be ejected. %FALSE otherwise. + + + + + Checks if a volume can be mounted. + + %TRUE if the @volume can be mounted. %FALSE otherwise. + + + + + Ejects a volume. This is an asynchronous operation, and is +finished by calling g_volume_eject_finish() with the @volume +and #GAsyncResult returned in the @callback. + + + + + + flags affecting the unmount if required for eject + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. - + user data that gets passed to @callback + + Finishes ejecting a volume. If any errors occured during the operation, - + %TRUE, %FALSE if operation failed. + + a #GAsyncResult. - - - + + Ejects a volume. This is an asynchronous operation, and is +finished by calling g_volume_eject_with_operation_finish() with the @volume +and #GAsyncResult data returned in the @callback. + + - - + + flags affecting the unmount if required for eject + + + + a #GMountOperation or %NULL to avoid user interaction. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback, or %NULL. + + + + user data passed to @callback. + + + + + + Finishes ejecting a volume. If any errors occurred during the operation, + + %TRUE if the volume was successfully ejected. %FALSE otherwise. + + + + + a #GAsyncResult. + + Gets the kinds of <link linkend="volume-identifier">identifiers</link> +that @volume has. Use g_volume_get_identifer() to obtain +the identifiers themselves. +of strings containing kinds of identifiers. Use g_strfreev() to free. + a %NULL-terminated array + c:identifier="g_volume_get_activation_root" + version="2.18"> + Gets the activation root for a #GVolume if it is known ahead of +mount time. Returns %NULL otherwise. If not %NULL and if @volume +is mounted, then the result of g_mount_get_root() on the +#GMount object obtained from g_volume_get_mount() will always +either be equal or a prefix of what this function returns. In +other words, in code +<programlisting> +GMount *mount; +GFile *mount_root +GFile *volume_activation_root; +mount = g_volume_get_mount (volume); /&ast; mounted, so never NULL &ast;/ +mount_root = g_mount_get_root (mount); +volume_activation_root = g_volume_get_activation_root(volume); /&ast; assume not NULL &ast;/ +</programlisting> +then the expression +<programlisting> +(g_file_has_prefix (volume_activation_root, mount_root) || +</programlisting> +will always be %TRUE. +Activation roots are typically used in #GVolumeMonitor +implementations to find the underlying mount to shadow, see +g_mount_is_shadowed() for more details. +g_object_unref() to free. + the activation root of @volume or %NULL. Use - + + Gets the drive for the @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GDrive or %NULL if @volume is not associated with a drive. + + + + + Gets the icon for @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GIcon. + + + + + Gets the identifier of the given kind for @volume. +See the <link linkend="volume-identifier">introduction</link> +for more information about volume identifiers. +requested identfier, or %NULL if the #GVolume +doesn't have this kind of identifier + + a newly allocated string containing the + + + + + the kind of identifier to return + + + + + + Gets the mount for the @volume. +The returned object should be unreffed with g_object_unref() +when no longer needed. + + a #GMount or %NULL if @volume isn't mounted. + + + + + Gets the name of @volume. +be freed with g_free() when no longer needed. + + the name for the given @volume. The returned string should + + + + + Gets the UUID for the @volume. The reference is typically based on +the file system UUID for the volume in question and should be +considered an opaque string. Returns %NULL if there is no UUID +available. +The returned string should be freed with g_free() +when no longer needed. + + the UUID for @volume or %NULL if no UUID can be computed. + + + + + Mounts a volume. This is an asynchronous operation, and is +finished by calling g_volume_mount_finish() with the @volume +and #GAsyncResult returned in the @callback. - + flags affecting the operation + - + + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. + closure="4"> + a #GAsyncReadyCallback, or %NULL. - + user data that gets passed to @callback + - + Finishes mounting a volume. If any errors occured during the operation, +If the mount operation succeeded, g_volume_get_mount() on @volume +is guaranteed to return the mount right after calling this +function; there's no need to listen for the 'mount-added' signal on +#GVolumeMonitor. - + %TRUE, %FALSE if operation failed. + + a #GAsyncResult + + Returns whether the volume should be automatically mounted. + + %TRUE if the volume should be automatically mounted. + + + - - + Emitted when the volume has been changed. + + - - + This signal is emitted when the #GVolume have been removed. If +the recipient is holding references to the object they should +release them so the object can be finalized. + + + glib:is-gtype-struct-for="Volume"> + Interface for implementing operations for mountable volumes. - + @@ -22048,7 +41325,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22060,8 +41337,9 @@ Interface for implementing operations for mountable volumes."> - + + the name for the given @volume. The returned string should @@ -22072,8 +41350,9 @@ Interface for implementing operations for mountable volumes."> - + + a #GIcon. @@ -22084,8 +41363,9 @@ Interface for implementing operations for mountable volumes."> - + + the UUID for @volume or %NULL if no UUID can be computed. @@ -22096,8 +41376,9 @@ Interface for implementing operations for mountable volumes."> - + + a #GDrive or %NULL if @volume is not associated with a drive. @@ -22108,8 +41389,9 @@ Interface for implementing operations for mountable volumes."> - + + a #GMount or %NULL if @volume isn't mounted. @@ -22120,9 +41402,10 @@ Interface for implementing operations for mountable volumes."> - + - + %TRUE if the @volume can be mounted. %FALSE otherwise. + @@ -22132,9 +41415,10 @@ Interface for implementing operations for mountable volumes."> - + - + %TRUE if the @volume can be ejected. %FALSE otherwise. + @@ -22144,7 +41428,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22153,42 +41437,54 @@ Interface for implementing operations for mountable volumes."> + flags affecting the operation - + + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data that gets passed to @callback + - + - + %TRUE, %FALSE if operation failed. + + a #GAsyncResult - + @@ -22197,40 +41493,50 @@ Interface for implementing operations for mountable volumes."> + flags affecting the unmount if required for eject + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data that gets passed to @callback + - + - + %TRUE, %FALSE if operation failed. + + a #GAsyncResult. - + + a newly allocated string containing the @@ -22238,14 +41544,16 @@ Interface for implementing operations for mountable volumes."> + the kind of identifier to return - + + a %NULL-terminated array @@ -22258,9 +41566,10 @@ Interface for implementing operations for mountable volumes."> - + - + %TRUE if the volume should be automatically mounted. + @@ -22270,8 +41579,9 @@ Interface for implementing operations for mountable volumes."> - + + the activation root of @volume or %NULL. Use @@ -22282,7 +41592,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22291,37 +41601,45 @@ Interface for implementing operations for mountable volumes."> + flags affecting the unmount if required for eject + a #GMountOperation or %NULL to avoid user interaction. + optional #GCancellable object, %NULL to ignore. - + + a #GAsyncReadyCallback, or %NULL. - + user data passed to @callback. + - + - + %TRUE if the volume was successfully ejected. %FALSE otherwise. + + a #GAsyncResult. @@ -22329,81 +41647,159 @@ Interface for implementing operations for mountable volumes."> - - - - - + A Volume Monitor that watches for volume events. + c:identifier="g_volume_monitor_adopt_orphan_mount" + deprecated="Instead of using this function, #GVolumeMonitor" + deprecated-version="2.20"> + This function should be called by any #GVolumeMonitor +implementation when a new #GMount object is created that is not +associated with a #GVolume object. It must be called just before +emitting the @mount_added signal. +If the return value is not %NULL, the caller must associate the +returned #GVolume object with the #GMount. This involves returning +it in its g_mount_get_volume() implementation. The caller must +also listen for the "removed" signal on the returned object +and give up its reference when handling that signal +Similary, if implementing g_volume_monitor_adopt_orphan_mount(), +the implementor must take a reference to @mount and return it in +its g_volume_get_mount() implemented. Also, the implementor must +listen for the "unmounted" signal on @mount and give up its +reference upon handling that signal. +There are two main use cases for this function. +One is when implementing a user space file system driver that reads +blocks of a block device that is already represented by the native +volume monitor (for example a CD Audio file system driver). Such +a driver will generate its own #GMount object that needs to be +assoicated with the #GVolume object that represents the volume. +The other is for implementing a #GVolumeMonitor whose sole purpose +is to return #GVolume objects representing entries in the users +"favorite servers" list or similar. +if no wants to adopt the #GMount. +implementations should instead create shadow mounts with the URI of +the mount they intend to adopt. See the proxy volume monitor in +gvfs for an example of this. Also see g_mount_is_shadowed(), +g_mount_shadow() and g_mount_unshadow() functions. + the #GVolume object that is the parent for @mount or %NULL + a #GMount object to find a parent for + + Gets the volume monitor used by gio. +g_object_unref() when done with it. + + a reference to the #GVolumeMonitor used by gio. Call + + + + Gets a list of drives connected to the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). - + a #GList of connected #GDrive objects. + + + - - - - - - - - - - - - - - - - - - - - + Finds a #GMount object by its UUID (see g_mount_get_uuid()) +Free the returned object with g_object_unref(). + a #GMount or %NULL if no such mount is available. + the UUID to look for + + Gets a list of the mounts on the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + + a #GList of #GMount objects. + + + + + + + Finds a #GVolume object by its UUID (see g_volume_get_uuid()) +Free the returned object with g_object_unref(). + + a #GVolume or %NULL if no such volume is available. + + + + + the UUID to look for + + + + + + Gets a list of the volumes on the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + + a #GList of #GVolume objects. + + + + + + Gets a list of drives connected to the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + a #GList of connected #GDrive objects. - + + Finds a #GMount object by its UUID (see g_mount_get_uuid()) +Free the returned object with g_object_unref(). - - - + a #GMount or %NULL if no such mount is available. + + + + the UUID to look for + + + + Gets a list of the mounts on the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). + a #GList of #GMount objects. @@ -22411,149 +41807,177 @@ Interface for implementing operations for mountable volumes."> + Finds a #GVolume object by its UUID (see g_volume_get_uuid()) +Free the returned object with g_object_unref(). + a #GVolume or %NULL if no such volume is available. + the UUID to look for - + + Gets a list of the volumes on the system. +The returned list should be freed with g_list_free(), after +its elements have been unreffed with g_object_unref(). - + a #GList of #GVolume objects. + + + - - - - - - + - - + Emitted when a drive changes. + + - + the drive that changed + - - + Emitted when a drive is connected to the system. + + - + a #GDrive that was connected. + - - + Emitted when a drive is disconnected from the system. + + - + a #GDrive that was disconnected. + - - - + + Emitted when the eject button is pressed on @drive. + + - + the drive where the eject button was pressed + - - - + + Emitted when the stop button is pressed on @drive. + + - + the drive where the stop button was pressed + - - + Emitted when a mount is added. + + - + a #GMount that was added. + - - + Emitted when a mount changes. + + - + a #GMount that changed. + - - + Emitted when a mount is about to be removed. + + - + a #GMount that is being unmounted. + - - + Emitted when a mount is removed. + + - + a #GMount that was removed. + - - + Emitted when a mountable volume is added to the system. + + - + a #GVolume that was added. + - - + Emitted when mountable volume is changed. + + - + a #GVolume that changed. + - - + Emitted when a mountable volume is removed from the system. + + - + a #GVolume that was removed. + @@ -22565,7 +41989,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22580,7 +42004,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22595,7 +42019,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22610,7 +42034,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22625,7 +42049,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22640,7 +42064,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22655,7 +42079,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22670,7 +42094,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22685,7 +42109,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22700,7 +42124,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22715,16 +42139,19 @@ Interface for implementing operations for mountable volumes."> - + - + - + - + a #GList of connected #GDrive objects. + + + @@ -22734,9 +42161,12 @@ Interface for implementing operations for mountable volumes."> - + - + a #GList of #GVolume objects. + + + @@ -22746,9 +42176,12 @@ Interface for implementing operations for mountable volumes."> - + - + a #GList of #GMount objects. + + + @@ -22758,8 +42191,9 @@ Interface for implementing operations for mountable volumes."> - + + a #GVolume or %NULL if no such volume is available. @@ -22767,14 +42201,16 @@ Interface for implementing operations for mountable volumes."> + the UUID to look for - + + a #GMount or %NULL if no such mount is available. @@ -22782,14 +42218,15 @@ Interface for implementing operations for mountable volumes."> + the UUID to look for - - - + + + @@ -22803,7 +42240,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22818,7 +42255,7 @@ Interface for implementing operations for mountable volumes."> - + @@ -22832,43 +42269,43 @@ Interface for implementing operations for mountable volumes."> - - + + - - + + - - + + - - + + - - + + - - + + @@ -22876,30 +42313,81 @@ Interface for implementing operations for mountable volumes."> + Zlib decompression - + + Creates a new #GZlibCompressor. + a new #GZlibCompressor + The format to use for the compressed data - + compression level (0-9), -1 for default + - - + + Returns the #GZlibCompressor:file-info property. + + a #GFileInfo, or %NULL + + + + + Sets @file_info in @compressor. If non-%NULL, and @compressor's +#GZlibCompressor:format property is %G_ZLIB_COMPRESSOR_FORMAT_GZIP, +it will be used to set the file name and modification time in +the GZIP header of the compressed data. +progress; it may only be called immediately after creation of @compressor, +or after resetting it with g_converter_reset(). + + + + + + a #GFileInfo + + + + + + If set to a non-%NULL #GFileInfo object, and #GZlibCompressor:format is +%G_ZLIB_COMPRESSOR_FORMAT_GZIP, the compressor will write the file name +and modification time from the file info to the the GZIP header. + - - + + + + + + Used to select the type of data format to use for #GZlibDecompressor +and #GZlibCompressor. + Zlib decompression - + + Creates a new #GZlibDecompressor. + a new #GZlibDecompressor + The format to use for the compressed data - - + + Retrieves the #GFileInfo constructed from the GZIP header data +of compressed data processed by @compressor, or %NULL if @decompressor's +#GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP, +or the header data was not fully processed yet, or it not present in the +data stream at all. + + a #GFileInfo, or %NULL + + + + + A #GFileInfo containing the information found in the GZIP header +of the data stream processed, or %NULL if the header was not yet +fully processed, is not present at all, or the compressor's +#GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP. + + + + + Creates a new #GAppInfo from the given information. + new #GAppInfo for given command. + the commandline to use + the application name, or %NULL to use @commandline + flags that can specify details of the created #GAppInfo + Gets a list of all of the applications currently registered +on this system. +For desktop files, this includes applications that have +<literal>NoDisplay=true</literal> set or are excluded from +display by means of <literal>OnlyShowIn</literal> or +<literal>NotShowIn</literal>. See g_app_info_should_show(). +The returned list does not include applications which have +the <literal>Hidden</literal> key set. + a newly allocated #GList of references to #GAppInfo<!---->s. @@ -22986,38 +42518,54 @@ and #GZlibCompressor." + Gets a list of all #GAppInfo<!-- -->s for a given content type. +or %NULL on error. + #GList of #GAppInfo<!-- -->s for given @content_type + the content type to find a #GAppInfo for - + c:identifier="g_app_info_get_default_for_type" + introspectable="0"> + Gets the #GAppInfo that corresponds to a given content type. + + #GAppInfo for given @content_type or %NULL on error. + the content type to find a #GAppInfo for - + if %TRUE, the #GAppInfo is expected to support URIs + - + c:identifier="g_app_info_get_default_for_uri_scheme" + introspectable="0"> + Gets the default application for launching applications +using this URI scheme. A URI scheme is the initial part +of the URI, up to but not including the ':', e.g. "http", +"ftp" or "sip". + + #GAppInfo for given @uri_scheme or %NULL on error. + a string containing a URI scheme. @@ -23025,54 +42573,80 @@ and #GZlibCompressor." + Utility function that launches the default application +registered to handle the specified uri. Synchronous I/O +is done on the uri to detect the type of the file if +required. - + %TRUE on success, %FALSE on error. + + the uri to show + an optional #GAppLaunchContext. + c:identifier="g_app_info_reset_type_associations" + version="2.20"> + Removes all changes to the type associations done by +g_app_info_set_as_default_for_type(), +g_app_info_set_as_default_for_extension(), +g_app_info_add_supports_type() or g_app_info_remove_supports_type(). + a content type + c:identifier="g_async_initable_new_async" + version="2.22" + introspectable="0"> + Helper function for constructing #GAsyncInitiable object. This is +similar to g_object_new() but also initializes the object asynchronously. +When the initialization is finished, @callback will be called. You can +then call g_async_initable_new_finish() to get the new object and check +for any errors. + a #GType supporting #GAsyncInitable. - + the <link linkend="io-priority">I/O priority</link> of the operation. + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the initialization is finished - + the data to pass to callback function + + the name of the first property, or %NULL if no properties @@ -23081,260 +42655,1147 @@ and #GZlibCompressor." - + + Helper function for constructing #GAsyncInitiable object. This is +similar to g_object_new_valist() but also initializes the object +asynchronously. +When the initialization is finished, @callback will be called. You can +then call g_async_initable_new_finish() to get the new object and check +for any errors. + a #GType supporting #GAsyncInitable. - - + + the name of the first property, followed by the value, and other property value pairs, and ended by %NULL. + - - + + The var args list generated from @first_property_name. + - + the <link linkend="io-priority">I/O priority</link> of the operation. + + optional #GCancellable object, %NULL to ignore. + a #GAsyncReadyCallback to call when the initialization is finished - + the data to pass to callback function + + + + + + Helper function for constructing #GAsyncInitiable object. This is +similar to g_object_newv() but also initializes the object asynchronously. +When the initialization is finished, @callback will be called. You can +then call g_async_initable_new_finish() to get the new object and check +for any errors. + + + + + + a #GType supporting #GAsyncInitable. + + + + the number of parameters in @parameters + + + + the parameters to use to construct the object + + + + the <link linkend="io-priority">I/O priority</link> of the operation. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GAsyncReadyCallback to call when the initialization is finished + + + + the data to pass to callback function + + + + + + Asynchronously connects to the message bus specified by @bus_type. +When the operation is finished, @callback will be invoked. You can +then call g_bus_get_finish() to get the result of the operation. +This is a asynchronous failable function. See g_bus_get_sync() for +the synchronous version. + + + + + + A #GBusType. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied. + + + + The data to pass to @callback. + + + + + + Finishes an operation started with g_bus_get(). +The returned object is a singleton, that is, shared with other +callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the +event that you need a private message bus connection, use +g_dbus_address_get_for_bus() and +g_dbus_connection_new_for_address(). +Note that the returned #GDBusConnection object will (usually) have +the #GDBusConnection:exit-on-close property set to %TRUE. + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_bus_get(). + + + + + + Synchronously connects to the message bus specified by @bus_type. +Note that the returned object may shared with other callers, +e.g. if two separate parts of a process calls this function with +the same @bus_type, they will share the same object. +This is a synchronous failable function. See g_bus_get() and +g_bus_get_finish() for the asynchronous version. +The returned object is a singleton, that is, shared with other +callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the +event that you need a private message bus connection, use +g_dbus_address_get_for_bus_sync() and +g_dbus_connection_new_for_address(). +Note that the returned #GDBusConnection object will (usually) have +the #GDBusConnection:exit-on-close property set to %TRUE. + + A #GDBusConnection or %NULL if @error is set. Free with g_object_unref(). + + + + + A #GBusType. + + + + A #GCancellable or %NULL. + + + + + + Starts acquiring @name on the bus specified by @bus_type and calls +acquired respectively lost. Callbacks will be invoked in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this function from. +You are guaranteed that one of the @name_acquired_handler and @name_lost_handler +callbacks will be invoked after calling this function - there are three +possible cases: +<itemizedlist> +<listitem><para> +</para></listitem> +<listitem><para> +</para></listitem> +<listitem><para> +</para></listitem> +</itemizedlist> +When you are done owning the name, just call g_bus_unown_name() +with the owner id this function returns. +If the name is acquired or lost (for example another application +could acquire the name if you allow replacement or the application +currently owning the name exits), the handlers are also invoked. If the +#GDBusConnection that is used for attempting to own the name +closes, then @name_lost_handler is invoked since it is no +longer possible for other processes to access the process. +You cannot use g_bus_own_name() several times for the same name (unless +interleaved with calls to g_bus_unown_name()) - only the first call +will work. +Another guarantee is that invocations of @name_acquired_handler +and @name_lost_handler are guaranteed to alternate; that +is, if @name_acquired_handler is invoked then you are +guaranteed that the next time one of the handlers is invoked, it +will be @name_lost_handler. The reverse is also true. +If you plan on exporting objects (using e.g. +g_dbus_connection_register_object()), note that it is generally too late +to export the objects in @name_acquired_handler. Instead, you can do this +in @bus_acquired_handler since you are guaranteed that this will run +before @name is requested from the bus. +This behavior makes it very simple to write applications that wants +to own names and export objects, see <xref linkend="gdbus-owning-names"/>. +Simply register objects to be exported in @bus_acquired_handler and +unregister the objects (if any) in @name_lost_handler. +g_bus_unown_name() to stop owning the name. + + An identifier (never 0) that an be used with + + + + + The type of bus to own a name on. + + + + The well-known name to own. + + + + A set of flags from the #GBusNameOwnerFlags enumeration. + + + + Handler to invoke when connected to the bus of type @bus_type or %NULL. + + + + Handler to invoke when @name is acquired or %NULL. + + + + Handler to invoke when @name is lost or %NULL. + + + + User data to pass to handlers. + + + + Function for freeing @user_data or %NULL. + + + + + + Like g_bus_own_name() but takes a #GDBusConnection instead of a +#GBusType. +g_bus_unown_name() to stop owning the name. + + An identifier (never 0) that an be used with + + + + + A #GDBusConnection. + + + + The well-known name to own. + + + + A set of flags from the #GBusNameOwnerFlags enumeration. + + + + Handler to invoke when @name is acquired or %NULL. + + + + Handler to invoke when @name is lost or %NULL. + + + + User data to pass to handlers. + + + + Function for freeing @user_data or %NULL. + + + + + + Version of g_bus_own_name_on_connection() using closures instead of callbacks for +easier binding in other languages. +g_bus_unown_name() to stop owning the name. + + An identifier (never 0) that an be used with + + + + + A #GDBusConnection. + + + + The well-known name to own. + + + + A set of flags from the #GBusNameOwnerFlags enumeration. + + + + #GClosure to invoke when @name is acquired or %NULL. + + + + #GClosure to invoke when @name is lost or %NULL. + + + + + + Version of g_bus_own_name() using closures instead of callbacks for +easier binding in other languages. +g_bus_unown_name() to stop owning the name. + + An identifier (never 0) that an be used with + + + + + The type of bus to own a name on. + + + + The well-known name to own. + + + + A set of flags from the #GBusNameOwnerFlags enumeration. + + + + #GClosure to invoke when connected to the bus of type @bus_type or %NULL. + + + + #GClosure to invoke when @name is acquired or %NULL. + + + + #GClosure to invoke when @name is lost or %NULL. + + + + + + Stops owning a name. + + + + + + An identifier obtained from g_bus_own_name() + + + + + + Stops watching a name. + + + + + + An identifier obtained from g_bus_watch_name() + + + + + + Starts watching @name on the bus specified by @bus_type and calls +known to have a owner respectively known to lose its +owner. Callbacks will be invoked in the <link +linkend="g-main-context-push-thread-default">thread-default main +loop</link> of the thread you are calling this function from. +You are guaranteed that one of the handlers will be invoked after +calling this function. When you are done watching the name, just +call g_bus_unwatch_name() with the watcher id this function +returns. +If the name vanishes or appears (for example the application owning +the name could restart), the handlers are also invoked. If the +#GDBusConnection that is used for watching the name disconnects, then +possible to access the name. +Another guarantee is that invocations of @name_appeared_handler +and @name_vanished_handler are guaranteed to alternate; that +is, if @name_appeared_handler is invoked then you are +guaranteed that the next time one of the handlers is invoked, it +will be @name_vanished_handler. The reverse is also true. +This behavior makes it very simple to write applications that wants +to take action when a certain name exists, see <xref +linkend="gdbus-watching-names"/>. Basically, the application +should create object proxies in @name_appeared_handler and destroy +them again (if any) in @name_vanished_handler. +g_bus_unwatch_name() to stop watching the name. + + An identifier (never 0) that an be used with + + + + + The type of bus to watch a name on. + + + + The name (well-known or unique) to watch. + + + + Flags from the #GBusNameWatcherFlags enumeration. + + + + Handler to invoke when @name is known to exist or %NULL. + + + + Handler to invoke when @name is known to not exist or %NULL. + + + + User data to pass to handlers. + + + + Function for freeing @user_data or %NULL. + + + + + + Like g_bus_watch_name() but takes a #GDBusConnection instead of a +#GBusType. +g_bus_unwatch_name() to stop watching the name. + + An identifier (never 0) that an be used with + + + + + A #GDBusConnection. + + + + The name (well-known or unique) to watch. + + + + Flags from the #GBusNameWatcherFlags enumeration. + + + + Handler to invoke when @name is known to exist or %NULL. + + + + Handler to invoke when @name is known to not exist or %NULL. + + + + User data to pass to handlers. + + + + Function for freeing @user_data or %NULL. + + + + + + Version of g_bus_watch_name_on_connection() using closures instead of callbacks for +easier binding in other languages. +g_bus_unwatch_name() to stop watching the name. + + An identifier (never 0) that an be used with + + + + + A #GDBusConnection. + + + + The name (well-known or unique) to watch. + + + + Flags from the #GBusNameWatcherFlags enumeration. + + + + #GClosure to invoke when @name is known to exist or %NULL. + + + + #GClosure to invoke when @name is known to not exist or %NULL. + + + + + + Version of g_bus_watch_name() using closures instead of callbacks for +easier binding in other languages. +g_bus_unwatch_name() to stop watching the name. + + An identifier (never 0) that an be used with + + + + + The type of bus to watch a name on. + + + + The name (well-known or unique) to watch. + + + + Flags from the #GBusNameWatcherFlags enumeration. + + + + #GClosure to invoke when @name is known to exist or %NULL. + + + + #GClosure to invoke when @name is known to not exist or %NULL. + + Checks if a content type can be executable. Note that for instance +things like text files can be executables (i.e. scripts and batch files). +can be executable, %FALSE otherwise. - + %TRUE if the file type corresponds to a type that + - + a content type string + + Compares two content types for equality. +%FALSE otherwise. - + %TRUE if the two strings are identical or equivalent, + - + a content type string + - + a content type string + + c:identifier="g_content_type_from_mime_type" + version="2.18"> + Tries to find a content type based on the mime type name. +or %NULL. Free with g_free() - + Newly allocated string with content type + - + a mime type string + + Gets the human readable description of the content type. +returned string with g_free() - + a short description of the content type @type. Free the + - + a content type string + + Gets the icon for a content type. +object with g_object_unref() + #GIcon corresponding to the content type. Free the returned - + a content type string + + Gets the mime type for the content type, if one is registered. +or %NULL if unknown. - + the registered mime type for the given @type, + - + a content type string + + Guesses the content type based on example data. If the function is +uncertain, @result_uncertain will be set to %TRUE. Either @filename +or @data may be %NULL, in which case the guess will be based solely +on the other argument. +given data. Free with g_free() - + a string indicating a guessed content type for the + - - + + a string, or %NULL + - - - + + a stream of data, or %NULL + + - + the size of @data + - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + return location for the certainty of the result, or %NULL + + c:identifier="g_content_type_guess_for_tree" + version="2.18"> + Tries to guess the type of the tree with root @root, by +looking at the files it contains. The result is an array +of content types, with the best guess coming first. +The types returned all have the form x-content/foo, e.g. +x-content/audio-cdda (for audio CDs) or x-content/image-dcf +(for a camera memory card). See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> +specification for more on x-content types. +This function is useful in the implementation of +g_mount_guess_content_type(). +or %NULL. Free with g_strfreev() - + an %NULL-terminated array of zero or more content types, + + the root of the tree to guess a type for + Determines if @type is a subset of @supertype. +%FALSE otherwise. - + %TRUE if @type is a kind of @supertype, + - + a content type string + - + a content type string + + Checks if the content type is the generic "unknown" type. +On UNIX this is the "application/octet-stream" mimetype, +while on win32 it is "*". - + %TRUE if the type is the unknown type. + - + a content type string + + Gets a list of strings containing all the registered content types +known to the system. The list and its data should be freed using +<programlisting> +g_list_foreach (list, g_free, NULL); +g_list_free (list); +</programlisting> - + #GList of the registered content types + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Synchronously looks up the D-Bus address for the well-known message +bus instance specified by @bus_type. This may involve using various +platform specific mechanisms. - + A valid D-Bus address string for @bus_type or %NULL if @error is set. + - + + A #GBusType. + + + + A #GCancellable or %NULL. + + + + + + Asynchronously connects to an endpoint specified by @address and +sets up the connection so it is in a state to run the client-side +of the D-Bus authentication conversation. +When the operation is finished, @callback will be invoked. You can +then call g_dbus_address_get_stream_finish() to get the result of +the operation. +This is an asynchronous failable function. See +g_dbus_address_get_stream_sync() for the synchronous version. + + + + + + A valid D-Bus address. + + + + A #GCancellable or %NULL. + + + + A #GAsyncReadyCallback to call when the request is satisfied. + + + + Data to pass to @callback. + + + + + + Finishes an operation started with g_dbus_address_get_stream(). + + A #GIOStream or %NULL if @error is set. + + + + + A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream(). + + + + %NULL or return location to store the GUID extracted from @address, if any. + + + + + + Synchronously connects to an endpoint specified by @address and +sets up the connection so it is in a state to run the client-side +of the D-Bus authentication conversation. +This is a synchronous failable function. See +g_dbus_address_get_stream() for the asynchronous version. + + A #GIOStream or %NULL if @error is set. + + + + + A valid D-Bus address. + + + + %NULL or return location to store the GUID extracted from @address, if any. + + + + A #GCancellable or %NULL. + + + + + + Looks up the value of an annotation. +This cost of this function is O(n) in number of annotations. + + The value or %NULL if not found. Do not free, it is owned by @annotations. + + + + + A %NULL-terminated array of annotations or %NULL. + + + + The name of the annotation to look up. - - - + + Creates a D-Bus error name to use for @error. If @error matches +a registered error (cf. g_dbus_error_register_error()), the corresponding +D-Bus error name will be returned. +Otherwise the a name of the form +<literal>org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE</literal> +will be used. This allows other GDBus applications to map the error +on the wire back to a #GError using g_dbus_error_new_for_dbus_error(). +This function is typically only used in object mappings to put a +#GError on the wire. Regular applications should not use it. + + A D-Bus error name (never %NULL). Free with g_free(). + - - - - - - + A #GError. + + + + + + Gets the D-Bus error name used for @error, if any. +This function is guaranteed to return a D-Bus error name for all +#GError<!-- -->s returned from functions handling remote method +calls (e.g. g_dbus_connection_call_finish()) unless +g_dbus_error_strip_remote_error() has been used on @error. + + An allocated string or %NULL if the D-Bus error name could not be found. Free with g_free(). + + + + + A #GError. + + + + + + Checks if @error represents an error received via D-Bus from a remote peer. If so, +use g_dbus_error_get_remote_error() to get the name of the error. +%FALSE otherwise. + + %TRUE if @error represents an error from a remote peer, + + + + + A #GError. + + + + + + Creates a #GError based on the contents of @dbus_error_name and +Errors registered with g_dbus_error_register_error() will be looked +up using @dbus_error_name and if a match is found, the error domain +and code is used. Applications can use g_dbus_error_get_remote_error() +to recover @dbus_error_name. +If a match against a registered error is not found and the D-Bus +error name is in a form as returned by g_dbus_error_encode_gerror() +the error domain and code encoded in the name is used to +create the #GError. Also, @dbus_error_name is added to the error message +such that it can be recovered with g_dbus_error_get_remote_error(). +Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR +in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is +added to the error message such that it can be recovered with +g_dbus_error_get_remote_error(). +In all three cases, @dbus_error_name can always be recovered from the +returned #GError using the g_dbus_error_get_remote_error() function +(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error). +This function is typically only used in object mappings to prepare +#GError instances for applications. Regular applications should not use +it. + + An allocated #GError. Free with g_error_free(). + + + + + D-Bus error name. + + + + D-Bus error message. + + + + + + + + + + + Creates an association to map between @dbus_error_name and +#GError<!-- -->s specified by @error_domain and @error_code. +This is typically done in the routine that returns the #GQuark for +an error domain. +exists. + + %TRUE if the association was created, %FALSE if it already + + + + + A #GQuark for a error domain. + + + + An error code. + + + + A D-Bus error name. + + + + + + Helper function for associating a #GError error domain with D-Bus error names. + + + + + + The error domain name. + + + + A pointer where to store the #GQuark. + + + + A pointer to @num_entries #GDBusErrorEntry struct items. + + + + Number of items to register. + + + + + + Does nothing if @error is %NULL. Otherwise sets *@error to +a new #GError created with g_dbus_error_new_for_dbus_error() +with @dbus_error_message prepend with @format (unless %NULL). + + + + + + A pointer to a #GError or %NULL. - + + D-Bus error name. + + + + D-Bus error message. + + + + printf()-style format to prepend to @dbus_error_message or %NULL. @@ -23343,118 +43804,567 @@ and #GZlibCompressor." - + + Like g_dbus_error_set_dbus_error() but intended for language bindings. - + + + + + A pointer to a #GError or %NULL. + + + + D-Bus error name. + + + + D-Bus error message. + + + + printf()-style format to prepend to @dbus_error_message or %NULL. + + + + Arguments for @format. + + + + + + Looks for extra information in the error message used to recover +the D-Bus error name and strips it if found. If stripped, the +message field in @error will correspond exactly to what was +received on the wire. +This is typically used when presenting errors to the end user. + + %TRUE if information was stripped, %FALSE otherwise. + + + + + A #GError. + + + + + + Destroys an association previously set up with g_dbus_error_register_error(). + + %TRUE if the association was destroyed, %FALSE if it wasn't found. + + + + + A #GQuark for a error domain. + + + + An error code. + + + + A D-Bus error name. + + + + + + Generate a D-Bus GUID that can be used with +e.g. g_dbus_connection_new(). +See the D-Bus specification regarding what strings are valid D-Bus +GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). + + A valid D-Bus GUID. Free with g_free(). + + + + + Checks if @string is a D-Bus address. +This doesn't check if @string is actually supported by #GDBusServer +or #GDBusConnection - use g_dbus_is_supported_address() to do more +checks. + + %TRUE if @string is a valid D-Bus address, %FALSE otherwise. + + + + + A string. + + + + + + Checks if @string is a D-Bus GUID. +See the D-Bus specification regarding what strings are valid D-Bus +GUID (for example, D-Bus GUIDs are not RFC-4122 compliant). + + %TRUE if @string is a guid, %FALSE otherwise. + + + + + The string to check. + + + + + + Checks if @string is a valid D-Bus interface name. + + %TRUE if valid, %FALSE otherwise. + + + + + The string to check. + + + + + + Checks if @string is a valid D-Bus member (e.g. signal or method) name. + + %TRUE if valid, %FALSE otherwise. + + + + + The string to check. + + + + + + Checks if @string is a valid D-Bus bus name (either unique or well-known). + + %TRUE if valid, %FALSE otherwise. + + + + + The string to check. + + + + + + Like g_dbus_is_address() but also checks if the library suppors the +transports in @string and that key/value pairs for each transport +are valid. +supported by this library, %FALSE if @error is set. + + %TRUE if @string is a valid D-Bus address that is + + + + + A string. + + + + + + Checks if @string is a valid D-Bus unique bus name. + + %TRUE if valid, %FALSE otherwise. + + + + + The string to check. + + + + + + Creates a hash value for a #GFile. +This call does no blocking i/o. +integer that can be used as hash value for the #GFile. +This function is intended for easily hashing a #GFile to +add to a #GHashTable or similar data structure. + + 0 if @file is not a valid #GFile, otherwise an + + + + + #gconstpointer to a #GFile. + + + + + + Creates a #GFile with the given argument from the command line. The value of +relative to the current working directory. +This operation never fails, but the returned object might not support any +I/O operation if @arg points to a malformed path. + + a new #GFile. + + + + + a command line string. + + + + + + Constructs a #GFile for a given path. This operation never +fails, but the returned object might not support any I/O +operation if @path is malformed. + + a new #GFile for the given @path. + + + + + a string containing a relative or absolute path. The string must be encoded in the glib filename encoding. + + + + + + Constructs a #GFile for a given URI. This operation never +fails, but the returned object might not support any I/O +operation if @uri is malformed or if the uri type is +not supported. + + a #GFile for the given @uri. + + + + + a UTF8 string containing a URI. + + + + + + Constructs a #GFile with the given @parse_name (i.e. something given by g_file_get_parse_name()). +This operation never fails, but the returned object might not support any I/O +operation if the @parse_name cannot be parsed. + + a new #GFile. + + + + + a file name or path to be parsed. + + + + + + Gets a hash for an icon. +use in a #GHashTable or similar data structure. + + a #guint containing a hash for the @icon, suitable for + + + + + #gconstpointer to an icon object. + + + + + + Generate a #GIcon instance from @str. This function can fail if +If your application or library provides one or more #GIcon +implementations you need to ensure that each #GType is registered +with the type system prior to calling g_icon_new_for_string(). + + An object implementing the #GIcon interface or %NULL if + + + + + A string obtained via g_icon_to_string(). + + + + + + Helper function for constructing #GInitiable object. This is +similar to g_object_new() but also initializes the object +and returns %NULL, setting an error on failure. + + a newly allocated #GObject, or %NULL on error + + a #GType supporting #GInitable. + + + + optional #GCancellable object, %NULL to ignore. + + + + a #GError location to store the error occuring, or %NULL to ignore. + + + + the name of the first property, or %NULL if no properties + + + + + + + + + + Helper function for constructing #GInitiable object. This is +similar to g_object_new_valist() but also initializes the object +and returns %NULL, setting an error on failure. + + a newly allocated #GObject, or %NULL on error + + + + + a #GType supporting #GInitable. + + + + the name of the first property, followed by the value, and other property value pairs, and ended by %NULL. + + + + The var args list generated from @first_property_name. + + + + optional #GCancellable object, %NULL to ignore. + + + + + + Helper function for constructing #GInitiable object. This is +similar to g_object_newv() but also initializes the object +and returns %NULL, setting an error on failure. + + a newly allocated #GObject, or %NULL on error + + + + + a #GType supporting #GInitable. - + the number of parameters in @parameters + + the parameters to use to construct the object + optional #GCancellable object, %NULL to ignore. - + Converts errno.h error codes into GIO error codes. + + #GIOErrorEnum value for the given errno.h error number. - + Error number as defined in errno.h. + + + Gets the GIO Error Quark. + + a #GQuark. + + + + Gets the type associated with @extension. + the type of @extension + a #GIOExtension - + c:identifier="g_io_extension_point_implement" + introspectable="0"> + Registers @type as extension for the extension point with name +If @type has already been registered as an extension for this +extension point, the existing #GIOExtension object is returned. + + a #GIOExtension object for #GType + the name of the extension point + the #GType to register as extension + the name for the extension - + the priority for the extension + - + c:identifier="g_io_extension_point_lookup" + introspectable="0"> + Looks up an existing extension point. +registered extension point with the given name + + the #GIOExtensionPoint, or %NULL if there is no + the name of the extension point - + c:identifier="g_io_extension_point_register" + introspectable="0"> + Registers an extension point. +and should not be freed + + the new #GIOExtensionPoint. This object is owned by GIO + The name of the extension point + Loads all the modules in the specified directory. +If don't require all modules to be initialized (and thus registering +all gtypes) then you can use g_io_modules_scan_all_in_directory() +which allows delayed/lazy loading of modules. +from the directory, +All the modules are loaded into memory, if you want to +unload them (enabling on-demand loading) you must call +g_type_module_unuse() on all the modules. Free the list +with g_list_free(). - + a list of #GIOModules loaded + + + + pathname for a directory containing modules to load. + c:identifier="g_io_modules_scan_all_in_directory" + version="2.24"> + Scans all the modules in the specified directory, ensuring that +any extension point implemented by a module is registered. +This may not actually load and initialize all the types in each +module, some modules may be lazily loaded and initialized when +an extension point it implementes is used with e.g. +g_io_extension_point_get_extensions() or +g_io_extension_point_get_extension_by_name(). +If you need to guarantee that all types are loaded in all the modules, +use g_io_modules_scan_all_in_directory(). + pathname for a directory containing modules to scan. + Cancels all cancellable I/O jobs. +A job is cancellable if a #GCancellable was passed into +g_io_scheduler_push_job(). + Schedules the I/O job to run. +regardless whether the job was cancelled or has run to completion. +If @cancellable is not %NULL, it can be used to cancel the I/O job +by calling g_cancellable_cancel() or by calling +g_io_scheduler_cancel_all_jobs(). @@ -23464,47 +44374,150 @@ and #GZlibCompressor." scope="notified" closure="1" destroy="2"> + a #GIOSchedulerJobFunc. - + data to pass to @job_func + - + + a #GDestroyNotify for @user_data, or %NULL - + the <link linkend="gioscheduler">I/O priority</link> of the request. + + optional #GCancellable object, %NULL to ignore. + + Creates a keyfile-backed #GSettingsBackend. +The filename of the keyfile to use is given by @filename. +All settings read to or written from the backend must fall under the +path given in @root_path (which must start and end with a slash and +not contain two consecutive slashes). @root_path may be "/". +If @root_group is non-%NULL then it specifies the name of the keyfile +group used for keys that are written directly below @root_path. For +example, if @root_path is "/apps/example/" and @root_group is +"toplevel", then settings the key "/apps/example/enabled" to a value +of %TRUE will cause the following to appear in the keyfile: +|[ +[toplevel] +enabled=true +]| +If @root_group is %NULL then it is not permitted to store keys +directly below the @root_path. +the name of the subpath (with the final slash stripped) is used as +the name of the keyfile group. To continue the example, if +"/apps/example/profiles/default/font-size" were set to +12 then the following would appear in the keyfile: +|[ +[profiles/default] +font-size=12 +]| +The backend will refuse writes (and return writability as being +%FALSE) for keys outside of @root_path and, in the event that +Writes will also be refused if the backend detects that it has the +writable). +There is no checking done for your key namespace clashing with the +syntax of the key file format. For example, if you have '[' or ']' +characters in your path names or '=' in your key names you may be in +trouble. + + a keyfile-backed #GSettingsBackend + + + + + the filename of the keyfile + + + + the path under which all settings keys appear + + + + the group name corresponding to + + + + + + Lookup "gio-proxy" extension point for a proxy implementation that supports +specified protocol. + + return a #GProxy or NULL if protocol is not supported. + + + + + the proxy protocol name (e.g. http, socks, etc) + + + + + + Gets the default #GProxyResolver for the system. + + the default #GProxyResolver. + + + + + Gets the #GResolver Error Quark. + + a #GQuark. + + + + c:identifier="g_simple_async_report_error_in_idle" + introspectable="0"> + Reports an error in an asynchronous function in an idle function by +directly setting the contents of the #GAsyncResult with the given error +information. + a #GObject. + a #GAsyncReadyCallback. - + user data passed to @callback. + + a #GQuark containing the error domain (usually #G_IO_ERROR). - + a specific error code. + + a formatted error reporting string. @@ -23515,224 +44528,312 @@ and #GZlibCompressor." + Reports an error in an idle function. Similar to +g_simple_async_report_error_in_idle(), but takes a #GError rather +than building a new one. + a #GObject. + a #GAsyncReadyCallback. - + user data passed to @callback. + + the #GError to report + c:identifier="g_srv_target_list_sort" + version="2.22"> + Sorts @targets in place according to the algorithm in RFC 2782. - + the head of the sorted list. + + + - + a #GList of #GSrvTarget + + + + Determines if @mount_path is considered an implementation of the +OS. This is primarily used for hiding mountable and mounted volumes +that only are used in the OS and has little to no relevance to the +casual user. +of the OS. - + %TRUE if @mount_path is considered an implementation detail + + a mount path, e.g. <filename>/media/disk</filename> or <filename>/usr</filename> - + + Gets a #GUnixMountEntry for a given mount path. If @time_read +is set, it will be filled with a unix timestamp for checking +if the mounts have changed since with g_unix_mounts_changed_since(). + a #GUnixMount. + path for a possible unix mount. - - + + guint64 to contain a timestamp. + + Compares two unix mounts. +or less than @mount2, respectively. - + 1, 0 or -1 if @mount1 is greater than, equal to, + + first #GUnixMountEntry to compare. + second #GUnixMountEntry to compare. + Frees a unix mount. + a #GUnixMount. + Gets the device path for a unix mount. + a string containing the device path. + a #GUnixMount. + Gets the filesystem type for the unix mount. + a string containing the file system type. + a #GUnixMount. + Gets the mount path for a unix mount. + the mount path for @mount_entry. + input #GUnixMountEntry to get the mount path for. + Guesses whether a Unix mount can be ejected. - + %TRUE if @mount_entry is deemed to be ejectable. + + a #GUnixMountEntry + Guesses the icon of a Unix mount. + a #GIcon + a #GUnixMountEntry + Guesses the name of a Unix mount. +The result is a translated string. +be freed with g_free() + A newly allocated string that must + a #GUnixMountEntry + Guesses whether a Unix mount should be displayed in the UI. - + %TRUE if @mount_entry is deemed to be displayable. + + a #GUnixMountEntry + Checks if a unix mount is mounted read only. - + %TRUE if @mount_entry is read only. + + a #GUnixMount. + Checks if a unix mount is a system path. - + %TRUE if the unix mount is for a system path. + + a #GUnixMount. + Checks if the unix mount points have changed since a given unix time. - + %TRUE if the mount points have changed since @time. + - + guint64 to contain a timestamp. + + Gets a #GList of #GUnixMountPoint containing the unix mount points. +If @time_read is set, it will be filled with the mount timestamp, +allowing for checking if the mounts have changed with +g_unix_mounts_points_changed_since(). - + a #GList of the UNIX mountpoints. + + + - - + + guint64 to contain a timestamp. + + Checks if the unix mounts have changed since a given unix time. - + %TRUE if the mounts have changed since @time. + - + guint64 to contain a timestamp. + + Gets a #GList of #GUnixMountEntry containing the unix mounts. +If @time_read is set, it will be filled with the mount +timestamp, allowing for checking if the mounts have changed +with g_unix_mounts_changed_since(). - + a #GList of the UNIX mounts. + + + - - + + guint64 to contain a timestamp, or %NULL + diff --git a/basis/gio/ffi/ffi.factor b/basis/gio/ffi/ffi.factor index e4d9b73fd0..e2247e8a9e 100644 --- a/basis/gio/ffi/ffi.factor +++ b/basis/gio/ffi/ffi.factor @@ -1,10 +1,15 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection glib.ffi gobject.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gio.ffi +<< +"gobject.ffi" require +>> + +LIBRARY: gio + << "gio" { { [ os winnt? ] [ "libgio-2.0-0.dll" cdecl add-library ] } @@ -14,4 +19,3 @@ IN: gio.ffi >> GIR: vocab:gio/Gio-2.0.gir - diff --git a/basis/glib/GLib-2.0.gir b/basis/glib/GLib-2.0.gir index dec330b8c8..7d024455cd 100644 --- a/basis/glib/GLib-2.0.gir +++ b/basis/glib/GLib-2.0.gir @@ -2,7 +2,7 @@ - @@ -11,46 +11,64 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - + c:identifier-prefixes="G" + c:symbol-prefixes="g,glib"> + + + + + + + + A type which is used to hold a process identification. +On UNIX, processes are identified by a process id (an integer), +while Windows uses process handles (which are pointers). + + + + + + + + + + A value representing an interval of time, in microseconds. + + - + - + - + - + - + - + - + - + + + + + + - + @@ -66,16 +84,720 @@ and/or use gtk-doc annotations. --> - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + + The <structname>GBookmarkFile</structname> struct contains only +private data and should not be directly accessed. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error codes returned by bookmark file parsing. @@ -101,25 +823,80 @@ and/or use gtk-doc annotations. --> - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -127,96 +904,144 @@ and/or use gtk-doc annotations. --> - + - - - + + + - + - - - + + + - + - + An opaque structure representing a checksumming operation. To create a new GChecksum, use g_checksum_new(). To free -a GChecksum, use g_checksum_free()." - version="2.16"> +a GChecksum, use g_checksum_free(). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + The hashing algorithm to be used by #GChecksum when performing the digest of some data. Note that the #GChecksumType enumeration may be extended at a later -date to include new hashing algorithm types." - version="2.16" - c:type="GChecksumType"> +date to include new hashing algorithm types. + The type of functions to be called when a child exists. + the process id of the child process - + Status information about the child process, see waitpid(2) for more information about this field + - + user data passed to g_child_watch_add() + - + - + - + - + - + - + - + - + + + @@ -225,11 +1050,92 @@ date to include new hashing algorithm types." - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -237,13 +1143,13 @@ date to include new hashing algorithm types." - + - + @@ -253,15 +1159,16 @@ date to include new hashing algorithm types." - + - + + Error codes returned by character set conversion routines. @@ -279,37 +1186,41 @@ date to include new hashing algorithm types." - - + version="2.4" + introspectable="0"> + A function of this signature is used to copy the node data +when doing a deep-copy of a tree. + + A pointer to the copy + - + A pointer to the data which should be copied + - + Additional data + - + - + - + - + - + - + @@ -320,32 +1231,319 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -367,6 +1565,295 @@ when doing a deep-copy of a tree." + + <structname>GDateTime</structname> is an opaque structure whose members +cannot be accessed directly. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -382,7 +1869,7 @@ when doing a deep-copy of a tree." - + @@ -391,44 +1878,59 @@ when doing a deep-copy of a tree." - + - + + + + + + + + + + + + + + + + - + - + - + - + - + - - + + - + - + - + @@ -437,11 +1939,34 @@ when doing a deep-copy of a tree." - + + + + + + + + + + + + + + + + + + + + + + + + @@ -461,9 +1986,6 @@ when doing a deep-copy of a tree." value="7" c:identifier="G_ERR_FLOAT_MALFORMED"/> - - - @@ -510,17 +2032,17 @@ when doing a deep-copy of a tree." - + - + - + - + @@ -530,7 +2052,7 @@ when doing a deep-copy of a tree." - + @@ -540,87 +2062,87 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -628,70 +2150,116 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -700,47 +2268,57 @@ when doing a deep-copy of a tree." - + - + - + - + + + + + + + + + + + - + - + - + - + - + @@ -766,14 +2344,14 @@ when doing a deep-copy of a tree." - + - + @@ -788,34 +2366,105 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -826,21 +2475,21 @@ when doing a deep-copy of a tree." - + - + - + - + @@ -858,10 +2507,10 @@ when doing a deep-copy of a tree." - + - + @@ -874,33 +2523,355 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + @@ -951,7 +2922,7 @@ when doing a deep-copy of a tree." - + @@ -961,34 +2932,136 @@ when doing a deep-copy of a tree." - + - + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + - - + + + + + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + @@ -998,76 +3071,774 @@ when doing a deep-copy of a tree." - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - - + + - - + + - - + + - + - + - + - + + + - + + + @@ -1142,7 +3917,7 @@ when doing a deep-copy of a tree." - + @@ -1166,28 +3941,287 @@ when doing a deep-copy of a tree." - + - - + + - - - - - + + - + - + - + + The <structname>GMainContext</structname> struct is an opaque data +type representing a set of sources to be handled in a main loop. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + The <structname>GMainLoop</structname> struct is an opaque data type +representing the main event loop of a GLib or GTK+ application. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + A set of functions used to perform memory allocation. The same #GMemVTable must +be used for all allocations in the same program; a call to g_mem_set_vtable(), +if it exists, should be prior to any use of GLib. + + + + + + + + + + + - - + + + + + + + + + + + + + + - + + + + + + + + + + - - + + + + + + + + + + + + + + - - + + + + + + + + + + + - - + + + + + + + + + + + + + + - + - - - - + @@ -1301,6 +4724,262 @@ when doing a deep-copy of a tree." + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1311,20 +4990,20 @@ when doing a deep-copy of a tree." - + - + - + @@ -1343,15 +5022,28 @@ when doing a deep-copy of a tree." - + - + + + + + + + + + + + + + + - + The #GOptionArg enum values determine which type of extra argument the options expect to find. If an option expects an extra argument, it -can be specified in several ways; with a short option:" - c:type="GOptionArg"> +can be specified in several ways; with a short option: +<option>-x arg</option>, with a long option: <option>--name arg</option> @@ -1386,107 +5071,234 @@ can be specified in several ways; with a short option:" - + The type of function to be passed as callback for %G_OPTION_ARG_CALLBACK options. -occurred, in which case @error should be set with g_set_error()" - throws="1"> +occurred, in which case @error should be set with g_set_error() - + %TRUE if the option was successfully parsed, %FALSE if an error + + The name of the option being parsed. This will be either a single dash followed by a single letter (for a short name) or two dashes followed by a long option name. + The value to be parsed. - + User data added to the #GOptionGroup containing the option when it was created with g_option_group_new() + - + + A <structname>GOptionContext</structname> struct defines which options +are accepted by the commandline option parser. The struct has only private +fields and should not be directly accessed. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + A <structname>GOptionEntry</structname> defines a single option. To have an effect, they must be added to a #GOptionGroup with -g_option_context_add_main_entries() or g_option_group_add_entries()."> +g_option_context_add_main_entries() or g_option_group_add_entries(). - + - + - + @@ -1496,11 +5308,9 @@ g_option_context_add_main_entries() or g_option_group_add_entries()."> + Error codes returned by option parsing. @@ -1509,43 +5319,28 @@ Error codes returned by option parsing." c:identifier="G_OPTION_ERROR_BAD_VALUE"/> - + + The type of function to be used as callback when a parse error occurs. + The active #GOptionContext + The group to which the function belongs - + User data added to the #GOptionGroup containing the option when it was created with g_option_group_new() + - + + Flags which modify individual options. @@ -1558,92 +5353,190 @@ Flags which modify individual options." c:identifier="G_OPTION_FLAG_OPTIONAL_ARG"/> - + A <structname>GOptionGroup</structname> struct defines the options in a single group. The struct has only private fields and should not be directly accessed. All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a <structname>GOptionGroup</structname> holding their options, which -the application can then add to its #GOptionContext."> +the application can then add to its #GOptionContext. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + The type of function that can be called before and after parsing. +occurred, in which case @error should be set with g_set_error() - + %TRUE if the function completed successfully, %FALSE if an error + + The active #GOptionContext + The group to which the function belongs - + User data added to the #GOptionGroup containing the option when it was created with g_option_group_new() + - + - - + + - - + + - - + + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + - + - + - + + Specifies the type of function passed to g_main_context_set_poll_func(). +The semantics of the function should match those of the poll() system call. +reported, or -1 if an error occurred. - + the number of #GPollFD elements which have events or errors + + an array of #GPollFD elements - + the number of elements in @ufds + - + the maximum time to wait for an event of the file descriptors. A negative value indicates an infinite timeout. + @@ -1657,32 +5550,742 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + - + + + - + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + A GRegex is the "compiled" form of a regular expression pattern. This +structure is opaque and its fields cannot be accessed directly. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + Flags specifying compile-time options. @@ -1709,8 +6312,10 @@ occurred, in which case @error should be set with g_set_error()" c:identifier="G_REGEX_NEWLINE_CRLF"/> + Error codes returned by regular expressions functions. @@ -1828,23 +6433,33 @@ occurred, in which case @error should be set with g_set_error()" value="157" c:identifier="G_REGEX_ERROR_MISSING_BACK_REFERENCE"/> - + + Specifies the type of the function passed to g_regex_replace_eval(). +It is called for each occurance of the pattern in the string passed +to g_regex_replace_eval(), and it should append the replacement to - + %FALSE to continue the replacement process, %TRUE to stop it + + the #GMatchInfo generated by the match. Use g_match_info_get_regex() and g_match_info_get_string() if you need the #GRegex or the matched string. + a #GString containing the new string - + user data passed to g_regex_replace_eval() + - + + Flags specifying match-time options. @@ -1869,61 +6484,156 @@ occurred, in which case @error should be set with g_set_error()" value="4194304" c:identifier="G_REGEX_MATCH_NEWLINE_ANY"/> - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + + + - - + + - + - + - + - + - + - + - + - + - + - + @@ -1941,10 +6651,10 @@ occurred, in which case @error should be set with g_set_error()" - + - + @@ -1953,16 +6663,19 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + + + + - + @@ -1974,11 +6687,221 @@ occurred, in which case @error should be set with g_set_error()" - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1994,73 +6917,73 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -2071,11 +6994,11 @@ occurred, in which case @error should be set with g_set_error()" - + - + @@ -2084,13 +7007,249 @@ occurred, in which case @error should be set with g_set_error()" - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -2100,7 +7259,7 @@ occurred, in which case @error should be set with g_set_error()" - + @@ -2136,8 +7295,10 @@ occurred, in which case @error should be set with g_set_error()" c:identifier="G_SLICE_CONFIG_CONTENTION_COUNTER"/> + The <structname>GSource</structname> struct is an opaque data type +representing an event source. - + @@ -2146,22 +7307,24 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + - + - + + + @@ -2169,22 +7332,221 @@ occurred, in which case @error should be set with g_set_error()" - - + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The <structname>GSourceCallbackFuncs</structname> struct contains +functions for managing callback objects. - + + + + + + + + + + - + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + @@ -2194,26 +7556,88 @@ occurred, in which case @error should be set with g_set_error()" - + - + + The <structname>GSourceFuncs</structname> struct contains a table of +functions used to handle event sources in a generic manner. +For idle sources, the prepare and check functions always return %TRUE +to indicate that the source is always ready to be processed. The prepare +function also returns a timeout value of 0 to ensure that the poll() call +doesn't block (since that would be time wasted which could have been spent +running the idle function). +For timeout sources, the prepare and check functions both return %TRUE +if the timeout interval has expired. The prepare function also returns +a timeout value to ensure that the poll() call doesn't block too long +and miss the next timeout. +For file descriptor sources, the prepare function typically returns %FALSE, +since it must wait until poll() has been called before it knows whether +any events need to be processed. It sets the returned timeout to -1 to +indicate that it doesn't mind how long the poll() call blocks. In the +check function, it tests the results of the poll() call to see if the +required condition has been met, and returns %TRUE if so. - + + + + + + + + + + + + + - + + + + + + + + + + - - + + + + + + + + + + + + + + + + + - + + + + + + + + + + @@ -2228,7 +7652,7 @@ occurred, in which case @error should be set with g_set_error()" - + @@ -2279,31 +7703,73 @@ occurred, in which case @error should be set with g_set_error()" value="64" c:identifier="G_SPAWN_FILE_AND_ARGV_ZERO"/> + + - + - - + + - + - + - + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2316,104 +7782,659 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + Specifies the prototype of fatal log handler functions. - + %TRUE if the program should abort, %FALSE otherwise + + the log domain of the message + the log level of the message (including the fatal and recursion flags) + the message to process - + user data, set in g_test_log_set_fatal_handler() + @@ -2422,17 +8443,22 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + + + + + + @@ -2454,7 +8480,27 @@ occurred, in which case @error should be set with g_set_error()" c:identifier="G_TEST_LOG_MAX_RESULT"/> - + + + + + + + + + + + + + + + + + + + + + - + - + - + + + + + + + + + + + + + + + + - - - + + + - + - - + + + + + + - + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + - - + + + + + + - + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + - - + + + + + + + + + + + - - + + + + + + + + + + + - + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + - + + + + + + + + + + - + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + @@ -2568,11 +8836,78 @@ occurred, in which case @error should be set with g_set_error()" - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2580,15 +8915,145 @@ occurred, in which case @error should be set with g_set_error()" + + Disambiguates a given time in two ways. +First, specifies if the given time is in universal or local time. +Second, if the time is in local time, specifies if it is local +standard time or local daylight time. This is important for the case +where the same local time occurs twice (during daylight savings time +transitions, for example). + + + + - + - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2624,28 +9089,28 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + - + - + - + - + @@ -2654,27 +9119,28 @@ occurred, in which case @error should be set with g_set_error()" - + - + - + The type of functions which are used to translate user-visible strings, for <option>--help</option> output. -The returned string is owned by GLib and must not be freed."> +The returned string is owned by GLib and must not be freed. + a translation of the string for the current locale. + the untranslated string - + user data specified when installing the function, e.g. in g_option_group_set_translate_func() + @@ -2695,17 +9161,17 @@ The returned string is owned by GLib and must not be freed."> - + - + - + - + @@ -2715,22 +9181,183 @@ The returned string is owned by GLib and must not be freed."> - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + - + - + + + + + + + + + + + + + + + + @@ -3091,15 +9757,13 @@ The returned string is owned by GLib and must not be freed."> value="29" c:identifier="G_UNICODE_SPACE_SEPARATOR"/> - + These are logical ids for special directories which are defined depending on the platform used. You should use g_get_user_special_dir() to retrieve the full path associated to the logical id. The #GUserDirectory enumeration can be extended at later date. Not every platform has a directory for every logical id in this -enumeration." - version="2.14" - c:type="GUserDirectory"> +enumeration. @@ -3129,16 +9793,763 @@ enumeration." c:identifier="G_USER_N_DIRECTORIES"/> - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -3168,17 +10579,219 @@ enumeration." - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + A type in the GVariant type system. Two types may not be compared by value; use g_variant_type_equal() or g_variant_type_is_subtype(). May be copied using -g_variant_type_copy() and freed using g_variant_type_free()."> +g_variant_type_copy() and freed using g_variant_type_free(). + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -3186,33 +10799,25 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - - - - - - - - - - - - + + @@ -3220,23 +10825,29 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + + + - + + + - + - + @@ -3246,190 +10857,241 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + - + + + - - - + + + + + - + + + - + - + - + - - - + + + + + - + - + - + - - - + + + + + - + + + - + - + - - - + + + + + - + + + - - - + + + + + - + + + - + - - + c:identifier="g_array_remove_index_fast" + introspectable="0"> + + + + - + + + - + - - - + + + + + - + + + - + - + - - - + + + + + - + + + - + - - - + + + + + - + - + - + - + - + - + + + - + + c:identifier="g_array_sort_with_data" + introspectable="0"> - + + + - + - + @@ -3439,17 +11101,19 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + @@ -3458,14 +11122,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -3474,23 +11138,23 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + @@ -3510,13 +11174,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -3526,58 +11190,52 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - + - + - - - + - + - + - - - + - + @@ -3590,37 +11248,37 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - + - + @@ -3636,7 +11294,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3658,7 +11316,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3669,7 +11327,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + c:identifier="g_assertion_message_cmpnum" + introspectable="0"> @@ -3681,7 +11340,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3699,7 +11358,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3716,7 +11375,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3748,7 +11407,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3763,7 +11422,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3780,7 +11439,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -3790,295 +11449,33 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + c:identifier="g_async_queue_new_full" + introspectable="0"> + + scope="async"> - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -4088,52 +11485,52 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - + - - + + - + - + - + - - + + - + - + - - + + @@ -4142,38 +11539,40 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - + - + - + - + - - - + + + - + @@ -4183,65 +11582,59 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - + + - - + + - - - - + + - + - - + + - + - + - - - + - - + + - - + + @@ -4251,58 +11644,54 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - + - + - + - + - - + + - - + + - + - - - + - + - + - + - - + + - - + + @@ -4321,60 +11710,60 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - + - + - + - + - + - + - + - + - + - - + + - + @@ -4383,11 +11772,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + @@ -4396,675 +11785,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -5084,13 +11820,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + Return value: - + @@ -5116,177 +11853,224 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + Return value: - - - - - - - - - - - - - - - - - - - - - - + + + + - - - - - - - - - - - - - - - - - - - - - - - + + + + + - + - - - + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + c:identifier="g_byte_array_remove_index" + introspectable="0"> + + + + - + + + - + - - + c:identifier="g_byte_array_remove_index_fast" + introspectable="0"> + + + + - + + + - + - - + c:identifier="g_byte_array_remove_range" + introspectable="0"> + + + + - + + + - + - + - - - + + + + + - + + + - + - - + c:identifier="g_byte_array_sized_new" + introspectable="0"> + + + + - + - + - + + + - + + c:identifier="g_byte_array_sort_with_data" + introspectable="0"> - + + + - + - + @@ -5296,125 +12080,43 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - + - + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -5428,66 +12130,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -5496,20 +12152,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - + @@ -5517,31 +12163,34 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + + + + - - - - - - + - + - + - + @@ -5554,16 +12203,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + c:identifier="g_child_watch_source_new" + introspectable="0"> + @@ -5577,118 +12227,18 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -5699,12 +12249,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - + @@ -5721,7 +12269,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5734,7 +12282,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5742,16 +12290,25 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + + + + + + @@ -5763,7 +12320,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5774,13 +12331,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - - + + @@ -5795,18 +12350,16 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - + + @@ -5820,7 +12373,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5828,20 +12383,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -5850,9 +12402,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + c:identifier="g_datalist_id_get_data" + introspectable="0"> + + @@ -5864,9 +12417,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + c:identifier="g_datalist_id_remove_no_notify" + introspectable="0"> + + @@ -5890,9 +12444,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -5916,7 +12470,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5930,7 +12484,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -5940,36 +12494,37 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - - - + + + - + @@ -5977,13 +12532,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + c:identifier="g_dataset_id_remove_no_notify" + introspectable="0"> + + - + @@ -5997,148 +12553,23 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -6149,42 +12580,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -6192,31 +12591,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - + @@ -6224,51 +12602,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -6276,13 +12612,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - - + + @@ -6297,162 +12635,28 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - + - + @@ -6462,72 +12666,203 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + - - + + - + - + - - + + - - + + - + - + - - - - - + + - - - + + + - - + + - - + + + + + + + + + + + + + + + + + - - - + + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -6537,7 +12872,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -6553,17 +12888,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -6573,7 +12908,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -6583,7 +12918,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -6591,6 +12926,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + + + + + + + + + + + + + + + + @@ -6604,18 +12955,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - + + @@ -6623,50 +12967,30 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - + - + - + - + - + - + @@ -6685,30 +13009,30 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - + @@ -6724,7 +13048,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -6749,44 +13073,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -6794,7 +13082,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -6805,8 +13093,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -6814,54 +13104,87 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + + + + + + + + + + + + + + + + + - + - + + + + + + - + - + - + - + - + @@ -6880,23 +13203,25 @@ g_variant_type_copy() and freed using g_variant_type_free()."> c:identifier="g_file_set_contents" throws="1"> - + - + + + - + - + @@ -6940,9 +13265,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + @@ -6957,15 +13280,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - + + @@ -6995,15 +13316,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - + + @@ -7025,7 +13344,24 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + + + + + + + + + + + + + + + @@ -7035,7 +13371,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7047,13 +13383,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + @@ -7075,7 +13409,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7094,7 +13428,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7178,106 +13512,128 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + - - - + + + - + + + + - + - + - + - + + + + - + - + + c:identifier="g_hash_table_foreach_remove" + introspectable="0"> - + - + + + + - + - + + c:identifier="g_hash_table_foreach_steal" + introspectable="0"> - + - + + + + - + - + - - - + + + + + - + + + + - - + c:identifier="g_hash_table_get_values" + introspectable="0"> + + + + - + + + + @@ -7287,175 +13643,140 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - + + + + - + - + - + + + + - + - + - + - - - + + + + + + - + - + - - - + + + + + + - + + scope="notified" + destroy="3"> + scope="async"> + scope="async"> - - - + + + + + + - + + + + - + - + + + + - + @@ -7466,7 +13787,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + @@ -7476,36 +13800,45 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + - + - + - + - + + + + - + - + + + + - + @@ -7516,7 +13849,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + @@ -7526,12 +13862,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + - - + + @@ -7540,29 +13879,16 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - + - + @@ -7579,8 +13905,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -7588,21 +13914,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - - + + @@ -7610,15 +13935,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + @@ -7626,15 +13953,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + @@ -7642,18 +13971,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - - + + @@ -7661,7 +13992,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7678,8 +14009,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -7687,7 +14018,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7707,7 +14038,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7718,108 +14051,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -7830,7 +14070,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7847,8 +14087,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -7876,7 +14116,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7887,7 +14127,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7898,7 +14138,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -7928,37 +14168,29 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + - - + + - - - + - - + + - + @@ -7966,8 +14198,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -7979,13 +14211,31 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + + + + + + + + + + + + + + - + - + - + - + - + - - + + - + - + - + - + - + - + - + - + - + - + @@ -8084,16 +14336,40 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + + + + + + + + + + + + + + + + + + + + - + @@ -8106,140 +14382,35 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -8251,366 +14422,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -8622,881 +14449,171 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + - - - + + + + + - + + + - + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - + - - - + + + + + - + + + - + - + - - - + + + + + - + + + - + - + + + - + - + @@ -9506,7 +14623,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + @@ -9516,150 +14635,196 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + + + - + - - - + + + + + - + + + - + - + - - - + + + + + - + + + - + + + - + - - - + + + + + - + + + - + - + - - + c:identifier="g_list_insert_sorted_with_data" + introspectable="0"> + + + + - + + + - + - + - + - - - + + + + + - + + + - + - + + + - - - + + + + + - + + + - + - - - + + + - + + + - + - - - + + + + + - + + + - + @@ -9670,27 +14835,37 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + + + - + + + - - - + + + + + - + + + - + @@ -9700,93 +14875,126 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + + + - + + + - + - - - + + + + + - + + + - + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - - - + + + + + - + + + - + - - - + + + + + - + + + - + - + - - + + @@ -9803,15 +15011,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - + + @@ -9824,19 +15030,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - + + - + @@ -9871,7 +15075,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -9884,13 +15088,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -9900,24 +15104,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + c:identifier="g_log_set_default_handler" + introspectable="0"> + - + - + - + @@ -9929,9 +15131,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -9940,361 +15144,70 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - + + - + c:identifier="g_main_context_default" + introspectable="0"> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_main_context_get_thread_default" + introspectable="0"> + - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - - - - - - - - - - - - - - - - - - - - - - + + @@ -10302,132 +15215,61 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - + - - - + + + - + - - - + + + - + - + - - - + + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -10435,48 +15277,25 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - + + c:identifier="g_markup_collect_attributes" + introspectable="0"> - + - - - + - - - + @@ -10493,6 +15312,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + + + + + @@ -10502,90 +15326,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + c:identifier="g_markup_parse_context_new" + introspectable="0"> + @@ -10596,63 +15344,18 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + scope="async"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_markup_printf_escaped" + introspectable="0"> @@ -10666,227 +15369,18 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -10895,8 +15389,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -10904,40 +15400,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - - - - - - - - - + - + @@ -10955,345 +15431,65 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + - + - + - + - + - + - + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - + @@ -11302,75 +15498,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -11380,7 +15514,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -11405,44 +15539,24 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - + - - + + - + - - + + @@ -11451,131 +15565,18 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -11584,165 +15585,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -11756,91 +15607,16 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -11850,7 +15626,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -11876,7 +15652,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -11896,14 +15672,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -11916,7 +15692,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -11930,7 +15706,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -11941,31 +15717,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -11976,21 +15731,23 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + @@ -12007,7 +15764,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -12021,7 +15778,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -12035,12 +15792,12 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -12049,6 +15806,21 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + + + + + + + + + + + + + @@ -12063,7 +15835,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + c:identifier="g_propagate_prefixed_error" + introspectable="0"> @@ -12089,125 +15862,155 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + - + + + - + - + - - - + + + - + + + - + - - - + + + + + - - + c:identifier="g_ptr_array_new_with_free_func" + introspectable="0"> + + + + + scope="async"> - - - + + + + + - + + + - + - + + + - + - + - + + + - + - - + c:identifier="g_ptr_array_remove_index" + introspectable="0"> + + - + + + - + - - + c:identifier="g_ptr_array_remove_index_fast" + introspectable="0"> + + - + + + - + @@ -12218,13 +16021,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + @@ -12235,11 +16040,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + scope="async"> @@ -12250,53 +16057,63 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - - - + + + + + - + - + - + + + - + + c:identifier="g_ptr_array_sort_with_data" + introspectable="0"> - + + + - + - + @@ -12306,38 +16123,39 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + - + - + - + - + - + @@ -12347,7 +16165,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -12367,7 +16185,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -12376,663 +16194,76 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - + c:identifier="g_rand_new_with_seed_array" + introspectable="0"> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - + - + - + - + - + - + - + - + @@ -13042,36 +16273,36 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + - + - + - - - + + + - + - + - + @@ -13079,19 +16310,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> c:identifier="g_regex_check_replacement" throws="1"> - + - - + + + + + + + @@ -13101,151 +16335,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -13262,8 +16358,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -13278,150 +16377,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -13441,140 +16400,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -13603,7 +16437,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -13611,140 +16445,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -13753,197 +16457,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_sequence_foreach_range" + introspectable="0"> @@ -13954,30 +16470,19 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - - - - - - - - - - - + + + @@ -13985,55 +16490,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_sequence_insert_before" + introspectable="0"> + @@ -14041,145 +16501,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -14212,32 +16534,22 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - - - - - - - - - - - - - - + c:identifier="g_sequence_range_get_midpoint" + introspectable="0"> + @@ -14273,52 +16585,6 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -14328,31 +16594,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - + + c:identifier="g_sequence_sort_changed" + introspectable="0"> @@ -14360,19 +16608,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + + c:identifier="g_sequence_sort_changed_iter" + introspectable="0"> @@ -14380,35 +16626,12 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - - - - - - - - - - - - - - - + @@ -14436,7 +16659,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -14448,7 +16671,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -14471,7 +16694,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -14488,30 +16711,33 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - + c:identifier="g_set_printerr_handler" + introspectable="0"> + - + - + @@ -14521,24 +16747,35 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + + + - + - - + + - + @@ -14565,36 +16802,40 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + - + - - - + + + - + - - - + + + - + - + @@ -14604,10 +16845,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -14618,19 +16859,19 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + @@ -14640,18 +16881,18 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - - + + @@ -14664,109 +16905,150 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + + + - - - + + + + + - + + + - + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - + - - - + + + + + - + + + - + - + - + - + + + - + - + @@ -14776,7 +17058,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + @@ -14786,137 +17070,177 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + - + - + + + - + - - - + + + + + - + + + - + - + - - - + + + + + - + + + - + + + - + - - - + + + + + - + + + - + - + - - + c:identifier="g_slist_insert_sorted_with_data" + introspectable="0"> + + + + - + + + - + - + - + - - - + + + + + - + + + - + - + + + - - - + + + + + - + + + - + - - - + + + - + + + - + @@ -14927,27 +17251,37 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + + + - + + + - - - + + + + + - + + + - + @@ -14958,104 +17292,136 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + + + - + + + - + - - - + + + + + - + + + - + - - - + + + + + - + + + - + + + - - - + + + + + - + + + - - - + + + + + - + + + - + - - + c:identifier="g_slist_sort_with_data" + introspectable="0"> + + + + - + + + - + - + - + - + - + - + - + @@ -15064,109 +17430,8 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -15174,172 +17439,73 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - + - + - + - + - + - + - + - + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - + - + - - - + - - - + @@ -15368,9 +17530,12 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -15379,7 +17544,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> c:identifier="g_spawn_async_with_pipes" throws="1"> - + - - - + - - - + @@ -15408,25 +17569,31 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + @@ -15444,7 +17611,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> c:identifier="g_spawn_command_line_async" throws="1"> - + @@ -15456,7 +17623,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> c:identifier="g_spawn_command_line_sync" throws="1"> - + @@ -15464,24 +17631,32 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + + + - + - - - + - - - + @@ -15510,34 +17681,37 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - + @@ -15546,19 +17720,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - + c:identifier="g_static_mutex_get_mutex_impl" + introspectable="0"> + @@ -15567,234 +17732,12 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -15804,20 +17747,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + @@ -15830,7 +17773,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -15843,11 +17786,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -15856,20 +17799,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -15885,7 +17828,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -15895,14 +17838,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -15923,7 +17866,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -15942,14 +17885,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -15958,7 +17901,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -15973,7 +17916,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -15987,17 +17932,30 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + + + + + + + + + + + + + + - - - + @@ -16007,7 +17965,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16030,345 +17988,24 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -16377,8 +18014,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -16386,162 +18025,19 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - + @@ -16558,7 +18054,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16581,47 +18077,45 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - + - + - + - + - + - + - + @@ -16631,7 +18125,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16644,7 +18138,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16654,10 +18148,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -16666,7 +18160,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16693,7 +18187,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16706,12 +18200,12 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + @@ -16724,12 +18218,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - + + @@ -16742,7 +18238,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16755,7 +18251,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -16764,16 +18260,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + @@ -16782,24 +18276,24 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - - + - + @@ -16808,14 +18302,16 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -16824,11 +18320,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -16837,19 +18335,19 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + @@ -16873,8 +18371,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + @@ -16882,24 +18382,26 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - - + + @@ -16908,18 +18410,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + + - + - - + + @@ -16930,75 +18434,25 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_test_log_set_fatal_handler" + introspectable="0"> - + - + @@ -17013,13 +18467,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + c:identifier="g_test_maximized_result" + introspectable="0"> - + @@ -17030,7 +18485,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -17045,13 +18502,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> + c:identifier="g_test_minimized_result" + introspectable="0"> - + @@ -17067,14 +18525,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -17084,55 +18539,55 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - + - + - + - + - + - + @@ -17140,41 +18595,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -17195,13 +18623,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -17210,11 +18638,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -17224,75 +18652,77 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + - + - + - + - + - + + + + + + - + - + - + - + - + @@ -17316,108 +18746,43 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - + - - - - - - - - - - - + - + - + - + - + - - - - - - - - - - - - - - + @@ -17428,22 +18793,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - + @@ -17454,27 +18804,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - + @@ -17484,52 +18814,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -17540,26 +18835,63 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + - - + + - + + + + + + + + + + + - + + + + + + + + + + + + + + + + + - + - + - + - + + c:identifier="g_timeout_add_seconds" + shadowed-by="timeout_add_seconds_full" + introspectable="0"> - + + + + + + + + + + + + + + + + + - + - + - + - + - - + + - + - + c:identifier="g_timeout_source_new_seconds" + introspectable="0"> + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -17704,9 +18994,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + @@ -17714,9 +19006,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + @@ -17733,112 +19027,24 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - - + + @@ -17846,624 +19052,557 @@ g_variant_type_copy() and freed using g_variant_type_free()."> transfer-ownership="none" scope="notified" closure="1" - destroy="2"> + destroy="3"> - + + scope="async"> + scope="async"> - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + - + - - - + + + - + - - - + + + - + - + - - - + + + - + - + - - - + + + - + - + - - - + + + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - + - - + + - - + + - + - + - + - - + + - - + + - - + + - + + c:identifier="g_unichar_combining_class" + introspectable="0"> - + - + - + - + - + + c:identifier="g_unichar_get_mirror_char" + introspectable="0"> - + - + - + - - + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - + + + - + - - - + + + - + - - - + + + - + - - + + - + - + - + - + + c:identifier="g_unichar_xdigit_value" + introspectable="0"> - + - + - - + c:identifier="g_unicode_canonical_decomposition" + introspectable="0"> + + - + - - + + + c:identifier="g_unicode_canonical_ordering" + introspectable="0"> - + - + - + @@ -18493,13 +19632,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + c:identifier="g_uri_list_extract_uris" + introspectable="0"> + @@ -18556,28 +19696,29 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + - + - + - - + + - - + + @@ -18587,18 +19728,16 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + - - + + @@ -18611,13 +19750,13 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -18637,7 +19776,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -18651,7 +19790,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -18681,9 +19820,11 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + + + @@ -18692,16 +19833,17 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - + c:identifier="g_utf8_get_char_validated" + introspectable="0"> + + - + @@ -18714,7 +19856,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -18731,14 +19873,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -18759,7 +19901,9 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -18768,10 +19912,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -18784,20 +19928,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -18806,18 +19950,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - + @@ -18826,10 +19972,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + @@ -18842,7 +19988,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -18855,167 +20001,89 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - - - + + + - + - - + + - - + + - - - + + + - + - - + + - - + + - + - - + + - - + + - + - + - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -19024,306 +20092,29 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + - + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -19337,93 +20128,20 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - + - + @@ -19431,23 +20149,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - + @@ -19455,332 +20160,6 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -19790,47 +20169,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -19849,74 +20188,15 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - - - - - - - - @@ -19929,217 +20209,33 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -20148,45 +20244,10 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="g_variant_type_new_tuple" + introspectable="0"> + @@ -20194,35 +20255,14 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - - - - - - - - - - - - - - - - - - - + - + @@ -20233,7 +20273,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + @@ -20243,29 +20283,87 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - - - + - + - + - - + + + + + + + + - + - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -20281,7 +20379,7 @@ g_variant_type_copy() and freed using g_variant_type_free()."> - + diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index 405c25025f..0fd972f226 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -1,11 +1,12 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.destructors -alien.libraries alien.syntax classes.struct combinators -compiler.units gobject-introspection kernel system vocabs.parser -words ; +USING: alien alien.destructors alien.libraries alien.syntax +combinators gobject-introspection gobject-introspection.standard-types +system ; IN: glib.ffi +LIBRARY: glib + << "glib" { { [ os winnt? ] [ "libglib-2.0-0.dll" cdecl add-library ] } @@ -14,62 +15,6 @@ IN: glib.ffi } cond >> -TYPEDEF: char gchar -TYPEDEF: uchar guchar -TYPEDEF: short gshort -TYPEDEF: ushort gushort -TYPEDEF: long glong -TYPEDEF: ulong gulong -TYPEDEF: int gint -TYPEDEF: uint guint - -<< -int c-type clone - [ >c-bool ] >>unboxer-quot - [ c-bool> ] >>boxer-quot - object >>boxed-class -"gboolean" current-vocab create typedef ->> - -TYPEDEF: char gint8 -TYPEDEF: uchar guint8 -TYPEDEF: short gint16 -TYPEDEF: ushort guint16 -TYPEDEF: int gint32 -TYPEDEF: uint guint32 -TYPEDEF: longlong gint64 -TYPEDEF: ulonglong guint64 - -TYPEDEF: float gfloat -TYPEDEF: double gdouble - -TYPEDEF: long ssize_t -TYPEDEF: long time_t -TYPEDEF: size_t gsize -TYPEDEF: ssize_t gssize -TYPEDEF: size_t GType - -TYPEDEF: void* gpointer -TYPEDEF: void* gconstpointer - -TYPEDEF: guint8 GDateDay -TYPEDEF: guint16 GDateYear -TYPEDEF: gint GPid -TYPEDEF: guint32 GQuark -TYPEDEF: gint32 GTime -TYPEDEF: glong gintptr -TYPEDEF: gint64 goffset -TYPEDEF: gulong guintptr -TYPEDEF: guint32 gunichar -TYPEDEF: guint16 gunichar2 - -TYPEDEF: gpointer pointer - -STRUCT: fake-long-double { data char[10] } ; -REPLACE-C-TYPE: long\sdouble fake-long-double - -REPLACE-C-TYPE: any gpointer - IMPLEMENT-STRUCTS: GPollFD GSource GSourceFuncs ; CONSTANT: G_MININT8 HEX: -80 @@ -93,4 +38,3 @@ DESTRUCTOR: g_free CALLBACK: gboolean GSourceFuncsPrepareFunc ( GSource* source, gint* timeout_ ) ; CALLBACK: gboolean GSourceFuncsCheckFunc ( GSource* source ) ; CALLBACK: gboolean GSourceFuncsDispatchFunc ( GSource* source, GSourceFunc callback, gpointer user_data ) ; - diff --git a/basis/gmodule/GModule-2.0.gir b/basis/gmodule/GModule-2.0.gir index 27a64f081b..d19501a6de 100644 --- a/basis/gmodule/GModule-2.0.gir +++ b/basis/gmodule/GModule-2.0.gir @@ -2,7 +2,7 @@ - @@ -12,11 +12,12 @@ and/or use gtk-doc annotations. --> - + c:identifier-prefixes="G" + c:symbol-prefixes="g"> + - + @@ -24,24 +25,24 @@ and/or use gtk-doc annotations. --> + + + + + - + - + - - - - - @@ -68,7 +69,7 @@ and/or use gtk-doc annotations. --> - + @@ -81,13 +82,15 @@ and/or use gtk-doc annotations. --> - + - - + + @@ -99,9 +102,9 @@ and/or use gtk-doc annotations. --> - + - + diff --git a/basis/gmodule/ffi/ffi.factor b/basis/gmodule/ffi/ffi.factor index 5e3334de68..c90fce8085 100644 --- a/basis/gmodule/ffi/ffi.factor +++ b/basis/gmodule/ffi/ffi.factor @@ -1,9 +1,15 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection glib.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gmodule.ffi +<< +"glib.ffi" require +>> + +LIBRARY: gmodule + << "gmodule" { { [ os winnt? ] [ "libgmodule-2.0-0.dll" cdecl add-library ] } @@ -13,4 +19,3 @@ IN: gmodule.ffi >> GIR: vocab:gmodule/GModule-2.0.gir - diff --git a/basis/gobject-introspection/common/common.factor b/basis/gobject-introspection/common/common.factor index 7ffca04bde..4a88268878 100644 --- a/basis/gobject-introspection/common/common.factor +++ b/basis/gobject-introspection/common/common.factor @@ -1,21 +1,9 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: assocs kernel namespaces ; +USING: namespaces ; IN: gobject-introspection.common -CONSTANT: ffi-vocab "ffi" - -SYMBOL: current-lib - -SYMBOL: type-infos -type-infos [ H{ } ] initialize - -SYMBOL: aliases -aliases [ H{ } ] initialize +SYMBOL: current-namespace-name SYMBOL: implement-structs implement-structs [ V{ } ] initialize - -SYMBOL: replaced-c-types -replaced-c-types [ H{ } ] initialize - diff --git a/basis/gobject-introspection/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor index 1328bdc787..ff0eb9a85b 100644 --- a/basis/gobject-introspection/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -1,240 +1,341 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien alien.c-types alien.parser arrays assocs classes.parser classes.struct combinators combinators.short-circuit definitions effects fry gobject-introspection.common gobject-introspection.types kernel math.parser namespaces parser quotations sequences + +gobject-introspection.standard-types +prettyprint ascii gobject-introspection.repository locals +compiler.units make splitting.monotonic + sequences.generalizations words words.constant ; IN: gobject-introspection.ffi -: string>c-type ( str -- c-type ) - dup CHAR: * swap index [ cut ] [ "" ] if* - [ replaced-c-types get-global ?at drop ] dip - append parse-c-type ; - -: define-each ( nodes quot -- ) - '[ dup @ >>ffi drop ] each ; inline +SYMBOL: constant-prefix -: function-ffi-invoker ( func -- quot ) - { - [ return>> c-type>> string>c-type ] - [ drop current-lib get-global ] - [ identifier>> ] - [ parameters>> [ c-type>> string>c-type ] map ] - [ varargs?>> [ void* suffix ] when ] - } cleave function-quot ; +: def-c-type ( c-type-name base-c-type -- ) + swap (CREATE-C-TYPE) typedef ; -: function-ffi-effect ( func -- effect ) - [ parameters>> [ name>> ] map ] - [ varargs?>> [ "varargs" suffix ] when ] - [ return>> type>> none-type? { } { "result" } ? ] tri - ; +: defer-c-type ( c-type-name -- c-type ) + deferred-type swap (CREATE-C-TYPE) [ typedef ] keep ; +! create-in dup +! [ fake-definition ] [ undefined-def define ] bi ; -: define-ffi-function ( func -- word ) - [ identifier>> create-in dup ] - [ function-ffi-invoker ] [ function-ffi-effect ] tri - define-declared ; +:: defer-types ( types type-info-class -- ) + types [ + [ c-type>> defer-c-type ] + [ name>> qualified-name ] bi + type-info-class new swap register-type + ] each ; -: define-ffi-functions ( functions -- ) - [ define-ffi-function ] define-each ; +: def-alias-c-type ( base-c-type c-type-name -- c-type ) + (CREATE-C-TYPE) [ typedef ] keep ; -: callback-ffi-invoker ( callback -- quot ) - [ return>> c-type>> string>c-type ] - [ parameters>> [ c-type>> string>c-type ] map ] bi - cdecl callback-quot ; +: alias-c-type-name ( alias -- c-type-name ) + ! > ] [ name>> ] bi or ; + ! workaround> + ! c-type>> ; -: callback-ffi-effect ( callback -- effect ) - [ parameters>> [ name>> ] map ] - [ return>> type>> none-type? { } { "result" } ? ] bi - ; +:: def-alias ( alias -- ) + alias type>> get-type-info + [ c-type>> alias alias-c-type-name def-alias-c-type ] + [ clone ] bi alias name>> qualified-name register-type ; -: define-ffi-callback ( callback -- word ) - [ c-type>> create-in [ void* swap typedef ] keep dup ] keep - [ callback-ffi-effect "callback-effect" set-word-prop ] - [ drop current-lib get-global "callback-library" set-word-prop ] - [ callback-ffi-invoker (( quot -- alien )) define-inline ] 2tri ; +: def-aliases ( aliases -- ) + [ def-alias ] each ; -: fix-signal-param-c-type ( param -- ) - dup [ c-type>> ] [ type>> ] bi - { - [ none-type? ] - [ simple-type? ] - [ enum-type? ] - [ bitfield-type? ] - } 1|| [ dup "*" tail? [ CHAR: * suffix ] unless ] unless - >>c-type drop ; +GENERIC: type>c-type ( type -- c-type ) -: define-ffi-signal ( signal -- word ) - [ return>> fix-signal-param-c-type ] - [ parameters>> [ fix-signal-param-c-type ] each ] - [ define-ffi-callback ] tri ; - -: define-ffi-signals ( signals -- ) - [ define-ffi-signal ] define-each ; +M: atomic-type type>c-type get-type-info c-type>> ; +M: enum-type type>c-type get-type-info c-type>> ; +M: bitfield-type type>c-type get-type-info c-type>> ; +M: record-type type>c-type get-type-info c-type>> ; +M: union-type type>c-type get-type-info c-type>> ; +M: boxed-type type>c-type get-type-info c-type>> ; +M: callback-type type>c-type get-type-info c-type>> ; +M: class-type type>c-type get-type-info c-type>> ; +M: interface-type type>c-type get-type-info c-type>> ; -: const-value ( const -- value ) - [ value>> ] [ type>> name>> ] bi { - { "int" [ string>number ] } - { "double" [ string>number ] } - { "utf8" [ ] } +M: boxed-array-type type>c-type + name>> simple-type new swap >>name type>c-type ; + +M: c-array-type type>c-type + element-type>> type>c-type ; + +M: fixed-size-array-type type>c-type + [ element-type>> type>c-type ] [ fixed-size>> ] bi 2array ; + +! (in some signals and properties) +PREDICATE: incorrect-type < simple-type name>> not ; +M: incorrect-type type>c-type drop void* ; +! workaround> + +GENERIC: parse-const-value ( str data-type -- value ) + +M: atomic-type parse-const-value + name>> { + { "gint" [ string>number ] } + { "gdouble" [ string>number ] } } case ; -: define-ffi-enum ( enum -- word ) - [ - members>> [ - [ c-identifier>> create-in ] - [ value>> ] bi define-constant - ] each - ] [ c-type>> (CREATE-C-TYPE) [ int swap typedef ] keep ] bi ; +M: utf8-type parse-const-value drop ; -: define-ffi-enums ( enums -- ) - [ define-ffi-enum ] define-each ; - -: define-ffi-bitfields ( bitfields -- ) - [ define-ffi-enum ] define-each ; +: const-value ( const -- value ) + [ value>> ] [ type>> ] bi parse-const-value ; -: fields>struct-slots ( fields -- slots ) - [ - [ name>> ] +: const-name ( const -- name ) + name>> constant-prefix get swap "_" glue ; + +: def-const ( const -- ) + [ const-name create-in dup reset-generic ] + [ const-value ] bi define-constant ; + +: def-consts ( consts -- ) + [ def-const ] each ; + +: define-enum-member ( member -- ) + [ c-identifier>> create-in dup reset-generic ] + [ value>> ] bi define-constant ; + +: def-enum-type ( enum -- ) + [ members>> [ define-enum-member ] each ] + [ c-type>> int def-c-type ] bi ; + +: def-bitfield-type ( bitfield -- ) + def-enum-type ; + +GENERIC: parameter-type>c-type ( data-type -- c-type ) + +M: data-type parameter-type>c-type type>c-type ; +M: varargs-type parameter-type>c-type drop void* ; + +: parameter-c-type ( parameter -- c-type ) + [ type>> parameter-type>c-type ] keep + direction>> "in" = [ ] unless ; + +GENERIC: return-type>c-type ( data-type -- c-type ) + +M: data-type return-type>c-type type>c-type ; +M: none-type return-type>c-type drop void ; + +: return-c-type ( return -- c-type ) + type>> return-type>c-type ; + +: parameter-name ( parameter -- name ) + dup type>> varargs-type? + [ drop "varargs" ] [ name>> "!incorrect-name!" or ] if ; + +: error-parameter ( -- parameter ) + parameter new + "error" >>name + "in" >>direction + "none" >>transfer-ownership + simple-type new "GLib.Error" >>name >>type ; + +: ?suffix-parameters-with-error ( callable -- parameters ) + [ parameters>> ] [ throws?>> ] bi + [ error-parameter suffix ] when ; + +: parameter-names&types ( callable -- names types ) + [ [ parameter-c-type ] map ] [ [ parameter-name ] map ] bi ; + +: def-function ( function -- ) + { + [ return>> return-c-type ] + [ identifier>> ] + [ drop current-library get ] + [ ?suffix-parameters-with-error parameter-names&types ] + } cleave make-function define-inline ; + +: def-functions ( functions -- ) + [ def-function ] each ; + +GENERIC: type>data-type ( type -- data-type ) + +M: type type>data-type + [ simple-type new ] dip name>> >>name ; + +: word-started? ( word letter -- ? ) + [ letter? ] [ LETTER? ] bi* and ; inline + +: camel-case>underscore-separated ( str -- str' ) + [ word-started? not ] monotonic-split "_" join >lower ; + +: type>parameter-name ( type -- name ) + name>> camel-case>underscore-separated ; + +: type>parameter ( type -- parameter ) + [ parameter new ] dip { + [ type>parameter-name >>name ] + [ type>data-type >>type ] + [ drop "in" >>direction "none" >>transfer-ownership ] + } cleave ; + +:: def-method ( method type -- ) + method { + [ return>> return-c-type ] + [ identifier>> ] + [ drop current-library get ] [ - [ c-type>> string>c-type ] [ array-info>> ] bi - [ fixed-size>> [ 2array ] when* ] when* + ?suffix-parameters-with-error + type type>parameter prefix + parameter-names&types ] - [ drop { } ] tri - ] map ; + } cleave make-function define-inline ; -: define-ffi-record-defer ( record -- word ) - c-type>> create-in void* swap [ typedef ] keep ; +: def-methods ( methods type -- ) + [ def-method ] curry each ; -: define-ffi-records-defer ( records -- ) - [ define-ffi-record-defer ] define-each ; +: def-callback-type ( callback -- ) + { + [ drop current-library get ] + [ return>> return-c-type ] + [ c-type>> ] + [ ?suffix-parameters-with-error parameter-names&types ] + } cleave make-callback-type define-inline ; -: define-ffi-record ( record -- word ) - dup ffi>> forget - dup { - [ fields>> empty? not ] - [ c-type>> implement-structs get-global member? ] - } 1&& +GENERIC: field-type>c-type ( data-type -- c-type ) + +M: simple-type field-type>c-type type>c-type ; +M: inner-callback-type field-type>c-type drop void* ; +M: array-type field-type>c-type type>c-type ; + +: field>struct-slot ( field -- slot ) + [ name>> ] + [ dup bits>> [ drop uint ] [ type>> field-type>c-type ] if ] [ - [ c-type>> create-class-in dup ] - [ fields>> fields>struct-slots ] bi define-struct-class - ] [ - [ disguised?>> void* void ? ] - [ c-type>> create-in ] bi [ typedef ] keep - ] if ; + [ + [ drop ] ! [ writable?>> [ read-only , ] unless ] + [ bits>> [ bits: , , ] when* ] bi + ] V{ } make + ] tri ; -: define-ffi-records ( records -- ) - [ define-ffi-record ] define-each ; +: def-record-type ( record -- ) + dup c-type>> implement-structs get-global member? + [ + [ c-type>> create-class-in ] + [ fields>> [ field>struct-slot ] map ] bi + define-struct-class + ] [ c-type>> void def-c-type ] if ; -: define-ffi-record-content ( record -- ) +: def-record ( record -- ) { - [ constructors>> define-ffi-functions ] - [ functions>> define-ffi-functions ] - [ methods>> define-ffi-functions ] + [ def-record-type ] + [ constructors>> def-functions ] + [ functions>> def-functions ] + [ [ methods>> ] keep def-methods ] } cleave ; -: define-ffi-records-content ( records -- ) - [ define-ffi-record-content ] each ; +: def-union-type ( union -- ) + c-type>> void def-c-type ; -: define-ffi-union ( union -- word ) - c-type>> create-in [ void* swap typedef ] keep ; - -: define-ffi-unions ( unions -- ) - [ define-ffi-union ] define-each ; - -: define-ffi-callbacks ( callbacks -- ) - [ define-ffi-callback ] define-each ; - -: define-ffi-interface ( interface -- word ) - c-type>> create-in [ void swap typedef ] keep ; - -: define-ffi-interfaces ( interfaces -- ) - [ define-ffi-interface ] define-each ; - -: define-ffi-interface-content ( interface -- ) +: def-union ( union -- ) { - [ methods>> define-ffi-functions ] + [ def-union-type ] + [ constructors>> def-functions ] + [ functions>> def-functions ] + [ [ methods>> ] keep def-methods ] } cleave ; -: define-ffi-interfaces-content ( interfaces -- ) - [ define-ffi-interface-content ] each ; +: def-boxed-type ( boxed -- ) + c-type>> void def-c-type ; -: get-type-invoker ( name -- quot ) - ! hack - [ "GType" "glib.ffi" lookup current-lib get-global ] dip - { } \ alien-invoke 5 narray >quotation ; +: signal-name ( signal type -- name ) + swap [ c-type>> ] [ name>> ] bi* ":" glue ; + +: user-data-parameter ( -- parameter ) + parameter new + "user_data" >>name + "in" >>direction + "none" >>transfer-ownership + simple-type new "gpointer" >>name >>type ; + +:: def-signal ( signal type -- ) + signal { + [ drop current-library get ] + [ return>> return-c-type ] + [ type signal-name ] + [ + parameters>> type type>parameter prefix + user-data-parameter suffix parameter-names&types + ] + } cleave make-callback-type define-inline ; -: define-ffi-class ( class -- word ) - c-type>> create-in [ void swap typedef ] keep ; +: def-signals ( signals type -- ) + [ def-signal ] curry each ; -: define-ffi-classes ( class -- ) - [ define-ffi-class ] define-each ; +: def-class-type ( class -- ) + c-type>> void def-c-type ; -: define-ffi-class-content ( class -- ) +: def-class ( class -- ) { - [ constructors>> define-ffi-functions ] - [ functions>> define-ffi-functions ] - [ methods>> define-ffi-functions ] - [ signals>> define-ffi-signals ] + [ def-class-type ] + [ constructors>> def-functions ] + [ functions>> def-functions ] + [ [ methods>> ] keep def-methods ] + [ [ signals>> ] keep def-signals ] } cleave ; -: define-ffi-classes-content ( class -- ) - [ define-ffi-class-content ] each ; +: def-interface-type ( interface -- ) + c-type>> void def-c-type ; -: define-get-type ( node -- word ) - get-type>> dup { "intern" f } member? [ drop f ] - [ - [ create-in dup ] [ get-type-invoker ] bi - { } { "type" } define-declared - ] if ; - -: define-get-types ( namespace -- ) +: def-interface ( class -- ) { - [ enums>> [ define-get-type drop ] each ] - [ bitfields>> [ define-get-type drop ] each ] - [ records>> [ define-get-type drop ] each ] - [ unions>> [ define-get-type drop ] each ] - [ interfaces>> [ define-get-type drop ] each ] - [ classes>> [ define-get-type drop ] each ] + [ def-interface-type ] + [ functions>> def-functions ] + [ [ methods>> ] keep def-methods ] + [ [ signals>> ] keep def-signals ] } cleave ; -: define-ffi-const ( const -- word ) - [ c-identifier>> create-in dup ] [ const-value ] bi - define-constant ; +: defer-enums ( enums -- ) enum-info defer-types ; +: defer-bitfields ( bitfields -- ) bitfield-info defer-types ; +: defer-records ( records -- ) record-info defer-types ; +: defer-unions ( unions -- ) union-info defer-types ; +: defer-boxeds ( boxeds -- ) boxed-info defer-types ; +: defer-callbacks ( callbacks -- ) callback-info defer-types ; +: defer-interfaces ( interfaces -- ) interface-info defer-types ; +: defer-classes ( class -- ) class-info defer-types ; -: define-ffi-consts ( consts -- ) - [ define-ffi-const ] define-each ; +: def-enums ( enums -- ) [ def-enum-type ] each ; +: def-bitfields ( bitfields -- ) [ def-bitfield-type ] each ; +: def-records ( records -- ) [ def-record ] each ; +: def-unions ( unions -- ) [ def-union ] each ; +: def-boxeds ( boxeds -- ) [ def-boxed-type ] each ; +: def-callbacks ( callbacks -- ) [ def-callback-type ] each ; +: def-interfaces ( interfaces -- ) [ def-interface ] each ; +: def-classes ( classes -- ) [ def-class ] each ; -: define-ffi-alias ( alias -- ) - drop ; - -: define-ffi-aliases ( aliases -- ) - [ define-ffi-alias ] each ; - -: define-ffi-namespace ( namespace -- ) +: def-namespace ( namespace -- ) { - [ aliases>> define-ffi-aliases ] - [ consts>> define-ffi-consts ] - [ enums>> define-ffi-enums ] - [ bitfields>> define-ffi-bitfields ] - - [ records>> define-ffi-records-defer ] + [ symbol-prefixes>> first >upper constant-prefix set ] + [ consts>> def-consts ] - [ unions>> define-ffi-unions ] - [ interfaces>> define-ffi-interfaces ] - [ classes>> define-ffi-classes ] - [ callbacks>> define-ffi-callbacks ] - [ records>> define-ffi-records ] - - [ records>> define-ffi-records-content ] - [ classes>> define-ffi-classes-content ] - [ interfaces>> define-ffi-interfaces-content ] - [ functions>> define-ffi-functions ] + [ enums>> defer-enums ] + [ bitfields>> defer-bitfields ] + [ records>> defer-records ] + [ unions>> defer-unions ] + [ boxeds>> defer-boxeds ] + [ callbacks>> defer-callbacks ] + [ interfaces>> defer-interfaces ] + [ classes>> defer-classes ] - [ define-get-types ] + [ aliases>> def-aliases ] + + [ enums>> def-enums ] + [ bitfields>> def-bitfields ] + [ records>> def-records ] + [ unions>> def-unions ] + [ boxeds>> def-boxeds ] + [ callbacks>> def-callbacks ] + [ interfaces>> def-interfaces ] + [ classes>> def-classes ] + + [ functions>> def-functions ] } cleave ; -: define-ffi-repository ( repository -- ) - namespace>> define-ffi-namespace ; +: def-ffi-repository ( repository -- ) + namespace>> def-namespace ; diff --git a/basis/gobject-introspection/gobject-introspection.factor b/basis/gobject-introspection/gobject-introspection.factor index ae934ea76f..5104f757ce 100755 --- a/basis/gobject-introspection/gobject-introspection.factor +++ b/basis/gobject-introspection/gobject-introspection.factor @@ -1,26 +1,22 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors assocs combinators gobject-introspection.common -gobject-introspection.ffi gobject-introspection.loader kernel lexer -locals math namespaces sequences strings.parser vocabs.parser xml ; +USING: accessors combinators gobject-introspection.common +gobject-introspection.ffi gobject-introspection.loader +gobject-introspection.types kernel lexer locals namespaces parser +sequences xml ; IN: gobject-introspection -: with-child-vocab ( name quot -- ) - swap current-vocab name>> - [ swap "." glue set-current-vocab call ] keep - set-current-vocab ; inline +xml xml>repository - - current-vocab name>> dup ffi-vocab tail? - [ ffi-vocab length 1 + head* current-lib set-global ] - [ drop ] if ! throw the error { - [ define-ffi-repository ] + [ namespace>> name>> current-namespace-name set-global ] + [ def-ffi-repository ] } cleave - V{ } clone implement-structs set-global - H{ } clone replaced-c-types set-global ; + V{ } clone implement-structs set-global ; + +PRIVATE> SYNTAX: GIR: scan define-gir-vocab ; @@ -28,6 +24,8 @@ SYNTAX: IMPLEMENT-STRUCTS: ";" parse-tokens implement-structs [ swap append! ] change-global ; -SYNTAX: REPLACE-C-TYPE: - scan unescape-string scan swap - replaced-c-types get-global set-at ; +SYNTAX: FOREIGN-ENUM-TYPE: + scan-token scan-object swap register-enum-type ; + +SYNTAX: FOREIGN-RECORD-TYPE: + scan-token scan-object swap register-record-type ; diff --git a/basis/gobject-introspection/loader/loader.factor b/basis/gobject-introspection/loader/loader.factor index 8c79e7a0b8..3bc139e35b 100644 --- a/basis/gobject-introspection/loader/loader.factor +++ b/basis/gobject-introspection/loader/loader.factor @@ -1,225 +1,75 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors ascii combinators fry -gobject-introspection.common gobject-introspection.repository -gobject-introspection.types literals kernel math.parser sequences -splitting xml.data xml.traversal ; -FROM: namespaces => set get ; +USING: accessors combinators gobject-introspection.repository kernel +literals math.parser sequences splitting xml.data xml.traversal ; IN: gobject-introspection.loader -SYMBOL: namespace-prefix -SYMBOL: namespace-PREFIX - -: word-started? ( word letter -- ? ) - [ last letter? ] [ LETTER? ] bi* and ; - -: camel>PREFIX ( name -- name' ) - dup 1 head - [ 2dup word-started? [ [ CHAR: _ suffix ] dip ] when suffix ] - reduce rest >upper ; - -: set-prefix ( prefix -- ) - [ namespace-prefix set ] - [ camel>PREFIX namespace-PREFIX set ] bi ; - -: camel>factor ( name -- name' ) - dup 1 head - [ 2dup word-started? [ [ CHAR: - suffix ] dip ] when suffix ] - reduce rest >lower ; - -: underscored>factor ( name -- name' ) - [ [ CHAR: _ = not ] keep CHAR: - ? ] map >lower ; - -: full-type-name>type ( name -- type ) - [ type new ] dip - camel>factor "." split1 dup [ swap ] unless - [ >>namespace ] [ >>name ] bi* absolute-type ; - -: node>type ( xml -- type ) - "name" attr full-type-name>type ; - -: xml>array-info ( xml -- array-info ) - [ array-info new ] dip { - [ "zero-terminated" attr [ "1" = ] [ t ] if* >>zero-terminated? ] - [ "length" attr [ string>number ] [ f ] if* >>length ] - [ "fixed-size" attr [ string>number ] [ f ] if* >>fixed-size ] +: xml>simple-type ( xml -- type ) + [ simple-type new ] dip { + [ "name" attr >>name ] + [ + "type" tags-named + [ xml>simple-type ] map f like >>element-types + ] } cleave ; -: xml>type ( xml -- array-info type ) +: xml>varargs-type ( xml -- type ) + drop varargs-type new ; + +: xml>array-type ( xml -- type ) + [ array-type new ] dip { + [ "name" attr >>name ] + [ "zero-terminated" attr "0" = not >>zero-terminated? ] + [ "length" attr string>number >>length ] + [ "fixed-size" attr string>number >>fixed-size ] + [ "type" tag-named xml>simple-type >>element-type ] + } cleave ; + +: xml>inner-callback-type ( xml -- type ) + [ inner-callback-type new ] dip { + [ "name" attr >>name ] + } cleave ; + +: xml>type ( xml -- type ) dup name>> main>> { - { "array" - [ - [ xml>array-info ] - [ first-child-tag node>type ] bi - ] - } - { "type" [ node>type f swap ] } - { "varargs" [ drop f f ] } - { "callback" [ drop f "any" f type boa ] } + { "type" [ xml>simple-type ] } + { "array"[ xml>array-type ] } + { "callback" [ xml>inner-callback-type ] } + { "varargs" [ xml>varargs-type ] } } case ; -CONSTANT: type-tags { - $[ "array" ] - $[ "type" ] - $[ "varargs" ] - $[ "callback" ] -} +CONSTANT: type-tags + $[ { "array" "type" "callback" "varargs" } [ ] map ] : child-type-tag ( xml -- type-tag ) children-tags [ type-tags [ swap tag-named? ] with any? ] find nip ; - -: load-parameter ( param xml -- param ) - [ "transfer-ownership" attr >>transfer-ownership ] - [ child-type-tag "type" attr >>c-type ] - [ - child-type-tag xml>type - [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* - ] tri ; +: xml>alias ( xml -- alias ) + [ alias new ] dip { + [ "name" attr >>name ] + [ "type" attr >>c-type ] + [ child-type-tag xml>type >>type ] + } cleave ; + +: xml>const ( xml -- const ) + [ const new ] dip { + [ "name" attr >>name ] + [ "value" attr >>value ] + [ child-type-tag xml>type >>type ] + } cleave ; + : load-type ( type xml -- type ) { - [ "name" attr camel>factor >>name ] - [ node>type >>type ] - [ "type" attr >>c-type ] - [ "type-name" attr >>type-name ] + [ "name" attr >>name ] + [ [ "type" attr ] [ "type-name" attr ] bi or >>c-type ] [ "get-type" attr >>get-type ] } cleave ; -: xml>parameter ( xml -- parameter ) - [ parameter new ] dip { - [ "name" attr >>name ] - [ "direction" attr dup "in" ? >>direction ] - [ "allow-none" attr "1" = >>allow-none? ] - [ load-parameter ] - } cleave ; - -: xml>return ( xml -- return ) - [ return new ] dip { - [ drop "result" >>name ] - [ load-parameter ] - } cleave ; - -: throws-parameter ( -- parameter ) - parameter new - "error" >>name - "in" >>direction - "none" >>transfer-ownership - "GError**" >>c-type - "GLib.Error" full-type-name>type >>type ; - -: extract-parameters ( xml -- parameters ) - "parameters" tag-named "parameter" tags-named - [ xml>parameter ] map ; - -: load-parameters ( callable xml -- callable ) - [ - [ - extract-parameters - dup { f } tail? [ but-last [ t >>varargs? ] dip ] when - ] - [ "throws" attr "1" = [ throws-parameter suffix ] when ] bi - >>parameters - ] - [ "return-value" tag-named xml>return >>return ] bi ; - -: xml>function ( xml -- function ) - [ function new ] dip { - [ "name" attr underscored>factor >>name ] - [ "identifier" attr >>identifier ] - [ load-parameters ] - } cleave ; - -: (type>param) ( type -- param ) - [ parameter new ] dip - [ c-type>> CHAR: * suffix >>c-type ] [ type>> >>type ] bi - "none" >>transfer-ownership - "in" >>direction ; - -: type>self-param ( type -- self ) - (type>param) "self" >>name ; - -: type>sender-param ( type -- sender ) - (type>param) "sender" >>name ; - -: signal-data-param ( -- param ) - parameter new - "user_data" >>name - "gpointer" >>c-type - type new "any" >>name >>type - "none" >>transfer-ownership - "in" >>direction ; - -: xml>property ( xml -- property ) - [ property new ] dip { - [ "name" attr >>name ] - [ "writable" attr "1" = >>writable? ] - [ "readable" attr "0" = not >>readable? ] - [ "construct" attr "1" = >>construct? ] - [ "construct-only" attr "1" = >>construct-only? ] - [ child-type-tag xml>type nip >>type ] - } cleave ; - -: xml>callback ( xml -- callback ) - [ callback new ] dip { - [ load-type ] - [ load-parameters ] - } cleave ; - -: xml>signal ( xml -- signal ) - [ signal new ] dip { - [ "name" attr camel>factor >>name ] - [ node>type >>type ] - [ "type" attr >>c-type ] - [ - load-parameters - [ signal-data-param suffix ] change-parameters - ] - } cleave ; - -: load-functions ( xml tag-name -- functions ) - tags-named [ xml>function ] map ; - -: xml>class ( xml -- class ) - [ class new ] dip { - [ load-type ] - [ "abstract" attr "1" = >>abstract? ] - [ - "parent" attr [ full-type-name>type ] [ f ] if* - >>parent - ] - [ "type-struct" attr >>type-struct ] - [ "constructor" load-functions >>constructors ] - [ "function" load-functions >>functions ] - [ - "method" load-functions over type>self-param - '[ [ _ prefix ] change-parameters ] map - >>methods - ] - [ - "signal" tags-named [ xml>signal ] map - over type>sender-param - '[ [ _ prefix ] change-parameters ] map - over c-type>> CHAR: : suffix - '[ dup name>> _ prepend >>c-type ] map - >>signals - ] - } cleave ; - -: xml>interface ( xml -- interface ) - [ interface new ] dip { - [ load-type ] - [ - "method" load-functions over type>self-param - '[ [ _ prefix ] change-parameters ] map - >>methods - ] - } cleave ; - : xml>member ( xml -- member ) [ enum-member new ] dip { - [ "name" attr underscored>factor >>name ] + [ "name" attr >>name ] [ "identifier" attr >>c-identifier ] [ "value" attr string>number >>value ] } cleave ; @@ -230,78 +80,135 @@ CONSTANT: type-tags { [ "member" tags-named [ xml>member ] map >>members ] } cleave ; +: load-parameter ( param xml -- param ) + [ child-type-tag xml>type >>type ] + [ "transfer-ownership" attr >>transfer-ownership ] bi ; + +: xml>parameter ( xml -- parameter ) + [ parameter new ] dip { + [ "name" attr >>name ] + [ "direction" attr dup "in" ? >>direction ] + [ "allow-none" attr "1" = >>allow-none? ] + [ child-type-tag xml>type >>type ] + [ "transfer-ownership" attr >>transfer-ownership ] + } cleave ; + +: xml>return ( xml -- return ) + [ return new ] dip { + [ child-type-tag xml>type >>type ] + [ "transfer-ownership" attr >>transfer-ownership ] + } cleave ; + +: load-callable ( callable xml -- callable ) + [ "return-value" tag-named xml>return >>return ] + [ + "parameters" tag-named "parameter" tags-named + [ xml>parameter ] map >>parameters + ] bi ; + +: xml>function ( xml -- function ) + [ function new ] dip { + [ "name" attr >>name ] + [ "identifier" attr >>identifier ] + [ load-callable ] + [ "throws" attr "1" = >>throws? ] + } cleave ; + +: load-functions ( xml tag-name -- functions ) + tags-named [ xml>function ] map ; + : xml>field ( xml -- field ) [ field new ] dip { [ "name" attr >>name ] [ "writable" attr "1" = >>writable? ] - [ - child-type-tag dup name>> main>> "callback" = - [ drop "gpointer" ] [ "type" attr ] if - >>c-type - ] - [ - child-type-tag xml>type - [ [ >>array-info ] [ >>type ] bi* ] [ 2drop f ] if* - ] + [ "bits" attr string>number >>bits ] + [ child-type-tag xml>type >>type ] } cleave ; : xml>record ( xml -- record ) [ record new ] dip { [ load-type ] - [ "disguised" attr "1" = >>disguised? ] [ "field" tags-named [ xml>field ] map >>fields ] [ "constructor" load-functions >>constructors ] + [ "method" load-functions >>methods ] [ "function" load-functions >>functions ] - [ - "method" load-functions over type>self-param - '[ [ _ prefix ] change-parameters ] map - >>methods - ] + [ "disguised" attr "1" = >>disguised? ] } cleave ; : xml>union ( xml -- union ) - [ union new ] dip load-type ; - -: xml>alias ( xml -- alias ) - [ alias new ] dip { - [ node>type >>name ] - [ "target" attr full-type-name>type >>target ] + [ union new ] dip { + [ load-type ] + [ "field" tags-named [ xml>field ] map >>fields ] + [ "constructor" load-functions >>constructors ] + [ "method" load-functions >>methods ] + [ "function" load-functions >>functions ] } cleave ; -: xml>const ( xml -- const ) - [ const new ] dip { +: xml>callback ( xml -- callback ) + [ callback new ] dip { + [ load-type ] + [ load-callable ] + [ "throws" attr "1" = >>throws? ] + } cleave ; + +: xml>signal ( xml -- signal ) + [ signal new ] dip { [ "name" attr >>name ] - [ - "name" attr namespace-PREFIX get swap "_" glue - >>c-identifier - ] - [ "value" attr >>value ] - [ child-type-tag "type" attr >>c-type ] - [ child-type-tag xml>type nip >>type ] + [ load-callable ] } cleave ; +: xml>property ( xml -- property ) + [ property new ] dip { + [ "name" attr >>name ] + [ "writable" attr "1" = >>writable? ] + [ "readable" attr "0" = not >>readable? ] + [ "construct" attr "1" = >>construct? ] + [ "construct-only" attr "1" = >>construct-only? ] + [ child-type-tag xml>type >>type ] + } cleave ; + +: xml>class ( xml -- class ) + [ class new ] dip { + [ load-type ] + [ "abstract" attr "1" = >>abstract? ] + [ "parent" attr >>parent ] + [ "type-struct" attr >>type-struct ] + [ "constructor" load-functions >>constructors ] + [ "method" load-functions >>methods ] + [ "function" load-functions >>functions ] + [ "signal" tags-named [ xml>signal ] map >>signals ] + } cleave ; + +: xml>interface ( xml -- interface ) + [ interface new ] dip { + [ load-type ] + [ "method" load-functions >>methods ] + [ "function" load-functions >>functions ] + [ "signal" tags-named [ xml>signal ] map >>signals ] + } cleave ; + +: xml>boxed ( xml -- boxed ) + [ boxed new ] dip + load-type ; + : xml>namespace ( xml -- namespace ) [ namespace new ] dip { - [ "name" attr camel>factor >>name ] - [ "prefix" attr [ set-prefix ] keep >>prefix ] + [ "name" attr >>name ] + [ "identifier-prefixes" attr "," split >>identifier-prefixes ] + [ "symbol-prefixes" attr "," split >>symbol-prefixes ] [ "alias" tags-named [ xml>alias ] map >>aliases ] - [ "record" tags-named [ xml>record ] map >>records ] - [ "union" tags-named [ xml>union ] map >>unions ] - [ "callback" tags-named [ xml>callback ] map >>callbacks ] - [ "interface" tags-named [ xml>interface ] map >>interfaces ] - [ "class" tags-named [ xml>class ] map >>classes ] [ "constant" tags-named [ xml>const ] map >>consts ] [ "enumeration" tags-named [ xml>enum ] map >>enums ] [ "bitfield" tags-named [ xml>enum ] map >>bitfields ] + [ "record" tags-named [ xml>record ] map >>records ] + [ "union" tags-named [ xml>union ] map >>unions ] + [ "boxed" tags-named [ xml>boxed ] map >>boxeds ] + [ "callback" tags-named [ xml>callback ] map >>callbacks ] + [ "class" tags-named [ xml>class ] map >>classes ] + [ "interface" tags-named [ xml>interface ] map >>interfaces ] [ "function" load-functions >>functions ] } cleave ; : xml>repository ( xml -- repository ) - [ repository new ] dip { - [ - "" "include" f tags-named - [ "name" attr camel>factor ] map >>includes - ] - [ "namespace" tag-named xml>namespace >>namespace ] - } cleave ; - + [ repository new ] dip + "namespace" tag-named xml>namespace >>namespace ; diff --git a/basis/gobject-introspection/repository/repository.factor b/basis/gobject-introspection/repository/repository.factor index e6b2de7193..4344c99526 100644 --- a/basis/gobject-introspection/repository/repository.factor +++ b/basis/gobject-introspection/repository/repository.factor @@ -1,64 +1,134 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: ; IN: gobject-introspection.repository -TUPLE: node name ; +TUPLE: repository + namespace ; -TUPLE: repository includes namespace ; +TUPLE: namespace + name + identifier-prefixes + symbol-prefixes + aliases + consts + enums + bitfields + records + unions + boxeds + callbacks + classes + interfaces + functions ; -TUPLE: namespace < node - prefix aliases consts classes interfaces records unions callbacks - enums bitfields functions ; +TUPLE: data-type + name ; -TUPLE: alias < node target ; +TUPLE: simple-type < data-type + element-types ; -TUPLE: typed < node type c-type ; +TUPLE: array-type < data-type + zero-terminated? + fixed-size + length + element-type ; -TUPLE: const < typed - value c-identifier ffi ; +TUPLE: inner-callback-type < data-type ; -TUPLE: type-node < node - type c-type type-name get-type ffi ; +TUPLE: varargs-type < data-type ; -TUPLE: field < typed - writable? length? array-info ; +TUPLE: alias + name + c-type + type ; -TUPLE: record < type-node - fields constructors methods functions disguised? ; +TUPLE: const + name + value + type ; -TUPLE: union < type-node ; +TUPLE: type + name + c-type + get-type ; -TUPLE: class < record - abstract? parent type-struct signals ; +TUPLE: enum-member + name + value + c-identifier ; -TUPLE: interface < type-node - methods ; +TUPLE: enum < type + members ; -TUPLE: property < type-node - readable? writable? construct? construct-only? ; +TUPLE: record < type + fields + constructors + methods + functions + disguised? ; -TUPLE: callable < type-node - return parameters varargs? ; +TUPLE: field + name + writable? + bits + type ; -TUPLE: function < callable identifier ; +TUPLE: union < type + fields + constructors + methods + functions ; -TUPLE: callback < type-node return parameters varargs? ; +TUPLE: return + type + transfer-ownership ; -TUPLE: signal < callback ; +TUPLE: parameter + name + type + direction + allow-none? + transfer-ownership ; -TUPLE: parameter < typed - direction allow-none? length? transfer-ownership array-info - local ; +TUPLE: function + name + identifier + return + parameters + throws? ; -TUPLE: return < typed - transfer-ownership array-info local ; +TUPLE: callback < type + return + parameters + throws? ; -TUPLE: type name namespace ; +TUPLE: class < type + abstract? + parent + type-struct + constructors + methods + functions + signals ; -TUPLE: array-info zero-terminated? fixed-size length ; +TUPLE: interface < type + constructors + methods + functions + signals ; -TUPLE: enum-member < node value c-identifier ; +TUPLE: boxed < type ; -TUPLE: enum < type-node members ; +TUPLE: signal + name + return + parameters ; +TUPLE: property + name + readable? + writable? + construct? + construct-only? + type ; diff --git a/basis/gobject-introspection/standard-types/standard-types.factor b/basis/gobject-introspection/standard-types/standard-types.factor new file mode 100644 index 0000000000..53f1d1f85c --- /dev/null +++ b/basis/gobject-introspection/standard-types/standard-types.factor @@ -0,0 +1,71 @@ +! Copyright (C) 2010 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien.c-types alien.syntax +classes.struct gobject-introspection.types kernel parser ; +IN: gobject-introspection.standard-types + +<< +TYPEDEF: char gchar +TYPEDEF: uchar guchar +TYPEDEF: short gshort +TYPEDEF: ushort gushort +TYPEDEF: long glong +TYPEDEF: ulong gulong +TYPEDEF: int gint +TYPEDEF: uint guint + +TYPEDEF: char gint8 +TYPEDEF: uchar guint8 +TYPEDEF: short gint16 +TYPEDEF: ushort guint16 +TYPEDEF: int gint32 +TYPEDEF: uint guint32 +TYPEDEF: longlong gint64 +TYPEDEF: ulonglong guint64 + +TYPEDEF: float gfloat +TYPEDEF: double gdouble + +TYPEDEF: gulong GType +TYPEDEF: void* gpointer +TYPEDEF: guint32 gunichar +TYPEDEF: void* va_list + +int c-type clone + [ >c-bool ] >>unboxer-quot + [ c-bool> ] >>boxer-quot + object >>boxed-class +"gboolean" create-in typedef + +STRUCT: longdouble { data char[10] } ; +>> + +gchar "gchar" register-standard-type +guchar "guchar" register-standard-type +gshort "gshort" register-standard-type +gushort "gushort" register-standard-type +glong "glong" register-standard-type +gulong "gulong" register-standard-type +gint "gint" register-standard-type +guint "guint" register-standard-type + +gint8 "gint8" register-standard-type +guint8 "guint8" register-standard-type +gint16 "gint16" register-standard-type +guint16 "guint16" register-standard-type +gint32 "gint32" register-standard-type +guint32 "guint32" register-standard-type +gint64 "gint64" register-standard-type +guint64 "guint64" register-standard-type + +gfloat "gfloat" register-standard-type +gdouble "gdouble" register-standard-type + +GType "GType" register-standard-type +gpointer "gpointer" register-standard-type +gunichar "gunichar" register-standard-type +va_list "va_list" register-standard-type + +gboolean "gboolean" register-standard-type +pointer: gchar "utf8" register-standard-type +longdouble "long double" register-standard-type diff --git a/basis/gobject-introspection/types/types.factor b/basis/gobject-introspection/types/types.factor index f6d2257c79..f563b87853 100644 --- a/basis/gobject-introspection/types/types.factor +++ b/basis/gobject-introspection/types/types.factor @@ -1,138 +1,112 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types assocs -combinators.short-circuit gobject-introspection.common -gobject-introspection.repository kernel namespaces -specialized-arrays ; +USING: accessors alien.c-types assocs combinators.short-circuit +gobject-introspection.common gobject-introspection.repository kernel +locals namespaces parser sequences sets ; IN: gobject-introspection.types -TUPLE: gwrapper { underlying alien } ; -TUPLE: grecord < gwrapper ; -TUPLE: gobject < gwrapper ; +SYMBOL: type-infos +type-infos [ H{ } ] initialize -SPECIALIZED-ARRAYS: - void* bool int uint char uchar short ushort long ulong - longlong ulonglong float double ; +SYMBOL: standard-types +standard-types [ V{ } ] initialize -CONSTANT: simple-types H{ - { "any" { - void* *void* >void*-array - } } - { "boolean" { - bool *bool >bool-array - } } - { "int" { - int *int >int-array - } } - { "uint" { - uint *uint >uint-array - } } - { "int8" { - char *char >char-array - } } - { "uint8" { - uchar *uchar >uchar-array - } } - { "int16" { - short *short >short-array - } } - { "uint16" { - ushort *ushort >ushort-array - } } - { "int32" { - int *int >int-array - } } - { "uint32" { - uint *uint >uint-array - } } - { "int64" { - longlong *longlong - >longlong-array - } } - { "uint64" { - ulonglong *ulonglong - >ulonglong-array - } } - { "long" { - long *long >long-array - } } - { "ulong" { - ulong *ulong >ulong-array - } } - { "float" { - float *float >float-array - } } - { "double" { - double *double >double-array - } } - { "size_t" { - ulong *ulong >ulong-array - } } - { "ssize_t" { - long *long >long-array - } } - { "time_t" { - long *long >long-array - } } - { "gtype" { - ulong *ulong >ulong-array - } } -} - -TUPLE: type-info c-type-word type-word ; +TUPLE: type-info c-type ; +TUPLE: atomic-info < type-info ; TUPLE: enum-info < type-info ; - TUPLE: bitfield-info < type-info ; - TUPLE: record-info < type-info ; - TUPLE: union-info < type-info ; - +TUPLE: boxed-info < type-info ; TUPLE: callback-info < type-info ; - TUPLE: class-info < type-info ; - TUPLE: interface-info < type-info ; -: aliased-type ( alias -- type ) - aliases get ?at [ aliased-type ] when ; +DEFER: find-type-info -: get-type-info ( type -- info ) - aliased-type type-infos get at ; +PREDICATE: none-type < simple-type + name>> "none" = ; -PREDICATE: none-type < type - [ namespace>> not ] [ name>> "none" = ] bi and ; +PREDICATE: atomic-type < simple-type + find-type-info atomic-info? ; -PREDICATE: simple-type < type - aliased-type - [ namespace>> not ] [ name>> simple-types key? ] bi and ; +PREDICATE: utf8-type < atomic-type + name>> "utf8" = ; -PREDICATE: utf8-type < type - aliased-type - [ namespace>> not ] [ name>> "utf8" = ] bi and ; +PREDICATE: enum-type < simple-type + find-type-info enum-info? ; -PREDICATE: any-type < type - aliased-type - [ namespace>> not ] [ name>> "any" = ] bi and ; - -PREDICATE: enum-type < type get-type-info enum-info? ; +PREDICATE: bitfield-type < simple-type + find-type-info bitfield-info? ; -PREDICATE: bitfield-type < type get-type-info bitfield-info? ; +PREDICATE: record-type < simple-type + find-type-info record-info? ; -PREDICATE: record-type < type get-type-info record-info? ; +PREDICATE: union-type < simple-type + find-type-info union-info? ; -PREDICATE: union-type < type get-type-info union-info? ; +PREDICATE: boxed-type < simple-type + find-type-info boxed-info? ; -PREDICATE: callback-type < type get-type-info callback-info? ; +PREDICATE: callback-type < simple-type + find-type-info callback-info? ; -PREDICATE: class-type < type get-type-info class-info? ; +PREDICATE: class-type < simple-type + find-type-info class-info? ; -PREDICATE: interface-type < type get-type-info interface-info? ; +PREDICATE: interface-type < simple-type + find-type-info interface-info? ; -: absolute-type ( type -- type' ) - dup { - [ namespace>> ] [ simple-type? ] - [ utf8-type? ] [ none-type? ] - } 1|| [ current-lib get-global >>namespace ] unless ; +PREDICATE: boxed-array-type < array-type name>> >boolean ; +PREDICATE: c-array-type < array-type name>> not ; +PREDICATE: fixed-size-array-type < c-array-type fixed-size>> >boolean ; +: standard-type? ( data-type -- ? ) + name>> standard-types get-global in? ; + +: qualified-name ( name -- qualified-name ) + current-namespace-name get-global swap "." glue ; + +: qualified-type-name ( data-type -- name ) + [ name>> ] keep { + [ name>> CHAR: . swap member? ] + [ none-type? ] + [ standard-type? ] + } 1|| [ qualified-name ] unless ; + +ERROR: unknown-type-error type ; + +: get-type-info ( data-type -- info ) + qualified-type-name dup type-infos get-global at + [ ] [ unknown-type-error ] ?if ; + +: find-type-info ( data-type -- info/f ) + qualified-type-name type-infos get-global at ; + +:: register-type ( c-type type-info name -- ) + type-info c-type >>c-type name + type-infos get-global set-at ; + +: register-standard-type ( c-type name -- ) + dup standard-types get-global adjoin + atomic-info new swap register-type ; + +: register-atomic-type ( c-type name -- ) + atomic-info new swap register-type ; + +: register-enum-type ( c-type name -- ) + enum-info new swap register-type ; + +: register-record-type ( c-type name -- ) + record-info new swap register-type ; + +ERROR: deferred-type-error ; + +<< +void* c-type clone + [ drop deferred-type-error ] >>unboxer-quot + [ drop deferred-type-error ] >>boxer-quot + object >>boxed-class +"deferred-type" create-in typedef +>> diff --git a/basis/gobject/GObject-2.0.gir b/basis/gobject/GObject-2.0.gir index 8534b3a39c..edfd414242 100644 --- a/basis/gobject/GObject-2.0.gir +++ b/basis/gobject/GObject-2.0.gir @@ -2,7 +2,7 @@ - @@ -12,128 +12,294 @@ and/or use gtk-doc annotations. --> - - - - + + This is the signature of marshaller functions, required to marshall +arrays of parameter values to signal emissions into C language callback +invocations. It is merely an alias to #GClosureMarshal since the #GClosure +mechanism takes over responsibility of actual function invocation for the +signal system. + + + + A C representable type name for #G_TYPE_STRV. + + + + A numerical value which represents the unique identifier of a registered +type. + + + - + A callback function used by the type system to finalize those portions of a derived types class structure that were setup from the corresponding GBaseInitFunc() function. Class finalization basically works the inverse way in which class intialization is performed. -See GClassInitFunc() for a discussion of the class intialization process."> +See GClassInitFunc() for a discussion of the class intialization process. - + The #GTypeClass structure to finalize. + - + A callback function used by the type system to do base initialization of the class structures of derived types. It is called as part of the initialization process of all derived classes and should reallocate or reset all dynamic class members copied over from the parent class. For example, class members (such as strings) that are not sufficiently handled by a plain memory copy of the parent class into the derived class have to be altered. See GClassInitFunc() for a discussion of the class -intialization process."> +intialization process. - + The #GTypeClass structure to initialize. + - + + <structname>GBinding</structname> is an opaque structure whose members +cannot be accessed directly. + + Retrieves the flags passed when constructing the #GBinding + + the #GBindingFlags used by the #GBinding + + + + + Retrieves the #GObject instance used as the source of the binding + + the source #GObject + + + + + Retrieves the name of the property of #GBinding:source used as the source +of the binding + + the name of the source property + + + + + Retrieves the #GObject instance used as the target of the binding + + the target #GObject + + + + + Retrieves the name of the property of #GBinding:target used as the target +of the binding + + the name of the target property + + + + + Flags to be used to control the #GBinding + + + + The #GObject that should be used as the source of the binding + + + + The name of the property of #GBinding:source that should be used +as the source of the binding + + + + The #GObject that should be used as the target of the binding + + + + The name of the property of #GBinding:target that should be used +as the target of the binding + + + + + Flags to be passed to g_object_bind_property() or +g_object_bind_property_full(). +This enumeration can be extended at later date. + + + + + + + A function to be called to transform the source property of @source +from @source_value into the target property of @target +using @target_value. +otherwise - + %TRUE if the transformation was successful, and %FALSE + + + + + a #GBinding + + + + the value of the source property + + + + the value of the target property + + + + data passed to the transform function + + + + + + This function is provided by the user and should produce a copy of the passed +in boxed structure. + + The newly created copy of the boxed structure. + - + The boxed structure to be copied. + - + + This function is provided by the user and should free the boxed +structure passed. - + The boxed structure to be freed. + - - + + A #GCClosure is a specialization of #GClosure for C function callbacks. - + - + + The type used for callback functions in structure definitions and function +signatures. This doesn't mean that all callback functions must take no +parameters and return void. The required signature of a callback function +is determined by the context in which is used (e.g. the signal to which it +is connected). Use G_CALLBACK() to cast the callback function to a #GCallback. - + A callback function used by the type system to finalize a class. This function is rarely needed, as dynamically allocated class resources should be handled by GBaseInitFunc() and GBaseFinalizeFunc(). Also, specification of a GClassFinalizeFunc() in the #GTypeInfo structure of a static type is invalid, because classes of static types will never be finalized (they are artificially kept alive when their -reference count drops to zero)."> +reference count drops to zero). - + The #GTypeClass structure to finalize. + - + The @class_data member supplied via the #GTypeInfo structure. + - + A callback function used by the type system to initialize the class of a specific type. This function should initialize all static class members. The initialization process of a class involves: @@ -148,10 +314,10 @@ over from the parent class. </para></listitem> <listitem><para> 3 - Invocation of the GBaseInitFunc() initializers of all parent -types and the class' type. +types and the class' type. </para></listitem> <listitem><para> -4 - Invocation of the class' GClassInitFunc() initializer. +4 - Invocation of the class' GClassInitFunc() initializer. </para></listitem> </itemizedlist> Since derived classes are partially initialized through a memory copy @@ -175,7 +341,7 @@ gchar *dynamic_string; static void type_a_base_class_init (TypeAClass *class) { -class->dynamic_string = g_strdup ("some string"); +class->dynamic_string = g_strdup ("some string"); } static void type_a_base_class_finalize (TypeAClass *class) @@ -195,7 +361,7 @@ GString *dynamic_gstring; static void type_b_base_class_init (TypeBClass *class) { -class->dynamic_gstring = g_string_new ("some other string"); +class->dynamic_gstring = g_string_new ("some other string"); } static void type_b_base_class_finalize (TypeBClass *class) @@ -216,7 +382,7 @@ then calling its GBaseInitFunc() type_a_base_class_init() to allocate its dynamic members (dynamic_string), and finally calling its GClassInitFunc() type_a_class_init() to initialize its static members (static_integer). The first step in the initialization process of TypeBClass is then -a plain memory copy of the contents of TypeAClass into TypeBClass and +a plain memory copy of the contents of TypeAClass into TypeBClass and zero-initialization of the remaining fields in TypeBClass. The dynamic members of TypeAClass within TypeBClass now need reinitialization which is performed by calling type_a_base_class_init() @@ -228,334 +394,510 @@ is called to complete the initialization process with the static members (static_float). Corresponding finalization counter parts to the GBaseInitFunc() functions have to be provided to release allocated resources at class finalization -time."> +time. - + The #GTypeClass structure to initialize. + - + The @class_data member supplied via the #GTypeInfo structure. + + glib:get-type="g_closure_get_type" + c:symbol-prefix="closure"> + A #GClosure represents a callback supplied by the programmer. - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + - + - - - - - - - - - - - - - + A variant of g_closure_new_simple() which stores @object in the +when implementing new types of closures. + a newly allocated #GClosure - + the size of the structure to allocate, must be at least <literal>sizeof (GClosure)</literal> + + a #GObject pointer to store in the @data field of the newly allocated #GClosure - + + Allocates a struct of the given size and initializes the initial +part as a #GClosure. This function is mainly useful when +implementing new types of closures. +|[ +typedef struct _MyClosure MyClosure; +struct _MyClosure +{ +GClosure closure; +// extra data goes here +}; +static void +my_closure_finalize (gpointer notify_data, +GClosure *closure) +{ +MyClosure *my_closure = (MyClosure *)closure; +// free extra data here +} +MyClosure *my_closure_new (gpointer data) +{ +GClosure *closure; +MyClosure *my_closure; +closure = g_closure_new_simple (sizeof (MyClosure), data); +my_closure = (MyClosure *) closure; +// initialize extra data here +g_closure_add_finalize_notifier (closure, notify_data, +my_closure_finalize); +return my_closure; +} +]| + a newly allocated #GClosure - - - - - - - - - - - - - - - - - + + the size of the structure to allocate, must be at least <literal>sizeof (GClosure)</literal> + - - + + data to store in the @data field of the newly allocated #GClosure + - - + + + Registers a finalization notifier which will be called when the +reference count of @closure goes down to 0. Multiple finalization +notifiers on a single closure are invoked in unspecified order. If +a single call to g_closure_unref() results in the closure being +both invalidated and finalized, then the invalidate notifiers will +be run before the finalize notifiers. - + data to pass to @notify_func + - + + the callback function to register + c:identifier="g_closure_add_invalidate_notifier" + introspectable="0"> + Registers an invalidation notifier which will be called when the +notifiers are invoked before finalization notifiers, in an +unspecified order. - + data to pass to @notify_func + - - - - - - - - - - - - - - + + the callback function to register + c:identifier="g_closure_add_marshal_guards" + introspectable="0"> + Adds a pair of notifiers which get invoked before and after the +closure callback, respectively. This is typically used to protect +the extra arguments for the duration of the callback. See +g_object_watch_closure() for an example of marshal guards. - + data to pass to @pre_marshal_notify + + closure="2"> + a function to call before the closure callback - + data to pass to @post_marshal_notify + - + + a function to call after the closure callback - - - - - - - - - - - - - - - - - - - - - - - + Sets a flag on the closure to indicate that its calling +environment has become invalid, and thus causes any future +invocations of g_closure_invoke() on this @closure to be +ignored. Also, invalidation notifiers installed on the closure will +be called at this point. Note that unless you are holding a +reference to the closure yourself, the invalidation notifiers may +unref the closure and cause it to be destroyed, so if you need to +access the closure after calling g_closure_invalidate(), make sure +that you've previously called g_closure_ref(). +Note that g_closure_invalidate() will also be called when the +reference count of a closure drops to zero (unless it has already +been invalidated before). + Invokes the closure, i.e. executes the callback represented by the @closure. + a #GValue to store the return value. May be %NULL if the callback of @closure doesn't return a value. - + the length of the @param_values array + + an array of #GValue<!-- -->s holding the arguments on which to invoke the callback of @closure - + a context-dependent invocation hint + + + Increments the reference count on a closure to force it staying +alive while the caller holds a pointer to it. + + The @closure passed in, for convenience + + + + + Removes a finalization notifier. +Notice that notifiers are automatically removed after they are run. + + + + + + data which was passed to g_closure_add_finalize_notifier() when registering @notify_func + + + + the callback function to remove + + + + + + Removes an invalidation notifier. +Notice that notifiers are automatically removed after they are run. + + + + + + data which was passed to g_closure_add_invalidate_notifier() when registering @notify_func + + + + the callback function to remove + + + + + + Sets the marshaller of @closure. The <literal>marshal_data</literal> +of @marshal provides a way for a meta marshaller to provide additional +information to the marshaller. (See g_closure_set_meta_marshal().) For +GObject's C predefined marshallers (the g_cclosure_marshal_*() +functions), what it provides is a callback function to use instead of + + + + + + a #GClosureMarshal function + + + + + + Sets the meta marshaller of @closure. A meta marshaller wraps +fashion. The most common use of this facility is for C callbacks. +The same marshallers (generated by <link +linkend="glib-genmarshal">glib-genmarshal</link>) are used +everywhere, but the way that we get the callback function +differs. In most cases we want to use @closure->callback, but in +other cases we want to use some different technique to retrieve the +callback function. +For example, class closures for signals (see +g_signal_type_cclosure_new()) retrieve the callback function from a +fixed offset in the class structure. The meta marshaller retrieves +the right callback and passes it to the marshaller as the + + + + + + context-dependent data to pass to @meta_marshal + + + + a #GClosureMarshal function + + + + + + Takes over the initial ownership of a closure. Each closure is +initially created in a <firstterm>floating</firstterm> state, which +means that the initial reference count is not owned by any caller. +g_closure_sink() checks to see if the object is still floating, and +if so, unsets the floating state and decreases the reference +count. If the closure is not floating, g_closure_sink() does +nothing. The reason for the existance of the floating state is to +prevent cumbersome code sequences like: +|[ +closure = g_cclosure_new (cb_func, cb_data); +g_source_set_closure (source, closure); +g_closure_unref (closure); // XXX GObject doesn't really need this +]| +Because g_source_set_closure() (and similar functions) take ownership of the +initial reference count, if it is unowned, we instead can write: +|[ +g_source_set_closure (source, g_cclosure_new (cb_func, cb_data)); +]| +Generally, this function is used together with g_closure_ref(). Ane example +of storing a closure for later notification looks like: +|[ +static GClosure *notify_closure = NULL; +void +foo_notify_set_closure (GClosure *closure) +{ +if (notify_closure) +g_closure_unref (notify_closure); +notify_closure = closure; +if (notify_closure) +{ +g_closure_ref (notify_closure); +g_closure_sink (notify_closure); +} +} +]| +Because g_closure_sink() may decrement the reference count of a closure +(if it hasn't been called on @closure yet) just like g_closure_unref(), +g_closure_ref() should be called prior to this function. + + + + + + Decrements the reference count of a closure after it was previously +incremented by the same caller. If no other callers are using the +closure, then the closure will be destroyed and freed. + + + + - + + The type used for marshaller functions. + the #GClosure to which the marshaller belongs + a #GValue to store the return value. May be %NULL if the callback of @closure doesn't return a value. - + the length of the @param_values array + + an array of #GValue<!-- -->s holding the arguments on which to invoke the callback of @closure - + the invocation hint given as the last argument to g_closure_invoke() + - + additional data specified when registering the marshaller, see g_closure_set_marshal() and g_closure_set_meta_marshal() + - + + The type used for the various notification callbacks which can be registered +on closures. - + data specified when registering the notification callback + + the #GClosure on which the notification is emitted - + - + + The connection flags are used to specify the behaviour of a signal's +connection. - - + + + + The class of an enumeration type holds information about its +possible values. - + - + - + - + + A structure which contains a single enum value, its name, and its +nickname. - + @@ -564,30 +906,32 @@ nickname."> - + + + + The class of a flags type holds information about its +possible values. - + - + - + + A structure which contains a single flags value, its name, and its +nickname. - + @@ -596,13 +940,13 @@ nickname."> - - @@ -621,20 +965,602 @@ nickname."> glib:nick="nval"/> + All the fields in the <structname>GInitiallyUnowned</structname> structure +are private to the #GInitiallyUnowned implementation and should never be +accessed directly. + + Creates a binding between @source_property on @source and @target_property +on @target. Whenever the @source_property is changed the @target_property is +updated using the same value. For instance: +|[ +g_object_bind_property (action, "active", widget, "sensitive", 0); +]| +Will result in the "sensitive" property of the widget #GObject instance to be +updated with the same value of the "active" property of the action #GObject +instance. +If @flags contains %G_BINDING_BIDIRECTIONAL then the binding will be mutual: +if @target_property on @target changes then the @source_property on @source +will be updated as well. +The binding will automatically be removed when either the @source or the +#GBinding instance. +A #GObject can have multiple bindings. +binding between the two #GObject instances. The binding is released +whenever the #GBinding reference count reaches zero. + + the #GBinding instance representing the + + + + + the source #GObject + + + + the property on @source to bind + + + + the target #GObject + + + + the property on @target to bind + + + + flags to pass to #GBinding + + + + + + Complete version of g_object_bind_property(). +Creates a binding between @source_property on @source and @target_property +on @target, allowing you to set the transformation functions to be used by +the binding. +If @flags contains %G_BINDING_BIDIRECTIONAL then the binding will be mutual: +if @target_property on @target changes then the @source_property on @source +will be updated as well. The @transform_from function is only used in case +of bidirectional bindings, otherwise it will be ignored +The binding will automatically be removed when either the @source or the +#GBinding instance. +A #GObject can have multiple bindings. +<note>The same @user_data parameter will be used for both @transform_to +and @transform_from transformation functions; the @notify function will +be called once, when the binding is removed. If you need different data +for each transformation function, please use +g_object_bind_property_with_closures() instead.</note> +binding between the two #GObject instances. The binding is released +whenever the #GBinding reference count reaches zero. + + the #GBinding instance representing the + + + + + the source #GObject + + + + the property on @source to bind + + + + the target #GObject + + + + the property on @target to bind + + + + flags to pass to #GBinding + + + + the transformation function from the @source to the @target, or %NULL to use the default + + + + the transformation function from the @target to the @source, or %NULL to use the default + + + + custom data to be passed to the transformation functions, or %NULL + + + + function to be called when disposing the binding, to free the resources used by the transformation functions + + + + + + Creates a binding between @source_property on @source and @target_property +on @target, allowing you to set the transformation functions to be used by +the binding. +This function is the language bindings friendly version of +g_object_bind_property_full(), using #GClosure<!-- -->s instead of +function pointers. +binding between the two #GObject instances. The binding is released +whenever the #GBinding reference count reaches zero. + + the #GBinding instance representing the + + + + + the source #GObject + + + + the property on @source to bind + + + + the target #GObject + + + + the property on @target to bind + + + + flags to pass to #GBinding + + + + a #GClosure wrapping the transformation function from the @source to the @target, or %NULL to use the default + + + + a #GClosure wrapping the transformation function from the @target to the @source, or %NULL to use the default + + + + + + + + + + + + + + + + + + + A convenience function to connect multiple signals at once. +The signal specs expected by this function have the form +"modifier::signal_name", where modifier can be one of the following: +<variablelist> +<varlistentry> +<term>signal</term> +<listitem><para> +equivalent to <literal>g_signal_connect_data (..., NULL, 0)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>object_signal</term> +<term>object-signal</term> +<listitem><para> +equivalent to <literal>g_signal_connect_object (..., 0)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>swapped_signal</term> +<term>swapped-signal</term> +<listitem><para> +equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>swapped_object_signal</term> +<term>swapped-object-signal</term> +<listitem><para> +equivalent to <literal>g_signal_connect_object (..., G_CONNECT_SWAPPED)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>signal_after</term> +<term>signal-after</term> +<listitem><para> +equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_AFTER)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>object_signal_after</term> +<term>object-signal-after</term> +<listitem><para> +equivalent to <literal>g_signal_connect_object (..., G_CONNECT_AFTER)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>swapped_signal_after</term> +<term>swapped-signal-after</term> +<listitem><para> +equivalent to <literal>g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED | G_CONNECT_AFTER)</literal> +</para></listitem> +</varlistentry> +<varlistentry> +<term>swapped_object_signal_after</term> +<term>swapped-object-signal-after</term> +<listitem><para> +equivalent to <literal>g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)</literal> +</para></listitem> +</varlistentry> +</variablelist> +|[ +menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW, +"type", GTK_WINDOW_POPUP, +"child", menu, +NULL), +"signal::event", gtk_menu_window_event, menu, +"signal::size_request", gtk_menu_window_size_request, menu, +"signal::destroy", gtk_widget_destroyed, &amp;menu-&gt;toplevel, +NULL); +]| + + @object + + + + + a #GObject + + + + the spec for the first signal + + + + + + + + + + A convenience function to disconnect multiple signals at once. +The signal specs expected by this function have the form +"any_signal", which means to disconnect any signal with matching +callback and data, or "any_signal::signal_name", which only +disconnects the signal named "signal_name". + + + + + + a #GObject + + + + the spec for the first signal + + + + + + + + + + Gets properties of an object. +In general, a copy is made of the property contents and the caller +is responsible for freeing the memory in the appropriate manner for +the type, for instance by calling g_free() or g_object_unref(). +<example> +<title>Using g_object_get(<!-- -->)</title> +An example of using g_object_get() to get the contents +of three properties - one of type #G_TYPE_INT, +one of type #G_TYPE_STRING, and one of type #G_TYPE_OBJECT: +<programlisting> +gint intval; +gchar *strval; +GObject *objval; +g_object_get (my_object, +"int-property", &intval, +"str-property", &strval, +"obj-property", &objval, +NULL); +// Do something with intval, strval, objval +g_free (strval); +g_object_unref (objval); +</programlisting> +</example> + + + + + + a #GObject + + + + name of the first property to get + + + + + + + + + + Find the #GParamSpec with the given name for an +interface. Generally, the interface vtable passed in as @g_iface +will be the default vtable from g_type_default_interface_ref(), or, +if you know the interface has already been loaded, +g_type_default_interface_peek(). +name @property_name, or %NULL if no such property exists. + + the #GParamSpec for the property of the interface with the + + + + + any interface vtable for the interface, or the default vtable for the interface + + + + name of a property to lookup. + + + + + + Add a property to an interface; this is only useful for interfaces +that are added to GObject-derived types. Adding a property to an +interface forces all objects classes with that interface to have a +compatible property. The compatible property could be a newly +created #GParamSpec, but normally +g_object_class_override_property() will be used so that the object +class only needs to provide an implementation and inherits the +property description, default value, bounds, and so forth from the +interface property. +This function is meant to be called from the interface's default +vtable initialization function (the @class_init member of +#GTypeInfo.) It must not be called after after @class_init has +been called for any object types implementing this interface. + + + + + + any interface vtable for the interface, or the default vtable for the interface. + + + + the #GParamSpec for the new property + + + + + + Lists the properties of an interface.Generally, the interface +vtable passed in as @g_iface will be the default vtable from +g_type_default_interface_ref(), or, if you know the interface has +already been loaded, g_type_default_interface_peek(). +structures. The paramspecs are owned by GLib, but the +array should be freed with g_free() when you are done with +it. + + a pointer to an array of pointers to #GParamSpec + + + + + any interface vtable for the interface, or the default vtable for the interface + + + + location to store number of properties returned. + + + + + + Checks wether @object has a <link linkend="floating-ref">floating</link> +reference. + + %TRUE if @object has a floating reference + + + + + a #GObject + + + + + + Creates a new instance of a #GObject subtype and sets its properties. +Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) +which are not explicitly specified are set to their default values. + + a new instance of @object_type + + + + + the type id of the #GObject subtype to instantiate + + + + the name of the first property + + + + + + + + + + Creates a new instance of a #GObject subtype and sets its properties. +Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) +which are not explicitly specified are set to their default values. + + a new instance of @object_type + + + + + the type id of the #GObject subtype to instantiate + + + + the name of the first property + + + + the value of the first property, followed optionally by more name/value pairs, followed by %NULL + + + + + + Creates a new instance of a #GObject subtype and sets its properties. +Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) +which are not explicitly specified are set to their default values. + + a new instance of @object_type + + + + + the type id of the #GObject subtype to instantiate + + + + the length of the @parameters array + + + + an array of #GParameter + + + + + + Increases the reference count of @object. + + the same @object + + + + + a #GObject + + + + + + Increase the reference count of @object, and possibly remove the +<link linkend="floating-ref">floating</link> reference, if @object +has a floating reference. +In other words, if the object is floating, then this call "assumes +ownership" of the floating reference, converting it to a normal +reference by clearing the floating flag while leaving the reference +count unchanged. If the object is not floating, then this call +adds a new normal reference increasing the reference count by one. + + @object + + + + + a #GObject + + + + + + Sets properties on an object. + + + + + + a #GObject + + + + name of the first property to set + + + + + + + + + + + + + + + Decreases the reference count of @object. When its reference count +drops to 0, the object is finalized (i.e. its memory is freed). + + + + + + a #GObject + + + + - + @@ -642,17 +1568,20 @@ accessed directly." + disguised="1" + glib:is-gtype-struct-for="InitiallyUnowned"> + The class structure for the <structname>GInitiallyUnowned</structname> type. - + + + - - - + + + @@ -660,7 +1589,7 @@ accessed directly." - + - + @@ -679,7 +1608,7 @@ accessed directly." - + @@ -691,7 +1620,7 @@ accessed directly." - + @@ -700,7 +1629,7 @@ accessed directly." - + @@ -712,7 +1641,7 @@ accessed directly." - + @@ -724,7 +1653,7 @@ accessed directly." - + @@ -736,8 +1665,7 @@ accessed directly." - + @@ -746,7 +1674,7 @@ accessed directly." - + @@ -755,7 +1683,7 @@ accessed directly." - + @@ -770,7 +1698,7 @@ accessed directly." - + @@ -782,56 +1710,57 @@ accessed directly." - + - + - + A callback function used by the type system to initialize a new instance of a type. This function initializes all instance members and allocates any resources required by it. Initialization of a derived instance involves calling all its parent types instance initializers, so the class member of the instance is altered during its initialization to always point to the class that -belongs to the type the current initializer was introduced for."> +belongs to the type the current initializer was introduced for. + The instance to initialize. - + The class of the type the instance is created for. + - + A callback function used by the type system to finalize an interface. This function should destroy any internal data and release any resources -allocated by the corresponding GInterfaceInitFunc() function."> +allocated by the corresponding GInterfaceInitFunc() function. - + The interface structure to finalize. + - + The @interface_data supplied via the #GInterfaceInfo structure. + - + + A structure that provides information to the type system which is +used specifically for managing interface types. @@ -839,63 +1768,51 @@ used specifically for managing interface types."> - + - + A callback function used by the type system to initialize a new interface. This function should initialize all internal data and -allocate any resources required by the interface."> +allocate any resources required by the interface. - + The interface structure to initialize. + - + The @interface_data supplied via the #GInterfaceInfo structure. + - + All the fields in the <structname>GObject</structname> structure are private +to the #GObject implementation and should never be accessed directly. + - - - - - - - - - - - - + - - + + - - - - - + + @@ -909,20 +1826,27 @@ to the #GObject implementation and should never be accessed directly." - + - - + + - - + + + + + - + + Emits a "notify" signal for the property @property_name on @object. +When possible, eg. when signaling a property change from within the class +that registered the property, you should use g_object_notify_by_pspec() +instead. @@ -932,270 +1856,539 @@ to the #GObject implementation and should never be accessed directly." - + + + + + + + + + + + + - + + Increases the reference count of the object by one and sets a +callback to be called when all other references to the object are +dropped, or when this is already the last reference to the object +and another reference is established. +This functionality is intended for binding @object to a proxy +object managed by another memory manager. This is done with two +g_object_add_toggle_ref() and a reverse reference to the proxy +object which is either a strong reference or weak reference. +The setup is that when there are no other references to @object, +only a weak reference is held in the reverse direction from @object +to the proxy object, but when there are other references held to +when the reference from @object to the proxy object should be +<firstterm>toggled</firstterm> from strong to weak (@is_last_ref +true) or weak to strong (@is_last_ref false). +Since a (normal) reference must be held to the object before +calling g_object_toggle_ref(), the initial state of the reverse +link is always strong. +Multiple toggle references may be added to the same gobject, +however if there are multiple toggle references to an object, none +of them will ever be notified until all but one are removed. For +this reason, you should only ever use a toggle reference if there +is important state in the proxy object. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a function to call when this reference is the last reference to the object, or is no longer the last reference. + - - - - - - - - - - - - - - + data to pass to @notify + + Adds a weak reference from weak_pointer to @object to indicate that +the pointer located at @weak_pointer_location is only valid during +the lifetime of @object. When the @object is finalized, - + caller-allocates="0" + transfer-ownership="full"> + The memory address of a pointer. + + + + + + This function is intended for #GObject implementations to re-enforce a +<link linkend="floating-ref">floating</link> object reference. +Doing this is seldomly required, all +#GInitiallyUnowned<!-- -->s are created with a floating reference which +usually just needs to be sunken by calling g_object_ref_sink(). + + + + + + Increases the freeze count on @object. If the freeze count is +non-zero, the emission of "notify" signals on @object is +stopped. The signals are queued until the freeze count is decreased +to zero. +This is necessary for accessors that modify multiple properties to prevent +premature notification while the object is still being modified. + + + + + + Gets a named field from the objects table of associations (see g_object_set_data()). + + the data if found, or %NULL if no such data exists. + + + + + name of the key for that association + + + + + + Gets a property of an object. +In general, a copy is made of the property contents and the caller is +responsible for freeing the memory by calling g_value_unset(). +Note that g_object_get_property() is really intended for language +bindings, g_object_get() is much more convenient for C programming. + + + + + + the name of the property to get + + + + return location for the property value + + + + + + This function gets back user data pointers stored via +g_object_set_qdata(). + + The user data pointer set, or %NULL + + + + + A #GQuark, naming the user data pointer + + + + + + Gets properties of an object. +In general, a copy is made of the property contents and the caller +is responsible for freeing the memory in the appropriate manner for +the type, for instance by calling g_free() or g_object_unref(). +See g_object_get(). + + + + + + name of the first property to get + + + + return location for the first property, followed optionally by more name/return location pairs, followed by %NULL + + + + + + Emits a "notify" signal for the property @property_name on @object. +When possible, eg. when signaling a property change from within the class +that registered the property, you should use g_object_notify_by_pspec() +instead. + + + + + + the name of a property installed on the class of @object. + + + + + + Emits a "notify" signal for the property specified by @pspec on @object. +This function omits the property name lookup, hence it is faster than +g_object_notify(). +One way to avoid using g_object_notify() from within the +class that registered the properties, and using g_object_notify_by_pspec() +instead, is to store the GParamSpec used with +g_object_class_install_property() inside a static array, e.g.: +|[ +enum +{ +PROP_0, +PROP_FOO, +PROP_LAST +}; +static GParamSpec *properties[PROP_LAST]; +static void +my_object_class_init (MyObjectClass *klass) +{ +properties[PROP_FOO] = g_param_spec_int ("foo", "Foo", "The foo", +0, 100, +50, +G_PARAM_READWRITE); +g_object_class_install_property (gobject_class, +PROP_FOO, +properties[PROP_FOO]); +} +]| +and then notify a change on the "foo" property with: +|[ +g_object_notify_by_pspec (self, properties[PROP_FOO]); +]| + + + + + + the #GParamSpec of a property installed on the class of @object. + + + + + + Removes a reference added with g_object_add_toggle_ref(). The +reference count of the object is decreased by one. + + + + + + a function to call when this reference is the last reference to the object, or is no longer the last reference. + + + + data to pass to @notify + + Removes a weak reference from @object that was previously added +using g_object_add_weak_pointer(). The @weak_pointer_location has +to match the one used with g_object_add_weak_pointer(). - + caller-allocates="0" + transfer-ownership="full"> + The memory address of a pointer. + - + + Releases all references to other objects. This can be used to break +reference cycles. +This functions should only be called from object system implementations. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Each object carries around a table of associations from +strings to pointers. This function lets you set an association. +If the object already had an association with that name, +the old association will be destroyed. + name of the key - + data to associate with that key + + Like g_object_set_data() except it adds notification +for when the association is destroyed, either by setting it +to a different value or when the object is destroyed. +Note that the @destroy callback is not called if @data is %NULL. + name of the key - + data to associate with that key + - + + function to call when the association is destroyed - + + Sets a property on an object. - + + + + + the name of the property to set + + + + the value + + + + + + This sets an opaque, named pointer on an object. +The name is specified through a #GQuark (retrived e.g. via +g_quark_from_static_string()), and the pointer +can be gotten back from the @object with g_object_get_qdata() +until the @object is finalized. +Setting a previously set user data pointer, overrides (frees) +the old pointer set, using #NULL as pointer essentially +removes the data stored. + + + + + + A #GQuark, naming the user data pointer + + + + An opaque user data pointer + + + + + + This function works like g_object_set_qdata(), but in addition, +a void (*destroy) (gpointer) function may be specified which is +called with @data as argument when the @object is finalized, or +the data is being overwritten by a call to g_object_set_qdata() +with the same @quark. + + + + + + A #GQuark, naming the user data pointer + + + + An opaque user data pointer + + + + Function to invoke with @data as argument, when @data needs to be freed + + + + + + Sets properties on an object. + + + + + + name of the first property to set + + + + value for the first property, followed optionally by more name/value pairs, followed by %NULL + + + + + + Remove a specified datum from the object's data associations, +without invoking the association's destroy handler. + + the data if found, or %NULL if no such data exists. + + name of the key + + This function gets back user data pointers stored via +g_object_set_qdata() and removes the @data from object +without invoking its destroy() function (if any was +set). +Usually, calling this function is only required to update +user data pointers with a destroy notifier, for example: +|[ +void +object_add_to_user_list (GObject *object, +const gchar *new_string) +{ +// the quark, naming the object data +GQuark quark_string_list = g_quark_from_static_string ("my-string-list"); +// retrive the old string list +GList *list = g_object_steal_qdata (object, quark_string_list); +// prepend new string +list = g_list_prepend (list, g_strdup (new_string)); +// this changed 'list', so we need to set it again +g_object_set_qdata_full (object, quark_string_list, list, free_string_list); +} +static void +free_string_list (gpointer data) +{ +GList *node, *list = data; +for (node = list; node; node = node->next) +g_free (node->data); +g_list_free (list); +} +]| +Using g_object_get_qdata() in the above example, instead of +g_object_steal_qdata() would have left the destroy function set, +and thus the partial string list would have been freed upon +g_object_set_qdata_full(). + + The user data pointer set, or %NULL + + + + + A #GQuark, naming the user data pointer + + + + + + Reverts the effect of a previous call to +g_object_freeze_notify(). The freeze count is decreased on @object +and when it reaches zero, all queued "notify" signals are emitted. +It is an error to call this function when the freeze count is zero. + + + + + This function essentially limits the life time of the @closure to +the life time of the object. That is, when the object is finalized, +the @closure is invalidated by calling g_closure_invalidate() on +it, in order to prevent invocations of the closure with a finalized +(nonexisting) object. Also, g_object_ref() and g_object_unref() are +added as marshal guards to the @closure, to ensure that an extra +reference count is held on @object during invocation of the +use this @object as closure data. + GClosure to watch - + + Adds a weak reference callback to an object. Weak references are +used for notification when an object is finalized. They are called +"weak references" because they allow you to safely hold a pointer +to an object without calling g_object_ref() (g_object_ref() adds a +strong reference, that is, forces the object to stay alive). + + + callback to invoke before the object is freed + + + + extra data to pass to notify + + + - + + Removes a weak reference callback to an object. + + + callback to search for + + + + data to search for + + + - + @@ -1203,29 +2396,8 @@ to the #GObject implementation and should never be accessed directly." + The class structure for the <structname>GObject</structname> type. <example> <title>Implementing singletons using a constructor</title> <programlisting> @@ -1247,16 +2419,18 @@ else object = g_object_ref (G_OBJECT (the_singleton)); return object; } -</programlisting></example>"> +</programlisting></example> - + + + - - - + + + @@ -1264,7 +2438,7 @@ return object; - + - + @@ -1283,7 +2457,7 @@ return object; - + @@ -1295,7 +2469,7 @@ return object; - + @@ -1304,7 +2478,7 @@ return object; - + @@ -1316,7 +2490,7 @@ return object; - + @@ -1328,7 +2502,7 @@ return object; - + @@ -1340,8 +2514,7 @@ return object; - + @@ -1350,7 +2523,7 @@ return object; - + @@ -1359,7 +2532,7 @@ return object; - + @@ -1374,7 +2547,7 @@ return object; - + @@ -1386,72 +2559,173 @@ return object; - + - + + + Looks up the #GParamSpec for a property of a class. +doesn't have a property of that name + + the #GParamSpec for the property, or %NULL if the class + + + + + the name of the property to look up + + + + + + Installs new properties from an array of #GParamSpec<!-- -->s. This is +usually done in the class initializer. +The property id of each property is the index of each #GParamSpec in +the @pspecs array. +The property id of 0 is treated specially by #GObject and it should not +be used to store a #GParamSpec. +This function should be used if you plan to use a static array of +#GParamSpec<!-- -->s and g_object_notify_pspec(). For instance, this +class initialization: +|[ +enum { +PROP_0, PROP_FOO, PROP_BAR, N_PROPERTIES +}; +static GParamSpec *obj_properties[N_PROPERTIES] = { NULL, }; +static void +my_object_class_init (MyObjectClass *klass) +{ +GObjectClass *gobject_class = G_OBJECT_CLASS (klass); +obj_properties[PROP_FOO] = +g_param_spec_int ("foo", "Foo", "Foo", +-1, G_MAXINT, +0, +G_PARAM_READWRITE); +obj_properties[PROP_BAR] = +g_param_spec_string ("bar", "Bar", "Bar", +NULL, +G_PARAM_READWRITE); +gobject_class->set_property = my_object_set_property; +gobject_class->get_property = my_object_get_property; +g_object_class_install_properties (gobject_class, +N_PROPERTIES, +obj_properties); +} +]| +allows calling g_object_notify_by_pspec() to notify of property changes: +|[ +void +my_object_set_foo (MyObject *self, gint foo) +{ +if (self->foo != foo) +{ +self->foo = foo; +g_object_notify_by_pspec (G_OBJECT (self), obj_properties[PROP_FOO]); +} +} +]| + + + + + + the length of the #GParamSpec<!-- -->s array + + + + the #GParamSpec<!-- -->s array defining the new properties + + + + + + + Installs a new property. This is usually done in the class initializer. +Note that it is possible to redefine a property in a derived class, +by installing a property with the same name. This can be useful at times, +e.g. to change the range of allowed values or the default value. - + the id for the new property + + the #GParamSpec for the new property - - - - - - - - - - + Get an array of #GParamSpec* for all properties of a class. +#GParamSpec* which should be freed after use - + an array of + - + return location for the length of the returned array + + c:identifier="g_object_class_override_property" + version="2.4"> + Registers @property_id as referring to a property with the +name @name in a parent class or in an interface implemented +by @oclass. This allows this class to <firstterm>override</firstterm> +a property implementation in a parent class or to provide +the implementation of a property from an interface. +<note> +Internally, overriding is implemented by creating a property of type +#GParamSpecOverride; generally operations that query the properties of +the object class, such as g_object_class_find_property() or +g_object_class_list_properties() will return the overridden +property. However, in one case, the @construct_properties argument of +the @constructor virtual function, the #GParamSpecOverride is passed +instead, so that the @param_id field of the #GParamSpec will be +correct. For virtually all uses, this makes no difference. If you +need to get the overridden property, you can call +g_param_spec_get_redirect_target(). +</note> - + the new property ID + + the name of a property registered in a parent class or in an interface of this class. - + The <structname>GObjectConstructParam</structname> struct is an auxiliary structure used to hand #GParamSpec/#GValue pairs to the @constructor of -a #GObjectClass."> +a #GObjectClass. @@ -1459,88 +2733,81 @@ a #GObjectClass."> - + + The type of the @finalize function of #GObjectClass. + the #GObject being finalized - + + The type of the @get_property function of #GObjectClass. + a #GObject - + the numeric id under which the property was registered with g_object_class_install_property(). + + a #GValue to return the property value in + the #GParamSpec describing the property - + + The type of the @set_property function of #GObjectClass. + a #GObject - + the numeric id under which the property was registered with g_object_class_install_property(). + + the new value for the property + the #GParamSpec describing the property - + - + - + - + - + + Through the #GParamFlags flag values, certain aspects of parameters +can be configured. @@ -1560,11 +2827,13 @@ can be configured." + - + + All other fields of the <structname>GParamSpec</structname> struct are private and +should not be used directly. @@ -1590,171 +2859,197 @@ should not be used directly."> - + - + - - - - - - + + Get the short description of a #GParamSpec. - + the short description of @pspec. + - + + Get the name of a #GParamSpec. - + the name of @pspec. + - - - - - - + + Get the nickname of a #GParamSpec. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the nickname of @pspec. + + + + + Gets back user data pointers stored via g_param_spec_set_qdata(). + + the user data pointer set, or %NULL + + a #GQuark, naming the user data pointer - + c:identifier="g_param_spec_get_redirect_target" + version="2.4" + introspectable="0"> + If the paramspec redirects operations to another paramspec, +returns that paramspec. Redirect is used typically for +providing a new implementation of a property in a derived +type while preserving all the properties from the parent +type. Redirection is established by creating a property +of type #GParamSpecOverride. See g_object_class_override_property() +for an example of the use of this capability. +be redirected, or %NULL if none. + + paramspec to which requests on this paramspec should - - - + + Increments the reference count of @pspec. + + the #GParamSpec that was passed into this function + - - - + + Convenience function to ref and sink a #GParamSpec. + + the #GParamSpec that was passed into this function + - + + Sets an opaque, named pointer on a #GParamSpec. The name is +specified through a #GQuark (retrieved e.g. via +g_quark_from_static_string()), and the pointer can be gotten back +from the @pspec with g_param_spec_get_qdata(). Setting a +previously set user data pointer, overrides (frees) the old pointer +set, using %NULL as pointer essentially removes the data stored. - + + + + + a #GQuark, naming the user data pointer + + + + an opaque user data pointer + + + + + + This function works like g_param_spec_set_qdata(), but in addition, +a <literal>void (*destroy) (gpointer)</literal> function may be +specified which is called with @data as argument when the @pspec is +finalized, or the data is being overwritten by a call to +g_param_spec_set_qdata() with the same @quark. + + + + + + a #GQuark, naming the user data pointer + + + + an opaque user data pointer + + + + function to invoke with @data as argument, when @data needs to be freed + + + + + + The initial reference count of a newly created #GParamSpec is 1, +even though no one has explicitly called g_param_spec_ref() on it +yet. So the initial reference count is flagged as "floating", until +someone calls <literal>g_param_spec_ref (pspec); g_param_spec_sink +(pspec);</literal> in sequence on it, taking over the initial +reference count (thus ending up with a @pspec that has a reference +count of 1 still, but is not flagged "floating" anymore). + + + + + + Gets back user data pointers stored via g_param_spec_set_qdata() +and removes the @data from @pspec without invoking its destroy() +function (if any was set). Usually, calling this function is only +required to update user data pointers with a destroy notifier. + + the user data pointer set, or %NULL + + + + + a #GQuark, naming the user data pointer + + + + + + Decrements the reference count of a @pspec. + + - + + A #GParamSpec derived structure that contains the meta data for boolean properties. - + - + + A #GParamSpec derived structure that contains the meta data for boxed properties. - + + A #GParamSpec derived structure that contains the meta data for character properties. - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - + The class structure for the <structname>GParamSpec</structname> type. Normally, <structname>GParamSpec</structname> classes are filled by -g_param_type_register_static()."> +g_param_type_register_static(). @@ -1762,47 +3057,92 @@ g_param_type_register_static()."> - + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + - + + A #GParamSpec derived structure that contains the meta data for double properties. - + - + - + - + - + + A #GParamSpec derived structure that contains the meta data for enum +properties. @@ -1810,13 +3150,12 @@ properties."> - + - + + A #GParamSpec derived structure that contains the meta data for flags +properties. @@ -1824,33 +3163,29 @@ properties."> - + - + + A #GParamSpec derived structure that contains the meta data for float properties. - + - + - + - + - + + A #GParamSpec derived structure that contains the meta data for #GType properties. @@ -1858,72 +3193,66 @@ A #GParamSpec derived structure that contains the meta data for float properties - + + A #GParamSpec derived structure that contains the meta data for integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for 64bit integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for long integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for object properties. - + This is a type of #GParamSpec type that simply redirects operations to another paramspec. All operations other than getting or setting the value are redirected, including accessing the nick and blurb, validating a value, and so forth. See g_param_spec_get_redirect_target() for retrieving the overidden property. #GParamSpecOverride is used in implementing g_object_class_override_property(), and will not be directly useful -unless you are implementing a new base type similar to GObject." - version="2.4"> +unless you are implementing a new base type similar to GObject. @@ -1931,101 +3260,119 @@ unless you are implementing a new base type similar to GObject." - + + A #GParamSpec derived structure that contains the meta data for %G_TYPE_PARAM +properties. - + + A #GParamSpec derived structure that contains the meta data for pointer properties. - - - - - - - - - - - + + A #GParamSpecPool maintains a collection of #GParamSpec<!-- -->s which can be +quickly accessed by owner and name. The implementation of the #GObject property +system uses such a pool to store the #GParamSpecs of the properties all object +types. + Inserts a #GParamSpec in the pool. + the #GParamSpec to insert + a #GType identifying the owner of @pspec - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets an array of all #GParamSpec<!-- -->s owned by @owner_type in +the pool. +#GParamSpec<!-- -->s owned by @owner_type in the pool + + a newly allocated array containing pointers to all + the owner to look for - - + + return location for the length of the returned array + + + + + + Gets an #GList of all #GParamSpec<!-- -->s owned by @owner_type in +the pool. +in the pool#GParamSpec<!-- -->s. + + a #GList of all #GParamSpec<!-- -->s owned by @owner_type + + + + + + + the owner to look for + + + + + + Looks up a #GParamSpec in the pool. + + The found #GParamSpec, or %NULL if no matching #GParamSpec was found. + + + + + the name to look for + + + + the owner to look for + + + + If %TRUE, also try to find a #GParamSpec with @param_name owned by an ancestor of @owner_type. + + + + + + Removes a #GParamSpec from the pool. + + + + + + the #GParamSpec to remove + - + + A #GParamSpec derived structure that contains the meta data for string +properties. @@ -2039,175 +3386,176 @@ properties."> - + - + - + - + This structure is used to provide the type system with the information +required to initialize and destruct (finalize) a parameter's class and instances thereof. -The initialized structure is passed to the g_param_type_register_static() -The type system will perform a deep copy of this structure, so its memory -does not need to be persistent across invocation of -g_param_type_register_static()."> +The initialized structure is passed to the g_param_type_register_static() +The type system will perform a deep copy of this structure, so its memory +does not need to be persistent across invocation of +g_param_type_register_static(). - + - + - + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + A #GParamSpec derived structure that contains the meta data for unsigned character properties. - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - + + A #GParamSpec derived structure that contains the meta data for unsigned integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for unsigned 64bit integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for unsigned long integer properties. - + - + - + - + + A #GParamSpec derived structure that contains the meta data for unichar (unsigned integer) properties. - - + + - - - - - - - - - - - - - - - - - - - - + + A #GParamSpec derived structure that contains the meta data for #GValueArray properties. @@ -2215,13 +3563,29 @@ g_param_type_register_static()."> - + - + + A #GParamSpec derived structure that contains the meta data for #GVariant properties. + + + + + + + + + + + + + + + + + The <structname>GParameter</structname> struct is an auxiliary structure used +to hand parameter name/value pairs to g_object_newv(). @@ -2229,91 +3593,87 @@ to hand parameter name/value pairs to g_object_newv()."> - - - + - + - + The signal accumulator is a special callback function that can be used to collect return values of the various callbacks that are called during a signal emission. The signal accumulator is specified at signal creation time, if it is left %NULL, no accumulation of callback return values is performed. The return value of signal emissions is then the value returned by the last callback. should be aborted. Returning %FALSE means to abort the -current emission and %TRUE is returned for continuation."> +current emission and %TRUE is returned for continuation. - + The accumulator function returns whether the signal emission + + Signal invocation hint, see #GSignalInvocationHint. + Accumulator to collect callback return values in, this is the return value of the current signal emission. + A #GValue holding the return value of the signal handler. - + Callback data that was specified when creating the signal. + - + A simple function pointer to get invoked when the signal is emitted. This +allows you to tie a hook to the signal type, so that it will trap all emissions of that signal, from any object. You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. -hook is disconnected (and destroyed)."> +hook is disconnected (and destroyed). - + whether it wants to stay connected. If it returns %FALSE, the signal + + Signal invocation hint, see #GSignalInvocationHint. - + the number of parameters to the function, including the instance on which the signal was emitted. + + the instance on which the signal was emitted, followed by the parameters of the emission. - + user data associated with the hook. + - + The signal flags are used to specify a signal's behaviour, the overall signal description outlines how especially the RUN flags control the -stages of a signal emission." - c:type="GSignalFlags"> +stages of a signal emission. - + + The #GSignalInvocationHint structure is used to pass on additional information +to callbacks during a signal emission. - + @@ -2340,11 +3697,10 @@ to callbacks during a signal emission."> - + The match types specify what g_signal_handlers_block_matched(), g_signal_handlers_unblock_matched() and g_signal_handlers_disconnect_matched() -match signals by." - c:type="GSignalMatchType"> +match signals by. @@ -2354,18 +3710,11 @@ match signals by." value="32" c:identifier="G_SIGNAL_MATCH_UNBLOCKED"/> - + + A structure holding in-depth information for a specific signal. It is +filled in by the g_signal_query() function. - + @@ -2380,91 +3729,87 @@ filled in by the g_signal_query() function."> - + - + - - - - + - + - + - + - - + + - + - + - + + A callback function used for notification when the state +of a toggle reference changes. See g_object_add_toggle_ref(). - + Callback data passed to g_object_add_toggle_ref() + - + + The object on which g_object_add_toggle_ref() was called. - + %TRUE if the toggle reference is now the last reference to the object. %FALSE if the toggle reference was the last reference and there are now other references. + + A union holding one collected value. - + - + - + - + - + - + + An opaque structure used as the base of all classes. - - - + + + @@ -2473,56 +3818,52 @@ of a toggle reference changes. See g_object_add_toggle_ref()."> - + A callback function which is called when the reference count of a class drops to zero. It may use g_type_class_ref() to prevent the class from -being freed. You should not call g_type_class_unref() from a -#GTypeClassCacheFunc function to prevent infinite recursion, use +being freed. You should not call g_type_class_unref() from a +#GTypeClassCacheFunc function to prevent infinite recursion, use g_type_class_unref_uncached() instead. -The functions have to check the class id passed in to figure +The functions have to check the class id passed in to figure whether they actually want to cache the class of this type, since all classes are routed through the same #GTypeClassCacheFunc chain. -called, %FALSE to continue."> +called, %FALSE to continue. - + %TRUE to stop further #GTypeClassCacheFunc<!-- -->s from being + - - + + data that was given to the g_type_add_class_cache_func() call + + The #GTypeClass structure which is unreferenced - + The <type>GTypeDebugFlags</type> enumeration values can be passed to g_type_init_with_debug_flags() to trigger debugging messages during runtime. Note that the messages can also be triggered by setting the -<envar>GOBJECT_DEBUG</envar> environment variable to a ':'-separated list of -"objects" and "signals"." - c:type="GTypeDebugFlags"> +<envar>GOBJECT_DEBUG</envar> environment variable to a ':'-separated list of +"objects" and "signals". - + + Bit masks used to check or determine characteristics of a type. - + + Bit masks used to check or determine specific characteristics of a +fundamental type. - + + A structure that provides information to the type system which is +used specifically for managing fundamental types. - + This structure is used to provide the type system with the information +required to initialize and destruct (finalize) a type's class and its instances. The initialized structure is passed to the g_type_register_static() function (or is copied into the provided #GTypeInfo structure in the g_type_plugin_complete_type_info()). The type system will perform a deep copy of this structure, so its memory does not need to be persistent -across invocation of g_type_register_static()."> +across invocation of g_type_register_static(). - + @@ -2574,13 +3905,13 @@ across invocation of g_type_register_static()."> - + - + - + @@ -2589,15 +3920,16 @@ across invocation of g_type_register_static()."> - + + An opaque structure used as the base of all type instances. - - - + + + @@ -2606,9 +3938,8 @@ across invocation of g_type_register_static()."> - + + An opaque structure used as the base of all interface types. @@ -2618,34 +3949,37 @@ across invocation of g_type_register_static()."> + A callback called after an interface vtable is initialized. +See g_type_add_interface_check(). - + data passed to g_type_add_interface_check(). + - + the interface that has been initialized + + The members of the <structname>GTypeModule</structname> structure should not +be accessed directly, except for the @name field. - + @@ -2653,99 +3987,159 @@ be accessed directly, except for the @name field." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Registers an additional interface for a type, whose interface lives +in the given type plugin. If the interface was already registered +for the type in this plugin, nothing will be done. +As long as any instances of the type exist, the type plugin will +not be unloaded. + type to which to add the interface. + interface type to add + type information structure - + + Looks up or registers an enumeration that is implemented with a particular +type plugin. If a type with name @type_name was previously registered, +the #GType identifier for the type is returned, otherwise the type +is newly registered, and the resulting #GType identifier returned. +As long as any instances of the type exist, the type plugin will +not be unloaded. + the new or existing type ID + name for the type + an array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. + c:identifier="g_type_module_register_flags" + version="2.6"> + Looks up or registers a flags type that is implemented with a particular +type plugin. If a type with name @type_name was previously registered, +the #GType identifier for the type is returned, otherwise the type +is newly registered, and the resulting #GType identifier returned. +As long as any instances of the type exist, the type plugin will +not be unloaded. + the new or existing type ID + name for the type + an array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. + + Looks up or registers a type that is implemented with a particular +type plugin. If a type with name @type_name was previously registered, +the #GType identifier for the type is returned, otherwise the type +is newly registered, and the resulting #GType identifier returned. +When reregistering a type (typically because a module is unloaded +then reloaded, and reinitialized), @module and @parent_type must +be the same as they were previously. +As long as any instances of the type exist, the type plugin will +not be unloaded. + + the new or existing type ID + + + + + the type for the parent class + + + + name for the type + + + + type information structure + + + + flags field providing details about the type + + + + + + Sets the name for a #GTypeModule + + + + + + a human-readable name to use in error messages. + + + + + + Decreases the use count of a #GTypeModule by one. If the +result is zero, the module will be unloaded. (However, the +#GTypeModule will not be freed, and types associated with the +#GTypeModule are not unregistered. Once a #GTypeModule is +initialized, it must exist forever.) + + + + + + Increases the use count of a #GTypeModule by one. If the +use count was zero before, the plugin will be loaded. +If loading the plugin fails, the use count is reset to +its prior value. +loading the plugin failed. + + %FALSE if the plugin needed to be loaded and + + + - + - + + + - + + + @@ -2753,17 +4147,16 @@ be accessed directly, except for the @name field." + glib:is-gtype-struct-for="TypeModule"> + In order to implement dynamic loading of types based on #GTypeModule, +the @load and @unload functions in #GTypeModuleClass must be implemented. - + - + @@ -2773,7 +4166,7 @@ the @load and @unload functions in #GTypeModuleClass must be implemented."> - + @@ -2785,28 +4178,28 @@ the @load and @unload functions in #GTypeModuleClass must be implemented."> - + - + - + - + @@ -2814,159 +4207,173 @@ the @load and @unload functions in #GTypeModuleClass must be implemented."> - - - - - - - - - - - - - - - - - - - - - - - - - - + glib:get-type="g_type_plugin_get_type"> + The <structname>GTypePlugin</structname> typedef is used as a placeholder +for objects that implement the <structname>GTypePlugin</structname> +interface. + Calls the @complete_interface_info function from the +#GTypePluginClass of @plugin. There should be no need to use this +function outside of the GObject type system itself. + the #GType of an instantiable type to which the interface is added + the #GType of the interface whose info is completed + the #GInterfaceInfo to fill in + + Calls the @complete_type_info function from the #GTypePluginClass of @plugin. +There should be no need to use this function outside of the GObject +type system itself. + + + + + + the #GType whose info is completed + + + + the #GTypeInfo struct to fill in + + + + the #GTypeValueTable to fill in + + + + + + Calls the @unuse_plugin function from the #GTypePluginClass of +the GObject type system itself. + + + + + + Calls the @use_plugin function from the #GTypePluginClass of +the GObject type system itself. + + + + - - + + The #GTypePlugin interface is used by the type system in order to handle +the lifecycle of dynamically loaded types. + - + - + - + - + + c:type="GTypePluginCompleteInterfaceInfo"> + The type of the @complete_interface_info function of #GTypePluginClass. + the #GTypePlugin + the #GType of an instantiable type to which the interface is added + the #GType of the interface whose info is completed + the #GInterfaceInfo to fill in + c:type="GTypePluginCompleteTypeInfo"> + The type of the @complete_type_info function of #GTypePluginClass. + the #GTypePlugin + the #GType whose info is completed + the #GTypeInfo struct to fill in + the #GTypeValueTable to fill in - + + The type of the @unuse_plugin function of #GTypePluginClass. + the #GTypePlugin whose use count should be decreased - + + The type of the @use_plugin function of #GTypePluginClass, which gets called +to increase the use count of @plugin. + the #GTypePlugin whose use count should be increased - + + A structure holding information for a specific type. It is +filled in by the g_type_query() function. @@ -2974,858 +4381,1084 @@ filled in by the g_type_query() function."> - + - + - + + The #GTypeValueTable provides the functions required by the #GValue implementation, +to serve as a container for values of a type. - + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + - - + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + - + - + + An opaque structure used to hold different types of values. to functions within a #GTypeValueTable structure, or implementations of the g_value_*() API. That is, code portions which implement new fundamental types. #GValue users can not make any assumptions about how data is stored within the 2 element @data union, and the @g_type member should -only be accessed through the G_VALUE_TYPE() macro." - glib:type-name="GValue" - glib:get-type="g_value_get_type"> +only be accessed through the G_VALUE_TYPE() macro. - - + + - + + Copies the value of @src_value into @dest_value. - - + + An initialized #GValue structure of the same type as @src_value. + - - - - - - - - - - - - - + + Get the contents of a %G_TYPE_BOXED derived #GValue. Upon getting, +the boxed value is duplicated and needs to be later freed with +return_value); + + boxed contents of @value + - - - + + Get the contents of a %G_TYPE_OBJECT derived #GValue, increasing +its reference count. +longer needed. + + object content of @value, should be unreferenced when no + - - - + + Get the contents of a %G_TYPE_PARAM #GValue, increasing its +reference count. +no longer needed. + + #GParamSpec content of @value, should be unreferenced when + - - - - - - - - + + Get a copy the contents of a %G_TYPE_STRING #GValue. + + a newly allocated copy of the string content of @value + - - - - - - - - + + Get the contents of a variant #GValue, increasing its refcount. +g_variant_unref() when no longer needed + + variant contents of @value, should be unrefed using + + + + + Determines if @value will fit inside the size of a pointer value. +This is an internal function introduced mainly for C marshallers. + + %TRUE if @value will fit inside a pointer value. + + + + + Get the contents of a %G_TYPE_BOOLEAN #GValue. + + boolean contents of @value + + + + + Get the contents of a %G_TYPE_BOXED derived #GValue. + + boxed contents of @value + + + + + Get the contents of a %G_TYPE_CHAR #GValue. + + character contents of @value + + + + + Get the contents of a %G_TYPE_DOUBLE #GValue. + + double contents of @value + - - - - - + Get the contents of a %G_TYPE_ENUM #GValue. - + enum contents of @value + - - - - - - - - - - + Get the contents of a %G_TYPE_FLAGS #GValue. - + flags contents of @value + + + + + Get the contents of a %G_TYPE_FLOAT #GValue. + + float contents of @value + + + + + Get the contents of a %G_TYPE_GTYPE #GValue. + + the #GType stored in @value + + + + + Get the contents of a %G_TYPE_INT #GValue. + + integer contents of @value + + + + + Get the contents of a %G_TYPE_INT64 #GValue. + + 64bit integer contents of @value + + + + + Get the contents of a %G_TYPE_LONG #GValue. + + long integer contents of @value + + + + + Get the contents of a %G_TYPE_OBJECT derived #GValue. + + object contents of @value + + + + + Get the contents of a %G_TYPE_PARAM #GValue. + + #GParamSpec content of @value + + + + + Get the contents of a pointer #GValue. + + pointer contents of @value + + + + + Get the contents of a %G_TYPE_STRING #GValue. + + string content of @value + + + + + Get the contents of a %G_TYPE_UCHAR #GValue. + + unsigned character contents of @value + + + + + Get the contents of a %G_TYPE_UINT #GValue. + + unsigned integer contents of @value + + + + + Get the contents of a %G_TYPE_UINT64 #GValue. + + unsigned 64bit integer contents of @value + + + + + Get the contents of a %G_TYPE_ULONG #GValue. + + unsigned long integer contents of @value + + + + + Get the contents of a variant #GValue. + + variant contents of @value + + Initializes @value with the default value of @type. + the #GValue structure that has been passed in + Type the #GValue should hold values of. - - - + + Return the value contents as pointer. This function asserts that +g_value_fits_pointer() returned %TRUE for the passed in value. +This is an internal function introduced mainly for C marshallers. + + %TRUE if @value will fit inside a pointer value. + - - - - - + Clears the current value in @value and resets it to the default value +(as if the value had just been initialized). + the #GValue structure that has been passed in - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Set the contents of a %G_TYPE_BOOLEAN #GValue to @v_boolean. - + boolean value to be set + - - - - - - + + Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. - - + + boxed value to be set + - - - - - - + + This is an internal function introduced mainly for C marshallers. - - + + duplicated unowned boxed value to be set + - - - - - - + + Set the contents of a %G_TYPE_CHAR #GValue to @v_char. - - + + character value to be set + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Set the contents of a %G_TYPE_DOUBLE #GValue to @v_double. - + double value to be set + - - - - - - + + Set the contents of a %G_TYPE_ENUM #GValue to @v_enum. - - + + enum value to be set + - + + Set the contents of a %G_TYPE_FLAGS #GValue to @v_flags. - - + + flags value to be set + - - - - - - - - - - - + + Set the contents of a %G_TYPE_FLOAT #GValue to @v_float. - - + + float value to be set + - - - - - - + + Set the contents of a %G_TYPE_GTYPE #GValue to @v_gtype. + #GType to be set - - - - - - + + Sets @value from an instantiatable type via the +value_table's collect_value() function. - + + the instance + + + + + + Set the contents of a %G_TYPE_INT #GValue to @v_int. + + + + + + integer value to be set + + + + + + Set the contents of a %G_TYPE_INT64 #GValue to @v_int64. + + + + + + 64bit integer value to be set + + + + + + Set the contents of a %G_TYPE_LONG #GValue to @v_long. + + + + + + long integer value to be set + + + + + + Set the contents of a %G_TYPE_OBJECT derived #GValue to @v_object. +g_value_set_object() increases the reference count of @v_object +(the #GValue holds a reference to @v_object). If you do not wish +to increase the reference count of the object (i.e. you wish to +pass your current reference to the #GValue because you no longer +need it), use g_value_take_object() instead. +It is important that your #GValue holds a reference to @v_object (either its +own, or one it has taken) to ensure that the object won't be destroyed while +the #GValue still exists). + + + + + + object value to be set + + + + + + This is an internal function introduced mainly for C marshallers. + + + + + + object value to be set + + + + + + Set the contents of a %G_TYPE_PARAM #GValue to @param. + + + + + + the #GParamSpec to be set + + + + + + This is an internal function introduced mainly for C marshallers. + + + + + + the #GParamSpec to be set + + + + + + Set the contents of a pointer #GValue to @v_pointer. + + + + + + pointer value to be set + + + + + + Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed. +The boxed value is assumed to be static, and is thus not duplicated +when setting the #GValue. + + + + + + static boxed value to be set + + + + + + Set the contents of a %G_TYPE_STRING #GValue to @v_string. +The string is assumed to be static, and is thus not duplicated +when setting the #GValue. + + + + + + static string to be set + + + + + + Set the contents of a %G_TYPE_STRING #GValue to @v_string. + + + + + + caller-owned string to be duplicated for the #GValue + c:identifier="g_value_set_string_take_ownership" + deprecated="Use g_value_take_string() instead." + deprecated-version="2.4"> + This is an internal function introduced mainly for C marshallers. - + + duplicated unowned string to be set + + Set the contents of a %G_TYPE_UCHAR #GValue to @v_uchar. + + + + + + unsigned character value to be set + + + + + + Set the contents of a %G_TYPE_UINT #GValue to @v_uint. + + + + + + unsigned integer value to be set + + + + + + Set the contents of a %G_TYPE_UINT64 #GValue to @v_uint64. + + + + + + unsigned 64bit integer value to be set + + + + + + Set the contents of a %G_TYPE_ULONG #GValue to @v_ulong. + + + + + + unsigned long integer value to be set + + + + + + Set the contents of a variant #GValue to @variant. +If the variant is floating, it is consumed. + + + + + + a #GVariant, or %NULL + + + + + + Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed +and takes over the ownership of the callers reference to @v_boxed; +the caller doesn't have to unref it any more. + + + + + + duplicated unowned boxed value to be set + + + + + + Sets the contents of a %G_TYPE_OBJECT derived #GValue to @v_object +and takes over the ownership of the callers reference to @v_object; +the caller doesn't have to unref it any more (i.e. the reference +count of the object is not increased). +If you want the #GValue to hold its own reference to @v_object, use +g_value_set_object() instead. + + + + + + object value to be set + + + + + + Sets the contents of a %G_TYPE_PARAM #GValue to @param and takes +over the ownership of the callers reference to @param; the caller +doesn't have to unref it any more. + + + + + + the #GParamSpec to be set + + + + + + Sets the contents of a %G_TYPE_STRING #GValue to @v_string. + + + + + + string to take ownership of + + + + + + Set the contents of a variant #GValue to @variant, and takes over +the ownership of the caller's reference to @variant; +the caller doesn't have to unref it any more (i.e. the reference +count of the variant is not increased). +It is a programmer error to pass a floating variant to this function. +In particular this means that callbacks in closures, and signal handlers +for signals of return type %G_TYPE_VARIANT, must never return floating +variants. +If you want the #GValue to hold its own reference to @variant, use +g_value_set_variant() instead. +This is an internal function introduced mainly for C marshallers. + + + + + + a #GVariant, or %NULL + + + + + + Tries to cast the contents of @src_value into a type appropriate +to store in @dest_value, e.g. to transform a %G_TYPE_INT value +into a %G_TYPE_FLOAT value. Performing transformations between +value types might incur precision lossage. Especially +transformations into strings might reveal seemingly arbitrary +results and shouldn't be relied upon for production code (such +as rcfile value or object property serialization). +Upon failing transformations, @dest_value is left untouched. + + Whether a transformation rule was found and could be applied. + + + + + Target value. + + + + + + Clears the current value in @value and "unsets" the type, +this releases all resources associated with this GValue. +An unset value is the same as an uninitialized (zero-filled) +#GValue structure. + + + + + glib:get-type="g_value_array_get_type" + c:symbol-prefix="value_array"> + A #GValueArray contains an array of #GValue elements. - + - + + Allocate and initialize a new #GValueArray, optionally preserve space +for @n_prealloced elements. New arrays always contain 0 elements, +regardless of the value of @n_prealloced. + a newly allocated #GValueArray with 0 values - + number of values to preallocate space for + - + + Insert a copy of @value as last element of @value_array. If @value is +%NULL, an uninitialized value is appended. - + the #GValueArray passed in as @value_array + - - + + #GValue to copy into #GValueArray, or %NULL + + + Construct an exact copy of a #GValueArray by duplicating all its +contents. + + Newly allocated copy of #GValueArray + + + + Free a #GValueArray including its contents. - + + Return a pointer to the value at @index_ containd in @value_array. - - - - - - + pointer to a value at @index_ in @value_array + - - - - - - - - - - - - + + index of the value of interest + + Insert a copy of @value at specified position into @value_array. If @value +is %NULL, an uninitialized value is inserted. + the #GValueArray passed in as @value_array - + insertion position, must be &lt;= value_array-&gt;n_values + + #GValue to copy into #GValueArray, or %NULL + + + + + + Insert a copy of @value as first element of @value_array. If @value is +%NULL, an uninitialized value is prepended. + + the #GValueArray passed in as @value_array + + + + + #GValue to copy into #GValueArray, or %NULL + Remove the value at position @index_ from @value_array. + the #GValueArray passed in as @value_array - + position of value to remove, must be &lt; value_array->n_values + - + + Sort @value_array using @compare_func to compare the elements accoring to +the semantics of #GCompareFunc. +The current implementation uses Quick-Sort as sorting algorithm. + the #GValueArray passed in as @value_array - + + function to compare elements + c:identifier="g_value_array_sort_with_data" + introspectable="0"> + Sort @value_array using @compare_func to compare the elements accoring +to the semantics of #GCompareDataFunc. +The current implementation uses Quick-Sort as sorting algorithm. + the #GValueArray passed in as @value_array - + + function to compare elements - + extra data argument provided for @compare_func + - + + The type of value transformation functions which can be registered with +g_value_register_transform_func(). + Source value. + Target value. - + A #GWeakNotify function can be added to an object as a callback that gets triggered when the object is finalized. Since the object is already being -finalized when the #GWeakNotify is called, there's not much you could do -with the object, apart from e.g. using its adress as hash-index or the like."> +finalized when the #GWeakNotify is called, there's not much you could do +with the object, apart from e.g. using its adress as hash-index or the like. - + data that was provided when the weak reference was established + + the object being finalized - - - + + Provide a copy of a boxed structure @src_boxed which is of type @boxed_type. + + The newly created copy of the boxed structure. + + The type of @src_boxed. - + The boxed structure to be copied. + + Free the boxed structure @boxed which is of type @boxed_type. + The type of @boxed. - + The boxed structure to be freed. + @@ -3835,155 +5468,982 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + c:identifier="g_boxed_type_register_static" + introspectable="0"> + This function creates a new %G_TYPE_BOXED derived type id for a new +boxed type with name @name. Boxed type handling functions have to be +provided to copy and free opaque boxed structures of this type. + New %G_TYPE_BOXED derived type id for @name. + Name of the new boxed type. - + + Boxed structure copy function. - + + Boxed structure free function. - + + + + + + + + + + + + + + + + + + + + + + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>gboolean (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter +denotes a flags type. + + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue which can store the returned #gboolean + + + + 2 + + + + a #GValue array holding instance and arg1 + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>gchar* (*callback) (gpointer instance, GObject *arg1, gpointer arg2, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + a #GValue, which can store the returned string + + + + 3 + + + + a #GValue array holding instance, arg1 and arg2 + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gboolean arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gboolean parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, GBoxed *arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #GBoxed* parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gchar arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gchar parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gdouble arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gdouble parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter denotes an enumeration type.. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the enumeration parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal> where the #gint parameter denotes a flags type. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the flags parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gfloat arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gfloat parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gint arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gint parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, glong arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #glong parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, GObject *arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #GObject* parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, GParamSpec *arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #GParamSpec* parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gpointer arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gpointer parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, const gchar *arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gchar* parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, guchar arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #guchar parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, guint arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #guint parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, guint arg1, gpointer arg2, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 3 + + + + a #GValue array holding instance, arg1 and arg2 + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gulong arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #gulong parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, GVariant *arg1, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 2 + + + + a #GValue array holding the instance and the #GVariant* parameter + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + A marshaller for a #GCClosure with a callback of type +<literal>void (*callback) (gpointer instance, gpointer user_data)</literal>. + + + + + + the #GClosure to which the marshaller belongs + + + + ignored + + + + 1 + + + + a #GValue array holding only the instance + + + + the invocation hint given as the last argument to g_closure_invoke() + + + + additional data specified when registering the marshaller + + + + + + Creates a new closure which invokes @callback_func with @user_data as +the last parameter. + a new #GCClosure - + + the function to invoke - + user data to pass to @callback_func + - + + destroy notify to be called when @user_data is no longer used - + + A variant of g_cclosure_new() which uses @object as @user_data and +calls g_object_watch_closure() on @object and the created +closure. This function is useful when you have a callback closely +associated with a #GObject, and want the callback to no longer run +after the object is is freed. + a new #GCClosure - + + the function to invoke + a #GObject pointer to pass to @callback_func + c:identifier="g_cclosure_new_object_swap" + introspectable="0"> + A variant of g_cclosure_new_swap() which uses @object as @user_data +and calls g_object_watch_closure() on @object and the created +closure. This function is useful when you have a callback closely +associated with a #GObject, and want the callback to no longer run +after the object is is freed. + a new #GCClosure - + + the function to invoke + a #GObject pointer to pass to @callback_func - + + Creates a new closure which invokes @callback_func with @user_data as +the first parameter. + a new #GCClosure - + + the function to invoke - + user data to pass to @callback_func + - + + destroy notify to be called when @user_data is no longer used + This function is meant to be called from the complete_type_info() +function of a #GTypePlugin implementation, as in the following +example: +|[ +static void +my_enum_complete_type_info (GTypePlugin *plugin, +GType g_type, +GTypeInfo *info, +GTypeValueTable *value_table) +{ +static const GEnumValue values[] = { +{ MY_ENUM_FOO, "MY_ENUM_FOO", "foo" }, +{ MY_ENUM_BAR, "MY_ENUM_BAR", "bar" }, +{ 0, NULL, NULL } +}; +g_enum_complete_type_info (type, info, values); +} +]| + the type identifier of the type being completed + the #GTypeInfo struct to be filled in + An array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. - - + + Returns the #GEnumValue for a value. +member of the enumeration + + the #GEnumValue for @value, or %NULL if @value is not a + a #GEnumClass - + the value to look up + - + c:identifier="g_enum_get_value_by_name" + introspectable="0"> + Looks up a #GEnumValue by name. +enumeration doesn't have a member with that name + + the #GEnumValue with name @name, or %NULL if the + a #GEnumClass + the name to look up - + c:identifier="g_enum_get_value_by_nick" + introspectable="0"> + Looks up a #GEnumValue by nickname. +enumeration doesn't have a member with that nickname + + the #GEnumValue with nickname @nick, or %NULL if the + a #GEnumClass + the nickname to look up + Registers a new static enumeration type with the name @name. +It is normally more convenient to let <link +linkend="glib-mkenums">glib-mkenums</link> generate a +my_enum_get_type() function from a usual C enumeration definition +than to write one yourself using g_enum_register_static(). + The new type identifier. + A nul-terminated string used as the name of the new type. + An array of #GEnumValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated. @@ -3995,449 +6455,739 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + This function is meant to be called from the complete_type_info() +function of a #GTypePlugin implementation, see the example for +g_enum_complete_type_info() above. + the type identifier of the type being completed + the #GTypeInfo struct to be filled in + An array of #GFlagsValue structs for the possible enumeration values. The array is terminated by a struct with all members being 0. - + c:identifier="g_flags_get_first_value" + introspectable="0"> + Returns the first #GFlagsValue which is set in @value. +none is set + + the first #GFlagsValue which is set in @value, or %NULL if + a #GFlagsClass - + the value + - + c:identifier="g_flags_get_value_by_name" + introspectable="0"> + Looks up a #GFlagsValue by name. +flag with that name + + the #GFlagsValue with name @name, or %NULL if there is no + a #GFlagsClass + the name to look up - + c:identifier="g_flags_get_value_by_nick" + introspectable="0"> + Looks up a #GFlagsValue by nickname. +no flag with that nickname + + the #GFlagsValue with nickname @nick, or %NULL if there is + a #GFlagsClass + the nickname to look up + Registers a new static flags type with the name @name. +It is normally more convenient to let <link +linkend="glib-mkenums">glib-mkenums</link> generate a +my_flags_get_type() function from a usual C enumeration definition +than to write one yourself using g_flags_register_static(). + The new type identifier. + A nul-terminated string used as the name of the new type. + An array of #GFlagsValue structs for the possible flags values. The array is terminated by a struct with all members being 0. GObject keeps a reference to the data, so it cannot be stack-allocated. - - + + + + + + + + + + + + Creates a new #GParamSpecBoolean instance specifying a %G_TYPE_BOOLEAN +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_BOXED +derived property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + %G_TYPE_BOXED derived type of this property + flags for the property specified - - + + Creates a new #GParamSpecChar instance specifying a %G_TYPE_CHAR property. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecDouble instance specifying a %G_TYPE_DOUBLE +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + + + + minimum value for the property specified + + + + maximum value for the property specified + + + + default value for the property specified + + + + flags for the property specified + + + + + + Creates a new #GParamSpecEnum instance specifying a %G_TYPE_ENUM +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + + + + + canonical name of the property specified + + + + nick name for the property specified + + + + description of the property specified + a #GType derived from %G_TYPE_ENUM - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecFlags instance specifying a %G_TYPE_FLAGS +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + a #GType derived from %G_TYPE_FLAGS - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecFloat instance specifying a %G_TYPE_FLOAT property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecGType instance specifying a +%G_TYPE_GTYPE property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + a #GType whose subtypes are allowed as values of the property (use %G_TYPE_NONE for any type) + flags for the property specified - - + + Creates a new #GParamSpecInt instance specifying a %G_TYPE_INT property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecInt64 instance specifying a %G_TYPE_INT64 property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - - + + Creates a new #GParamSpec instance. +A property name consists of segments consisting of ASCII letters and +digits, separated by either the '-' or '_' character. The first +character of a property name must be a letter. Names which violate these +rules lead to undefined behaviour. +When creating and looking up a #GParamSpec, either separator can be +used, but they cannot be mixed. Using '-' is considerably more +efficient and in fact required when using property names as detail +strings for signals. +Beyond the name, #GParamSpec<!-- -->s have two more descriptive +strings associated with them, the @nick, which should be suitable +for use as a label for the property in a property editor, and the +e.g. a tooltip. The @nick and @blurb should ideally be localized. + + a newly allocated #GParamSpec instance + + the #GType for the property; must be derived from #G_TYPE_PARAM + the canonical name of the property + the nickname of the property + a short description of the property + a combination of #GParamFlags - - + + Creates a new #GParamSpecLong instance specifying a %G_TYPE_LONG property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecBoxed instance specifying a %G_TYPE_OBJECT +derived property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + %G_TYPE_OBJECT derived type of this property + flags for the property specified - - + + Creates a new property of type #GParamSpecOverride. This is used +to direct operations to another paramspec, and will not be directly +useful unless you are implementing a new base type similar to GObject. + + the newly created #GParamSpec + the name of the property. + The property that is being overridden - - + + Creates a new #GParamSpecParam instance specifying a %G_TYPE_PARAM +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + a #GType derived from %G_TYPE_PARAM + flags for the property specified - - + + Creates a new #GParamSpecPoiner instance specifying a pointer property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + flags for the property specified - - + + Creates a new #GParamSpecPool. +If @type_prefixing is %TRUE, lookups in the newly created pool will +allow to specify the owner as a colon-separated prefix of the +property name, like "GtkContainer:border-width". This feature is +deprecated, so you should always set @type_prefixing to %FALSE. + + a newly allocated #GParamSpecPool. + + + + + Whether the pool will support type-prefixed property names. + + + + + + Creates a new #GParamSpecString instance. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + default value for the property specified + flags for the property specified @@ -4448,109 +7198,273 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - - + + Creates a new #GParamSpecUChar instance specifying a %G_TYPE_UCHAR property. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecUInt instance specifying a %G_TYPE_UINT property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified - - + + Creates a new #GParamSpecUInt64 instance specifying a %G_TYPE_UINT64 +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified - + minimum value for the property specified + - + maximum value for the property specified + - + default value for the property specified + + flags for the property specified + + + + + + Creates a new #GParamSpecULong instance specifying a %G_TYPE_ULONG +property. +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + + + + + canonical name of the property specified + + + + nick name for the property specified + + + + description of the property specified + + + + minimum value for the property specified + + + + maximum value for the property specified + + + + default value for the property specified + + + + flags for the property specified + + + + + + Creates a new #GParamSpecUnichar instance specifying a %G_TYPE_UINT +property. #GValue structures for this property can be accessed with +g_value_set_uint() and g_value_get_uint(). +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + + + + + canonical name of the property specified + + + + nick name for the property specified + + + + description of the property specified + + + + default value for the property specified + + + + flags for the property specified - + c:identifier="g_param_spec_value_array" + introspectable="0"> + Creates a new #GParamSpecValueArray instance specifying a +%G_TYPE_VALUE_ARRAY property. %G_TYPE_VALUE_ARRAY is a +%G_TYPE_BOXED type, as such, #GValue structures for this property +can be accessed with g_value_set_boxed() and g_value_get_boxed(). +See g_param_spec_internal() for details on property names. + + a newly created parameter specification + canonical name of the property specified + nick name for the property specified + description of the property specified + a #GParamSpec describing the elements contained in arrays of this property, may be %NULL + flags for the property specified + + + + + + Creates a new #GParamSpecVariant instance specifying a #GVariant +property. +If @default_value is floating, it is consumed. +See g_param_spec_internal() for details on property names. + + the newly created #GParamSpec + + + + + canonical name of the property specified + + + + nick name for the property specified + + + + description of the property specified + + + + a #GVariantType + + + + a #GVariant of type @type to use as the default value, or %NULL + + + + flags for the property specified @@ -4562,136 +7476,199 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Registers @name as the name of a new static type derived from +#G_TYPE_PARAM. The type system uses the information contained in +the #GParamSpecTypeInfo structure pointed to by @info to manage the +#GParamSpec type and its instances. + The new type identifier. + 0-terminated string used as the name of the new #GParamSpec type. + The #GParamSpecTypeInfo for this #GParamSpec type. + Transforms @src_value into @dest_value if possible, and then +validates @dest_value, in order for it to conform to @pspec. If +transformed @dest_value complied to @pspec without modifications. +See also g_value_type_transformable(), g_value_transform() and +g_param_value_validate(). +%FALSE otherwise and @dest_value is left untouched. - + %TRUE if transformation and validation were successful, + + a valid #GParamSpec + souce #GValue + destination #GValue of correct type for @pspec - + %TRUE requires @dest_value to conform to @pspec without modifications + + Checks whether @value contains the default value as specified in @pspec. - + whether @value contains the canonical default for this @pspec + + a valid #GParamSpec + a #GValue of correct type for @pspec + Sets @value to its default value as specified in @pspec. + a valid #GParamSpec + a #GValue of correct type for @pspec + Ensures that the contents of @value comply with the specifications +set out by @pspec. For example, a #GParamSpecInt might require +that integers stored in @value may not be smaller than -42 and not be +greater than +42. If @value contains an integer outside of this range, +it is modified accordingly, so the resulting value will fit into the +range -42 .. +42. - + whether modifying @value was necessary to ensure validity + + a valid #GParamSpec + a #GValue of correct type for @pspec + Compares @value1 with @value2 according to @pspec, and return -1, 0 or +1, +if @value1 is found to be less than, equal to or greater than @value2, +respectively. - + -1, 0 or +1, for a less than, equal to or greater than result + + a valid #GParamSpec + a #GValue of correct type for @pspec + a #GValue of correct type for @pspec + Creates a new %G_TYPE_POINTER derived type id for a new +pointer type with name @name. + a new %G_TYPE_POINTER derived type id for @name. + the name of the new pointer type. + c:identifier="g_signal_accumulator_true_handled" + version="2.4"> + A predefined #GSignalAccumulator for signals that return a +boolean values. The behavior that this accumulator gives is +callbacks will be invoked, while a return of %FALSE allows +the emission to coninue. The idea here is that a %TRUE return +indicates that the callback <emphasis>handled</emphasis> the signal, +and no further handling is needed. - + standard #GSignalAccumulator result + + standard #GSignalAccumulator parameter + standard #GSignalAccumulator parameter + standard #GSignalAccumulator parameter - + standard #GSignalAccumulator parameter + + Adds an emission hook for a signal, which will get called for any emission +of that signal, independent of the instance. This is possible only +for signals which don't have #G_SIGNAL_NO_HOOKS flag set. - + the hook id, for later use with g_signal_remove_emission_hook(). + - + the signal identifier, as returned by g_signal_lookup(). + + the detail on which to call the hook. scope="notified" closure="3" destroy="4"> + a #GSignalEmissionHook function. - + user data for @hook_func. + - + + a #GDestroyNotify for @hook_data. + Calls the original class closure of a signal. This function should only +be called from an overridden class closure; see +g_signal_override_class_closure() and +g_signal_override_class_handler(). + the argument list of the signal emission. The first element in the array is a #GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal. + Location for the return value. + c:identifier="g_signal_chain_from_overridden_handler" + version="2.18" + introspectable="0"> + Calls the original class closure of a signal. This function should +only be called from an overridden class closure; see +g_signal_override_class_closure() and +g_signal_override_class_handler(). - + the instance the signal is being emitted on. + @@ -4740,110 +7733,168 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Connects a closure to a signal for a particular object. - + the handler id + - + the instance to connect to. + + a string of the form "signal-name::detail". + the closure to connect. - + whether the handler should be called before or after the default handler of the signal. + + Connects a closure to a signal for a particular object. - + the handler id + - + the instance to connect to. + - + the id of the signal. + + the detail. + the closure to connect. - + whether the handler should be called before or after the default handler of the signal. + - + + Connects a #GCallback function to a signal for a particular object. Similar +to g_signal_connect(), but allows to provide a #GClosureNotify for the data +which will be called when the signal handler is disconnected and no longer +used. Specify @connect_flags if you need <literal>..._after()</literal> or +<literal>..._swapped()</literal> variants of this function. - + the handler id + - + the instance to connect to. + + a string of the form "signal-name::detail". - + + the #GCallback to connect. - + data to pass to @c_handler calls. + - + + a #GClosureNotify for @data. + a combination of #GConnectFlags. + c:identifier="g_signal_connect_object" + introspectable="0"> + This is similar to g_signal_connect_data(), but uses a closure which +ensures that the @gobject stays alive during the call to @c_handler +by temporarily adding a reference count to @gobject. +Note that there is a bug in GObject that makes this function +much less useful than it might seem otherwise. Once @gobject is +disposed, the callback will no longer be called, but, the signal +handler is <emphasis>not</emphasis> currently disconnected. If the +matter, since the signal will automatically be removed, but +if @instance persists, then the signal handler will leak. You +should not remove the signal yourself because in a future versions of +GObject, the handler <emphasis>will</emphasis> automatically +be disconnected. +It's possible to work around this problem in a way that will +continue to work with future versions of GObject by checking +that the signal handler is still connected before disconnected it: +<informalexample><programlisting> +if (g_signal_handler_is_connected (instance, id)) +g_signal_handler_disconnect (instance, id); +</programlisting></informalexample> - + the handler id. + - + the instance to connect to. + + a string of the form "signal-name::detail". - + + the #GCallback to connect. - + the object to pass as data to @c_handler. + + a combination of #GConnnectFlags. - + + Emits a signal. +Note that g_signal_emit() resets the return value to the default +if no handlers are connected, in contrast to g_signal_emitv(). - + the instance the signal is being emitted on. + - + the signal id + + the detail @@ -4852,15 +7903,22 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + + Emits a signal. +Note that g_signal_emit_by_name() resets the return value to the default +if no handlers are connected, in contrast to g_signal_emitv(). - + the instance the signal is being emitted on. + + a string of the form "signal-name::detail". @@ -4869,146 +7927,247 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + + Emits a signal. +Note that g_signal_emit_valist() resets the return value to the default +if no handlers are connected, in contrast to g_signal_emitv(). + + + + + + the instance the signal is being emitted on. + + + + the signal id + + + + the detail + + + + a list of parameters to be passed to the signal, followed by a location for the return value. If the return type of the signal is #G_TYPE_NONE, the return value location can be omitted. + + + + + Emits a signal. +Note that g_signal_emitv() doesn't change @return_value if no handlers are +connected, in contrast to g_signal_emit() and g_signal_emit_valist(). + argument list for the signal emission. The first element in the array is a #GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal. - + the signal id + + the detail + Location to store the return value of the signal emission. - + c:identifier="g_signal_get_invocation_hint" + introspectable="0"> + Returns the invocation hint of the innermost signal emission of instance. + + the invocation hint of the innermost signal emission. - + the instance to query + + Blocks a handler of an instance so it will not be called during any +signal emissions unless it is unblocked again. Thus "blocking" a +signal handler means to temporarily deactive it, a signal handler +has to be unblocked exactly the same amount of times it has been +blocked before to become active again. +The @handler_id has to be a valid signal handler id, connected to a +signal of @instance. - + The instance to block the signal handler of. + - + Handler id of the handler to be blocked. + + Disconnects a handler from an instance so it will not be called during +any future or currently ongoing emissions of the signal it has been +connected to. The @handler_id becomes invalid and may be reused. +The @handler_id has to be a valid signal handler id, connected to a +signal of @instance. - + The instance to remove the signal handler from. + - + Handler id of the handler to be disconnected. + + Finds the first signal handler that matches certain selection criteria. +The criteria mask is passed as an OR-ed combination of #GSignalMatchType +flags, and the criteria values are passed as arguments. +The match @mask has to be non-0 for successful matches. +If no handler was found, 0 is returned. - + A valid non-0 signal handler id for a successful match. + - + The instance owning the signal handler to be found. + + Mask indicating which of @signal_id, @detail, @closure, @func and/or @data the handler has to match. - + Signal the handler has to be connected to. + + Signal detail the handler has to be connected to. + The closure the handler will invoke. - + The C closure callback of the handler (useless for non-C closures). + - + The closure data of the handler's closure. + + Returns whether @handler_id is the id of a handler connected to @instance. - + whether @handler_id identifies a handler connected to @instance. + - + The instance where a signal handler is sought. + - + the handler id. + + Undoes the effect of a previous g_signal_handler_block() call. A +blocked handler is skipped during signal emissions and will not be +invoked, unblocking it (for exactly the amount of times it has been +blocked before) reverts its "blocked" state, so the handler will be +recognized by the signal system and is called upon future or +currently ongoing signal emissions (since the order in which +handlers are called during signal emissions is deterministic, +whether the unblocked handler in question is called as part of a +currently ongoing emission depends on how far that emission has +proceeded yet). +The @handler_id has to be a valid id of a signal handler that is +connected to a signal of @instance and is currently blocked. - + The instance to unblock the signal handler of. + - + Handler id of the handler to be unblocked. + + Blocks all handlers on an instance that match a certain selection criteria. +The criteria mask is passed as an OR-ed combination of #GSignalMatchType +flags, and the criteria values are passed as arguments. +Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC +or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. +If no handlers were found, 0 is returned, the number of blocked handlers +otherwise. - + The number of handlers that matched. + - + The instance to block handlers from. + + Mask indicating which of @signal_id, @detail, @closure, @func and/or @data the handlers have to match. - + Signal the handlers have to be connected to. + + Signal detail the handlers have to be connected to. + The closure the handlers will invoke. - + The C closure callback of the handlers (useless for non-C closures). + - + The closure data of the handlers' closures. + @@ -5019,85 +8178,129 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + + Disconnects all handlers on an instance that match a certain +selection criteria. The criteria mask is passed as an OR-ed +combination of #GSignalMatchType flags, and the criteria values are +passed as arguments. Passing at least one of the +%G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC or +%G_SIGNAL_MATCH_DATA match flags is required for successful +matches. If no handlers were found, 0 is returned, the number of +disconnected handlers otherwise. - + The number of handlers that matched. + - + The instance to remove handlers from. + + Mask indicating which of @signal_id, @detail, @closure, @func and/or @data the handlers have to match. - + Signal the handlers have to be connected to. + + Signal detail the handlers have to be connected to. + The closure the handlers will invoke. - + The C closure callback of the handlers (useless for non-C closures). + - + The closure data of the handlers' closures. + + Unblocks all handlers on an instance that match a certain selection +criteria. The criteria mask is passed as an OR-ed combination of +#GSignalMatchType flags, and the criteria values are passed as arguments. +Passing at least one of the %G_SIGNAL_MATCH_CLOSURE, %G_SIGNAL_MATCH_FUNC +or %G_SIGNAL_MATCH_DATA match flags is required for successful matches. +If no handlers were found, 0 is returned, the number of unblocked handlers +otherwise. The match criteria should not apply to any handlers that are +not currently blocked. - + The number of handlers that matched. + - + The instance to unblock handlers from. + + Mask indicating which of @signal_id, @detail, @closure, @func and/or @data the handlers have to match. - + Signal the handlers have to be connected to. + + Signal detail the handlers have to be connected to. + The closure the handlers will invoke. - + The C closure callback of the handlers (useless for non-C closures). + - + The closure data of the handlers' closures. + + Returns whether there are any handlers connected to @instance for the +given signal id and detail. +One example of when you might use this is when the arguments to the +signal are difficult to compute. A class implementor may opt to not +emit the signal if no one is attached anyway, thus saving the cost +of building the arguments. +otherwise. - + %TRUE if a handler is connected to the signal, %FALSE + - + the object whose signal handlers are sought. + - + the signal id. + + the detail. - + whether blocked handlers should count as match. + @@ -5107,75 +8310,111 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - - + Lists the signals by id that a certain instance or interface type +created. Further information about the signals can be acquired through +g_signal_query(). + + Newly allocated array of signal IDs. + + Instance or interface type. - - + + Location to store the number of signal ids for @itype. + + Given the name of the signal and the type of object it connects to, gets +the signal's identifying integer. Emitting the signal by number is +somewhat faster than using the name each time. +Also tries the ancestors of the given type. +See g_signal_new() for details on allowed signal names. - + the signal's identifying number, or 0 if no signal was found. + + the signal's name. + the type that the signal operates on. + Given the signal's identifier, finds its name. +Two different signals may have the same name, if they have differing types. + the signal name, or %NULL if the signal number was invalid. - + the signal's identifying number. + - + + Creates a new signal. (This is usually done in the class initializer.) +A signal name consists of segments consisting of ASCII letters and +digits, separated by either the '-' or '_' character. The first +character of a signal name must be a letter. Names which violate these +rules lead to undefined behaviour of the GSignal system. +When registering a signal and looking up a signal, either separator can +be used, but they cannot be mixed. +If 0 is used for @class_offset subclasses cannot override the class handler +in their <code>class_init</code> method by doing +<code>super_class->signal_handler = my_signal_handler</code>. Instead they +will have to use g_signal_override_class_handler(). - + the signal id + + the name for the signal + the type this signal pertains to. It will also pertain to types which are derived from this type. + a combination of #GSignalFlags specifying detail of when the default handler is to be invoked. You should at least specify %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST. - + The offset of the function pointer in the class structure for this type. Used to invoke a class method generically. Pass 0 to not associate a class method slot with this signal. + - + + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. + + the function to translate arrays of parameter values to signal emissions into C language callback invocations. + the type of return value, or #G_TYPE_NONE for a signal without a return value. - + the number of parameter types to follow. + @@ -5184,40 +8423,60 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + c:identifier="g_signal_new_class_handler" + version="2.18" + introspectable="0"> + Creates a new signal. (This is usually done in the class initializer.) +This is a variant of g_signal_new() that takes a C callback instead +off a class offset for the signal's class handler. This function +doesn't need a function pointer exposed in the class structure of +an object definition, instead the function pointer is passed +directly and can be overriden by derived classes with +g_signal_override_class_closure() or +g_signal_override_class_handler()and chained to with +g_signal_chain_from_overridden() or +g_signal_chain_from_overridden_handler(). +See g_signal_new() for information about signal names. - + the signal id + + the name for the signal + the type this signal pertains to. It will also pertain to types which are derived from this type. + a combination of #GSignalFlags specifying detail of when the default handler is to be invoked. You should at least specify %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST. - + + a #GCallback which acts as class implementation of this signal. Used to invoke a class method generically. Pass %NULL to not associate a class method with this signal. - + + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. + + the function to translate arrays of parameter values to signal emissions into C language callback invocations. + the type of return value, or #G_TYPE_NONE for a signal without a return value. - + the number of parameter types to follow. + @@ -5225,240 +8484,408 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + + Creates a new signal. (This is usually done in the class initializer.) +See g_signal_new() for details on allowed signal names. - + the signal id + + the name for the signal + the type this signal pertains to. It will also pertain to types which are derived from this type. + a combination of #GSignalFlags specifying detail of when the default handler is to be invoked. You should at least specify %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST. + The closure to invoke on signal emission; may be %NULL. - + + the accumulator for this signal; may be %NULL. - + user data for the @accumulator. + + the function to translate arrays of parameter values to signal emissions into C language callback invocations. + the type of return value, or #G_TYPE_NONE for a signal without a return value. - + the number of parameter types in @args. + - + + va_list of #GType, one for each parameter. + + + + + + Creates a new signal. (This is usually done in the class initializer.) +See g_signal_new() for details on allowed signal names. + + the signal id + + + + + the name for the signal + + + + the type this signal pertains to. It will also pertain to types which are derived from this type + + + + a combination of #GSignalFlags specifying detail of when the default handler is to be invoked. You should at least specify %G_SIGNAL_RUN_FIRST or %G_SIGNAL_RUN_LAST + + + + The closure to invoke on signal emission; may be %NULL + + + + the accumulator for this signal; may be %NULL + + + + user data for the @accumulator + + + + the function to translate arrays of parameter values to signal emissions into C language callback invocations + + + + the type of return value, or #G_TYPE_NONE for a signal without a return value + + + + the length of @param_types + + + + an array of types, one for each parameter + Overrides the class closure (i.e. the default handler) for the given signal +for emissions on instances of @instance_type. @instance_type must be derived +from the type to which the signal belongs. +See g_signal_chain_from_overridden() and +g_signal_chain_from_overridden_handler() for how to chain up to the +parent class closure from inside the overridden one. - + the signal id + + the instance type on which to override the class closure for the signal. + the closure. + c:identifier="g_signal_override_class_handler" + version="2.18" + introspectable="0"> + Overrides the class closure (i.e. the default handler) for the +given signal for emissions on instances of @instance_type with +callabck @class_handler. @instance_type must be derived from the +type to which the signal belongs. +See g_signal_chain_from_overridden() and +g_signal_chain_from_overridden_handler() for how to chain up to the +parent class closure from inside the overridden one. + the name for the signal + the instance type on which to override the class handler for the signal. - + + the handler. + Internal function to parse a signal name into its @signal_id +and @detail quark. - + Whether the signal name could successfully be parsed and @signal_id_p and @detail_p contain valid return values. + + a string of the form "signal-name::detail". + The interface/instance type that introduced "signal-name". - - + + Location to store the signal id. + + Location to store the detail quark. - + %TRUE forces creation of a #GQuark for the detail. + + Queries the signal system for in-depth information about a +specific signal. This function will fill in a user-provided +structure to hold signal-specific information. If an invalid +signal id is passed in, the @signal_id member of the #GSignalQuery +is 0. All members filled into the #GSignalQuery structure should +be considered constant and have to be left untouched. - + The signal id of the signal to query information for. + + A user provided structure that is filled in with constant values upon success. + Deletes an emission hook. - + the id of the signal + - + the id of the emission hook, as returned by g_signal_add_emission_hook() + + Stops a signal's current emission. +This will prevent the default method from running, if the signal was +%G_SIGNAL_RUN_LAST and you connected normally (i.e. without the "after" +flag). +Prints a warning if used on a signal which isn't being emitted. - + the object whose signal handlers you wish to stop. + - + the signal identifier, as returned by g_signal_lookup(). + + the detail which the signal was emitted with. + Stops a signal's current emission. +This is just like g_signal_stop_emission() except it will look up the +signal id for you. - + the object whose signal handlers you wish to stop. + + a string of the form "signal-name::detail". + Creates a new closure which invokes the function found at the offset +identified by @itype. + a new #GCClosure + the #GType identifier of an interface or classed type - + the offset of the member function of @itype's class structure which is to be invoked by the new closure + + Set the callback for a source as a #GClosure. +If the source is not one of the standard GLib types, the @closure_callback +and @closure_marshal fields of the #GSourceFuncs structure must have been +filled in with pointers to appropriate functions. + the source + a #GClosure + Return a newly allocated string, which describes the contents of a +#GValue. The main purpose of this function is to describe #GValue +contents for debugging output, the way in which the contents are +described may change between different GLib versions. + Newly allocated string. + #GValue which contents are to be described. + + + + + + c:identifier="g_type_add_class_cache_func" + introspectable="0"> + Adds a #GTypeClassCacheFunc to be called before the reference count of a +class goes from one to zero. This can be used to prevent premature class +destruction. All installed #GTypeClassCacheFunc functions will be chained +until one of them returns %TRUE. The functions have to check the class id +passed in to figure whether they actually want to cache the class of this +type, since all classes are routed through the same #GTypeClassCacheFunc +chain. - + data to be passed to @cache_func + - + + a #GTypeClassCacheFunc + c:identifier="g_type_add_class_private" + version="2.24"> + Registers a private class structure for a classed type; +when the class is allocated, the private structures for +the class and all of its parent types are allocated +sequentially in the same memory block as the public +structures. This function should be called in the +type's get_type() function after the type is registered. +The private structure can be retrieved using the +G_TYPE_CLASS_GET_PRIVATE() macro. + GType of an classed type. - + size of private structure. + + c:identifier="g_type_add_interface_check" + version="2.4" + introspectable="0"> + Adds a function to be called after an interface vtable is +initialized for any class (i.e. after the @interface_init member of +#GInterfaceInfo has been called). +This function is useful when you want to check an invariant that +depends on the interfaces of a class. For instance, the +implementation of #GObject uses this facility to check that an +object implements all of the properties that are defined on its +interfaces. - + data to pass to @check_func + - + + function to be called after each interface is initialized. @@ -5466,41 +8893,54 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Adds the dynamic @interface_type to @instantiable_type. The information +contained in the #GTypePlugin structure pointed to by @plugin +is used to manage the relationship. + the #GType value of an instantiable type. + the #GType value of an interface type. + the #GTypePlugin structure to retrieve the #GInterfaceInfo from. + Adds the static @interface_type to @instantiable_type. The information +contained in the #GTypeInterfaceInfo structure pointed to by @info +is used to manage the relationship. + #GType value of an instantiable type. + #GType value of an interface type. + The #GInterfaceInfo structure for this (@instance_type, @interface_type) combination. - + c:identifier="g_type_check_class_cast" + introspectable="0"> + @@ -5515,7 +8955,7 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + @@ -5527,18 +8967,22 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE() +macro. - + + A valid #GTypeInstance structure. - + c:identifier="g_type_check_instance_cast" + introspectable="0"> + @@ -5553,7 +8997,7 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + @@ -5567,7 +9011,7 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + @@ -5577,7 +9021,7 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + @@ -5588,7 +9032,7 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + @@ -5600,326 +9044,565 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + Return a newly allocated and 0-terminated array of type IDs, listing the +child types of @type. The return value has to be g_free()ed after use. + + Newly allocated and 0-terminated array of child types. + The parent type. - - + + Optional #guint pointer to contain the number of child types. + + c:identifier="g_type_class_add_private" + version="2.4"> + Registers a private structure for an instantiatable type. +When an object is allocated, the private structures for +the type and all of its parent types are allocated +sequentially in the same memory block as the public +structures. +Note that the accumulated size of the private structures of +a type and all its parent types cannot excced 64kB. +This function should be called in the type's class_init() function. +The private structure can be retrieved using the +G_TYPE_INSTANCE_GET_PRIVATE() macro. +The following example shows attaching a private structure +<structname>MyObjectPrivate</structname> to an object +<structname>MyObject</structname> defined in the standard GObject +fashion. +type's class_init() function. +|[ +typedef struct _MyObject MyObject; +typedef struct _MyObjectPrivate MyObjectPrivate; +struct _MyObject { +GObject parent; +MyObjectPrivate *priv; +}; +struct _MyObjectPrivate { +int some_field; +}; +static void +my_object_class_init (MyObjectClass *klass) +{ +g_type_class_add_private (klass, sizeof (MyObjectPrivate)); +} +static void +my_object_init (MyObject *my_object) +{ +my_object->priv = G_TYPE_INSTANCE_GET_PRIVATE (my_object, +MY_TYPE_OBJECT, +MyObjectPrivate); +} +static int +my_object_get_some_field (MyObject *my_object) +{ +MyObjectPrivate *priv = my_object->priv; +return priv->some_field; +} +]| - + class structure for an instantiatable type + - + size of private structure. + - - - + + This function is essentially the same as g_type_class_ref(), except that +the classes reference count isn't incremented. As a consequence, this function +may return %NULL if the class of the type passed in does not currently +exist (hasn't been referenced before). +if the class does not currently exist. + + The #GTypeClass structure for the given type ID or %NULL + + Type ID of a classed type. - - + c:identifier="g_type_class_peek_parent" + introspectable="0"> + This is a convenience function often needed in class initializers. +It returns the class structure of the immediate parent type of the +class passed in. Since derived classes hold a reference count on +their parent classes as long as they are instantiated, the returned +class will always exist. This function is essentially equivalent +to: +<programlisting> +g_type_class_peek (g_type_parent (G_TYPE_FROM_CLASS (g_class))); +</programlisting> + + The parent class of @g_class. + - + The #GTypeClass structure to retrieve the parent class for. + - - + c:identifier="g_type_class_peek_static" + version="2.4" + introspectable="0"> + A more efficient version of g_type_class_peek() which works only for +static types. +if the class does not currently exist or is dynamically loaded. + + The #GTypeClass structure for the given type ID or %NULL + + Type ID of a classed type. - - - + + Increments the reference count of the class structure belonging to +exist already. + + The #GTypeClass structure for the given type ID. + + Type ID of a classed type. + Decrements the reference count of the class structure being passed in. +Once the last reference count of a class has been released, classes +may be finalized by the type system, so further dereferencing of a +class pointer after g_type_class_unref() are invalid. - + The #GTypeClass structure to unreference. + + A variant of g_type_class_unref() for use in #GTypeClassCacheFunc +implementations. It unreferences a class without consulting the chain +of #GTypeClassCacheFunc<!-- -->s, avoiding the recursion which would occur +otherwise. - + The #GTypeClass structure to unreference. + - + c:identifier="g_type_create_instance" + introspectable="0"> + Creates and initializes an instance of @type if @type is valid and +can be instantiated. The type system only performs basic allocation +happen through functions supplied by the type's fundamental type +implementation. So use of g_type_create_instance() is reserved for +implementators of fundamental types only. E.g. instances of the +#GObject hierarchy should be created via g_object_new() and +<emphasis>never</emphasis> directly through +g_type_create_instance() which doesn't handle things like singleton +use this function, unless you're implementing a fundamental +type. Also language bindings should <emphasis>not</emphasis> use +this function but g_object_new() instead. +treatment by the fundamental type implementation. + + An allocated and initialized instance, subject to further + An instantiatable type to create an instance for. - - + c:identifier="g_type_default_interface_peek" + version="2.4" + introspectable="0"> + If the interface type @g_type is currently in use, returns its +default interface vtable. +if the type is not currently in use. + + the default vtable for the interface, or %NULL + + an interface type - - + c:identifier="g_type_default_interface_ref" + version="2.4" + introspectable="0"> + Increments the reference count for the interface type @g_type, +and returns the default interface vtable for the type. +If the type is not currently in use, then the default vtable +for the type will be created and initalized by calling +the base interface init and default vtable init functions for +the type (the @<structfield>base_init</structfield> +and <structfield>class_init</structfield> members of #GTypeInfo). +Calling g_type_default_interface_ref() is useful when you +want to make sure that signals and properties for an interface +have been installed. +g_type_default_interface_unref() when you are done using +the interface. + + the default vtable for the interface; call + + an interface type + c:identifier="g_type_default_interface_unref" + version="2.4"> + Decrements the reference count for the type corresponding to the +interface default vtable @g_iface. If the type is dynamic, then +when no one is using the interface and all references have +been released, the finalize function for the interface's default +vtable (the <structfield>class_finalize</structfield> member of +#GTypeInfo) will be called. - + the default vtable structure for a interface, as returned by g_type_default_interface_ref() + + Returns the length of the ancestry of the passed in type. This +includes the type itself, so that e.g. a fundamental type has depth 1. - + The depth of @type. + + A #GType value. + Frees an instance of a type, returning it to the instance pool for +the type, if there is one. +Like g_type_create_instance(), this function is reserved for +implementors of fundamental types. + an instance of a type. + Lookup the type ID from a given type name, returning 0 if no type +has been registered under this name (this is the preferred method +to find out by name whether a specific type has been registered +yet). + Corresponding type ID or 0. + Type name to lookup. + Internal function, used to extract the fundamental type ID portion. +use G_TYPE_FUNDAMENTAL() instead. + fundamental type ID + valid type ID + Returns the next free fundamental type id which can be used to +register a new fundamental type with g_type_register_fundamental(). +The returned type ID represents the highest currently registered +fundamental type identifier. +or 0 if the type system ran out of fundamental type IDs. + The nextmost fundamental type ID to be registered, - - + + Returns the #GTypePlugin structure for @type or +%NULL if @type does not have a #GTypePlugin structure. +%NULL otherwise. + + The corresponding plugin if @type is a dynamic type, + The #GType to retrieve the plugin for. - - - + + Obtains data which has previously been attached to @type +with g_type_set_qdata(). + + the data, or %NULL if no data was found + + a #GType + a #GQuark id to identify the data + Prior to any use of the type system, g_type_init() has to be called +to initialize the type system and assorted other code portions +(such as the various fundamental type implementations or the signal +system). +Since version 2.24 this also initializes the thread system + Similar to g_type_init(), but additionally sets debug flags. + Bitwise combination of #GTypeDebugFlags values for debugging purposes. + Adds @prerequisite_type to the list of prerequisites of @interface_type. +This means that any type implementing @interface_type must also implement +interface derivation (which GType doesn't support). An interface can have +at most one instantiatable prerequisite type. + #GType value of an interface type. + #GType value of an interface or instantiatable type. - + c:identifier="g_type_interface_get_plugin" + introspectable="0"> + Returns the #GTypePlugin structure for the dynamic interface +have a #GTypePlugin structure. See g_type_add_interface_dynamic(). +of @instance_type. + + the #GTypePlugin for the dynamic interface @interface_type + the #GType value of an instantiatable type. + the #GType value of an interface type. - - - + + Returns the #GTypeInterface structure of an interface to which the +passed in class conforms. +by @instance_class, %NULL otherwise + + The GTypeInterface structure of iface_type if implemented + - + A #GTypeClass structure. + + An interface ID which this class conforms to. - - + c:identifier="g_type_interface_peek_parent" + introspectable="0"> + Returns the corresponding #GTypeInterface structure of the parent type +of the instance type to which @g_iface belongs. This is useful when +deriving the implementation of an interface from the parent type and +then possibly overriding some methods. +type of the instance type to which @g_iface belongs, or +%NULL if the parent type doesn't conform to the interface. + + The corresponding #GTypeInterface structure of the parent + - + A #GTypeInterface structure. + - + c:identifier="g_type_interface_prerequisites" + version="2.2"> + Returns the prerequisites of an interfaces type. +the prerequisites of @interface_type + + a newly-allocated zero-terminated array of #GType containing + an interface type - - + + location to return the number of prerequisites, or %NULL + - + Return a newly allocated and 0-terminated array of type IDs, listing the +interface types that @type conforms to. The return value has to be +g_free()ed after use. + + Newly allocated and 0-terminated array of interface types. + The type to list interface types for. - - + + Optional #guint pointer to contain the number of interface types. + + If @is_a_type is a derivable type, check whether @type is a +descendant of @is_a_type. If @is_a_type is an interface, check +whether @type conforms to it. - + %TRUE if @type is_a @is_a_type holds true. + + Type to check anchestry for. + Possible anchestor of @type or interface @type could conform to. + Get the unique name that is assigned to a type ID. Note that this +function (like all other GType API) cannot cope with invalid type +IDs. %G_TYPE_INVALID may be passed to this function, as may be any +other validly registered type ID, but randomized type IDs should +not be passed in and will most likely lead to a crash. + Static type name or %NULL. + Type to return name for. @@ -5947,208 +9630,297 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Given a @leaf_type and a @root_type which is contained in its +anchestry, return the type that @root_type is the immediate parent +of. In other words, this function determines the type that is +derived directly from @root_type which is also a base class of +be used to determine the types and order in which the leaf type is +descended from the root type. + Immediate child of @root_type and anchestor of @leaf_type. + Descendant of @root_type and the type to be returned. + Immediate parent of the returned type. + Return the direct parent type of the passed in type. If the passed +in type has no parent, i.e. is a fundamental type, 0 is returned. + The parent type. + The derived type. - + Get the corresponding quark of the type IDs name. + + The type names quark or 0. + Type to return quark of type name for. + Queries the type system for information about a specific type. +This function will fill in a user-provided structure to hold +type-specific information. If an invalid #GType is passed in, the +#GTypeQuery structure should be considered constant and have to be +left untouched. + the #GType value of a static, classed type. + A user provided structure that is filled in with constant values upon success. + Registers @type_name as the name of a new dynamic type derived from +#GTypePlugin structure pointed to by @plugin to manage the type and its +instances (if not abstract). The value of @flags determines the nature +(e.g. abstract or not) of the type. + The new type identifier or #G_TYPE_INVALID if registration failed. + Type from which this type will be derived. + 0-terminated string used as the name of the new type. + The #GTypePlugin structure to retrieve the #GTypeInfo from. + Bitwise combination of #GTypeFlags values. + Registers @type_id as the predefined identifier and @type_name as the +name of a fundamental type. The type system uses the information +contained in the #GTypeInfo structure pointed to by @info and the +#GTypeFundamentalInfo structure pointed to by @finfo to manage the +type and its instances. The value of @flags determines additional +characteristics of the fundamental type. + The predefined type identifier. + A predefined type identifier. + 0-terminated string used as the name of the new type. + The #GTypeInfo structure for this type. + The #GTypeFundamentalInfo structure for this type. + Bitwise combination of #GTypeFlags values. + Registers @type_name as the name of a new static type derived from +#GTypeInfo structure pointed to by @info to manage the type and its +instances (if not abstract). The value of @flags determines the nature +(e.g. abstract or not) of the type. + The new type identifier. + Type from which this type will be derived. + 0-terminated string used as the name of the new type. + The #GTypeInfo structure for this type. + Bitwise combination of #GTypeFlags values. + c:identifier="g_type_register_static_simple" + version="2.12" + introspectable="0"> + Registers @type_name as the name of a new static type derived from +abstract or not) of the type. It works by filling a #GTypeInfo +struct and calling g_type_register_static(). + The new type identifier. + Type from which this type will be derived. + 0-terminated string used as the name of the new type. - + Size of the class structure (see #GTypeInfo) + - + + Location of the class initialization function (see #GTypeInfo) - + Size of the instance structure (see #GTypeInfo) + - + + Location of the instance initialization function (see #GTypeInfo) + Bitwise combination of #GTypeFlags values. + c:identifier="g_type_remove_class_cache_func" + introspectable="0"> + Removes a previously installed #GTypeClassCacheFunc. The cache +maintained by @cache_func has to be empty when calling +g_type_remove_class_cache_func() to avoid leaks. - + data that was given when adding @cache_func + - + + a #GTypeClassCacheFunc + c:identifier="g_type_remove_interface_check" + version="2.4" + introspectable="0"> + Removes an interface check function added with +g_type_add_interface_check(). - + callback data passed to g_type_add_interface_check() + - + + callback function passed to g_type_add_interface_check() + Attaches arbitrary data to a type. + a #GType + a #GQuark id to identify the data - + the data + - + - + - + c:identifier="g_type_value_table_peek" + introspectable="0"> + Returns the location of the #GTypeValueTable associated with @type. +<emphasis>Note that this function should only be used from source code +that implements or has internal knowledge of the implementation of +%NULL if there is no #GTypeValueTable associated with @type. + + Location of the #GTypeValueTable associated with @type or + A #GType value. @@ -6159,20 +9931,25 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + c:identifier="g_value_register_transform_func" + introspectable="0"> + Registers a value transformation function for use in g_value_transform(). +A previously registered transformation function for @src_type and @dest_type +will be replaced. + Source type. + Target type. - + + a function which transforms values of type @src_type into value of type @dest_type @@ -6185,28 +9962,38 @@ with the object, apart from e.g. using its adress as hash-index or the like."> + Returns whether a #GValue of type @src_type can be copied into +a #GValue of type @dest_type. - + %TRUE if g_value_copy() is possible with @src_type and @dest_type. + + source type to be copied. + destination type for copying. + Check whether g_value_transform() is able to transform values +of type @src_type into values of type @dest_type. - + %TRUE if the transformation is possible, %FALSE otherwise. + + Source type. + Target type. @@ -6216,7 +10003,10 @@ with the object, apart from e.g. using its adress as hash-index or the like."> - + diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index 30100de3b9..070a2c5dea 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -1,11 +1,15 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.destructors alien.libraries -classes.struct combinators kernel literals math system -gobject-introspection glib.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.destructors alien.libraries alien.syntax +combinators gobject-introspection literals math system vocabs.loader ; IN: gobject.ffi +<< +"glib.ffi" require +>> + +LIBRARY: gobject + << "gobject" { { [ os winnt? ] [ "libobject-2.0-0.dll" cdecl add-library ] } @@ -14,17 +18,12 @@ IN: gobject.ffi } cond >> -TYPEDEF: void* GSignalCMarshaller -TYPEDEF: gchar** GStrv -TYPEDEF: gchar* gchararray +IMPLEMENT-STRUCTS: GValue GParamSpecVariant ; GIR: vocab:gobject/GObject-2.0.gir IN: gobject.ffi -FORGET: GValue -STRUCT: GValue { g_type GType } { data guint64[2] } ; - FORGET: GIOCondition FORGET: G_IO_IN FORGET: G_IO_OUT @@ -33,12 +32,8 @@ FORGET: G_IO_ERR FORGET: G_IO_HUP FORGET: G_IO_NVAL -FUNCTION: void g_object_unref ( GObject* self ) ; - DESTRUCTOR: g_object_unref -TYPEDEF: GParamSpec GParam - CONSTANT: G_TYPE_INVALID $[ 0 2 shift ] CONSTANT: G_TYPE_NONE $[ 1 2 shift ] CONSTANT: G_TYPE_INTERFACE $[ 2 2 shift ] @@ -71,4 +66,3 @@ CONSTANT: G_TYPE_OBJECT $[ 20 2 shift ] : g_signal_connect_swapped ( instance detailed_signal c_handler data -- result ) f G_CONNECT_SWAPPED g_signal_connect_data ; - diff --git a/basis/gtk/Gtk-2.0.gir b/basis/gtk/Gtk-3.0.gir similarity index 59% rename from basis/gtk/Gtk-2.0.gir rename to basis/gtk/Gtk-3.0.gir index 9eeb927e85..474b6e0017 100644 --- a/basis/gtk/Gtk-2.0.gir +++ b/basis/gtk/Gtk-3.0.gir @@ -2,7 +2,7 @@ - @@ -10,687 +10,670 @@ and/or use gtk-doc annotations. --> - + - - - - - - - - - - - - - + version="3.0" + shared-library="libgtk-x11-3.0.so.0" + c:identifier-prefixes="Gtk" + c:symbol-prefixes="gtk"> + + A <structname>GtkAllocation</structname> of a widget represents region which has been allocated to the +widget by its parent. It is a subregion of its parents allocation. See +<xref linkend="size-allocation"/> for more information. + + + The <structname>GtkAboutDialog</structname> struct contains +only private fields and should not be directly accessed. + - - + Creates a new #GtkAboutDialog. + + a newly created #GtkAboutDialog + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + introspectable="0"> + Returns the string which are displayed in the artists tab +of the secondary credits dialog. +the artists. The array is owned by the about dialog +and must not be modified. + + A %NULL-terminated string array containing + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns the string which are displayed in the authors tab of the secondary credits dialog. the authors. The array is owned by the about dialog -and must not be modified." - version="2.6"> - +and must not be modified. + + A %NULL-terminated string array containing - + Returns the comments string. +dialog and must not be modified. - + The comments. The string is owned by the about + + + + + Returns the copyright string. +dialog and must not be modified. + + The copyright string. The string is owned by the about + - - - - - - - + Returns the string which are displayed in the documenters tab of the secondary credits dialog. the documenters. The array is owned by the about dialog -and must not be modified." - version="2.6"> - +and must not be modified. + + A %NULL-terminated string array containing - + Returns the license information. +dialog and must not be modified. - + The license information. The string is owned by the about + - - - - - - - - + Retrieves the license set using gtk_about_dialog_set_license_type() + + a #GtkLicense value + + + + + Returns the pixbuf displayed as logo in the about dialog. +owned by the about dialog. If you want to keep a reference +to it, you have to call g_object_ref() on it. + + the pixbuf displayed as logo. The pixbuf is + + + + - - - - + Returns the icon name displayed as logo in the about dialog. +owned by the dialog. If you want to keep a reference +to it, you have to call g_strdup() on it. + + the icon name displayed as logo. The string is + + + + + Returns the program name displayed in the about dialog. +dialog and must not be modified. + + The program name. The string is owned by the about + + + + + Returns the translator credits string which is displayed +in the translators tab of the secondary credits dialog. +owned by the about dialog and must not be modified. + + The translator credits string. The string is + + + + + Returns the version string. +dialog and must not be modified. + + The version string. The string is owned by the about + + + + + Returns the website URL. +dialog and must not be modified. + + The website URL. The string is owned by the about + + + + + Returns the label used for the website link. +owned by the about dialog and must not be modified. + + The label used for the website link. The string is + + + + + Returns whether the license text in @about is +automatically wrapped. + + %TRUE if the license text is wrapped + + Sets the strings which are displayed in the artists tab +of the secondary credits dialog. - - - + a %NULL-terminated array of strings + - + Sets the strings which are displayed in the authors tab +of the secondary credits dialog. - + + + + a %NULL-terminated array of strings + + + + + + Sets the comments string to display in the about dialog. +This should be a short string of one or two lines. + + + + + + a comments string + + + + + + Sets the copyright string to display in the about dialog. +This should be a short string of one or two lines. + + + + + + (allow-none) the copyright string + + + + + + Sets the strings which are displayed in the documenters tab +of the secondary credits dialog. + + + + + + a %NULL-terminated array of strings + + + + + + Sets the license information to be displayed in the secondary +license dialog. If @license is %NULL, the license button is +hidden. + + + + + + the license information or %NULL + + + + + + Sets the license of the application showing the @about dialog from a +list of known licenses. +This function overrides the license set using +gtk_about_dialog_set_license(). + + + + + + the type of license + + + + + + Sets the pixbuf to be displayed as logo in the about dialog. +If it is %NULL, the default window icon set with +gtk_window_set_default_icon() will be used. + + + + + + a #GdkPixbuf, or %NULL + + + + + + Sets the pixbuf to be displayed as logo in the about dialog. +If it is %NULL, the default window icon set with +gtk_window_set_default_icon() will be used. + + + + + + an icon name, or %NULL + + + + + + Sets the name to display in the about dialog. +If this is not set, it defaults to g_get_application_name(). + + + + + + the program name + + + + Sets the translator credits string which is displayed in the translators tab of the secondary credits dialog. The intended use for this string is to display the translator of the language which is currently used in the user interface. Using gettext(), a simple way to achieve that is to mark the string for translation: |[ -gtk_about_dialog_set_translator_credits (about, _("translator-credits")); +gtk_about_dialog_set_translator_credits (about, _("translator-credits")); ]| -It is a good idea to use the customary msgid "translator-credits" for this +It is a good idea to use the customary msgid "translator-credits" for this purpose, since translators will already know the purpose of that msgid, and -since #GtkAboutDialog will detect if "translator-credits" is untranslated -and hide the tab." - version="2.6"> +since #GtkAboutDialog will detect if "translator-credits" is untranslated +and hide the tab. + allow-none="1"> + the translator credits - - - - - - + Sets the version string to display in the about dialog. - - + + the version string + - - - - - - + Sets the URL to use for the website link. +Note that that the hook functions need to be set up +before calling this function. - + + (allow-none): a URL string starting with "http://" + + Sets the label to be used for the website link. +It defaults to the website URL. + + + + + + the label used for the website link + + + + + + Sets whether the license text in @about is +automatically wrapped. + + + + + + whether to wrap the license + + + + + The people who contributed artwork to the program, as a %NULL-terminated array of strings. Each string may contain email addresses and URLs, which -will be displayed as links, see the introduction for more details."> - +will be displayed as links, see the introduction for more details. + + The authors of the program, as a %NULL-terminated array of strings. Each string may contain email addresses and URLs, which will be displayed -as links, see the introduction for more details."> - +as links, see the introduction for more details. + + Comments about the program. This string is displayed in a label in the main dialog, thus it should be a short explanation of -the main purpose of the program, not a detailed list of features."> - +the main purpose of the program, not a detailed list of features. + - + transfer-ownership="none"> + Copyright information for the program. + + The people documenting the program, as a %NULL-terminated array of strings. Each string may contain email addresses and URLs, which will be displayed -as links, see the introduction for more details."> - +as links, see the introduction for more details. + + The license of the program. This string is displayed in a text view in a secondary dialog, therefore it is fine to use a long multi-paragraph text. Note that the text is only wrapped -in the text view if the "wrap-license" property is set to %TRUE; -otherwise the text itself must contain the intended linebreaks."> - +in the text view if the "wrap-license" property is set to %TRUE; +otherwise the text itself must contain the intended linebreaks. +When setting this property to a non-%NULL value, the +#GtkAboutDialog:license-type property is set to %GTK_LICENSE_CUSTOM +as a side effect. + + + + The license of the program, as a value of the %GtkLicense enumeration. +The #GtkAboutDialog will automatically fill out a standard disclaimer +and link the user to the appropriate online resource for the license +text. +If %GTK_LICENSE_UNKNOWN is used, the link used will be the same +specified in the #GtkAboutDialog:website property. +If %GTK_LICENSE_CUSTOM is used, the current contents of the +#GtkAboutDialog:license property are used. +For any other #GtkLicense value, the contents of the +#GtkAboutDialog:license property are also set by this property as +a side effect. + - + transfer-ownership="none"> + A logo for the about box. If this is not set, it defaults to +gtk_window_get_default_icon_list(). + - + transfer-ownership="none"> + A named icon to use as the logo for the about box. This property +overrides the #GtkAboutDialog:logo property. + - + transfer-ownership="none"> + The name of the program. +If this is not set, it defaults to g_get_application_name(). + + Credits to the translators. This string should be marked as translatable. The string may contain email addresses and URLs, which will be displayed -as links, see the introduction for more details."> - +as links, see the introduction for more details. + - + transfer-ownership="none"> + The version of the program. + - + transfer-ownership="none"> + The URL for the link to the website of the program. +This should be a string starting with "http://. + - + transfer-ownership="none"> + The label for the link to the website of the program. If this is not set, +it defaults to the URL specified in the #GtkAboutDialog:website property. + - + transfer-ownership="none"> + Whether to wrap the text in the license dialog. + - - + + + + The signal which gets emitted to activate a URI. +Applications may connect to it to override the default behaviour, +which is to call gtk_show_uri(). + + %TRUE if the link has been activated + + + + + the URI that is activated + + + + - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + - - + + - - + + - - + + + + glib:nick="mask"/> - + An object representing and maintaining a group of accelerators. + + Creates a new #GtkAccelGroup. + a new #GtkAccelGroup object - + introspectable="0"> + Finds the #GtkAccelGroup to which @closure is connected; +see gtk_accel_group_connect(). + + the #GtkAccelGroup to which @closure is connected, or %NULL. + a #GClosure - + + Finds the first accelerator in @accel_group +that matches @accel_key and @accel_mods, and +activates it. - + %TRUE if an accelerator was activated and handled this keypress + + + + the quark for the accelerator name + + + + the #GObject, usually a #GtkWindow, on which to activate the accelerator. + + + + accelerator keyval from a key event + + + + keyboard state mask from a key event + + + - - - - - - - - - - - - - - - - + Installs an accelerator in this group. When @accel_group is being activated in response to a call to gtk_accel_groups_activate(), @closure will be invoked if the @accel_key and @accel_mods from gtk_accel_groups_activate() match those of this connection. The signature used for the @closure is that of #GtkAccelGroupActivate. Note that, due to implementation details, a single closure can only be -connected to one accelerator group."> +connected to one accelerator group. - + key value of the accelerator + + modifier combination of the accelerator + a flag mask to configure this accelerator + closure to be executed upon accelerator activation + Installs an accelerator in this group, using an accelerator path to look up the appropriate key and modifiers (see gtk_accel_map_add_entry()). When @accel_group is being activated in response to a call to gtk_accel_groups_activate(), @closure will be invoked if the @accel_key and for the path. The signature used for the @closure is that of #GtkAccelGroupActivate. Note that @accel_path string will be stored in a #GQuark. Therefore, if you -pass a static string, you can save some memory by interning it first with -g_intern_static_string()."> +pass a static string, you can save some memory by interning it first with +g_intern_static_string(). + path used for determining key and modifiers. + closure to be executed upon accelerator activation - + Removes an accelerator previously installed through gtk_accel_group_connect(). -Since 2.20 @closure can be %NULL."> +Since 2.20 @closure can be %NULL. - + %TRUE if the closure was found and got disconnected + - + + the closure to remove from this accelerator group, or %NULL to remove all closures + c:identifier="gtk_accel_group_disconnect_key"> + Removes an accelerator previously installed through +gtk_accel_group_connect(). - + %TRUE if there was an accelerator which could be removed, %FALSE otherwise + - - - - - - - - - - - - - - - - - - - - + key value of the accelerator + + modifier combination of the accelerator - + introspectable="0"> + Finds the first entry in an accelerator group for which + + the key of the first entry passing @find_func. The key is owned by GTK+ and must not be freed. - + + a function to filter the entries of @accel_group with - + data to pass to @find_func + + + Locks are added and removed using gtk_accel_group_lock() and +gtk_accel_group_unlock(). +%FALSE otherwise. + + %TRUE if there are 1 or more locks on the @accel_group, + + + + + Gets a #GdkModifierType representing the mask for this + + the modifier mask for this accel group. + + + + + Locks the given accelerator group. +Locking an acelerator group prevents the accelerators contained +within it to be changed during runtime. Refer to +gtk_accel_map_change_entry() about runtime accelerator changes. +If called more than once, @accel_group remains locked until +gtk_accel_group_unlock() has been called an equivalent number +of times. + + + + - + introspectable="0"> + Queries an accelerator group for all entries matching @accel_key and + + an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed. - + key value of the accelerator + + modifier combination of the accelerator - - + + location to return the number of entries found, or %NULL + - - + + Undoes the last call to gtk_accel_group_lock() on this @accel_group. + + + + + + - - + + - - + + - - - - - - - - - - - - - - - + + The accel-activate signal is an implementation detail of +#GtkAccelGroup and not meant to be used by applications. + + %TRUE if the accelerator was activated + - - + + the object on which the accelerator was activated + - - + + the accelerator keyval + - - + + the modifier combination of the accelerator + - - - + + The accel-changed signal is emitted when a #GtkAccelGroupEntry +is added to or removed from the accel group. +Widgets like #GtkAccelLabel which display an associated +accelerator should connect to this signal, and rebuild +their visual representation if the @accel_closure is theirs. + + - - + + the accelerator keyval + - - + + the modifier combination of the accelerator + - - + + the #GClosure of the accelerator + - + @@ -1001,7 +989,7 @@ their visual representation if the @accel_closure is theirs."> - + @@ -1015,7 +1003,7 @@ their visual representation if the @accel_closure is theirs."> - + @@ -1024,7 +1012,7 @@ their visual representation if the @accel_closure is theirs."> - + @@ -1035,29 +1023,29 @@ their visual representation if the @accel_closure is theirs."> - - + + - - + + - - + + - - + + @@ -1079,7 +1067,7 @@ their visual representation if the @accel_closure is theirs."> c:type="GtkAccelGroupFindFunc" version="2.2"> - + @@ -1089,123 +1077,131 @@ their visual representation if the @accel_closure is theirs."> - + + + + + + + + + + + + + + + + + + + + - + - + + The #GtkAccelLabel-struct struct contains private data only, and +should be accessed using the functions below. - - - + + + Creates a new #GtkAccelLabel. + + a new #GtkAccelLabel. + + the label string. Must be non-%NULL. - + c:identifier="gtk_accel_label_get_accel_widget"> + Fetches the widget monitored by this accelerator label. See +gtk_accel_label_set_accel_widget(). + + the object monitored by the accelerator label, or %NULL. + c:identifier="gtk_accel_label_get_accel_width"> + Returns the width needed to display the accelerator key(s). +This is used by menus to align all of the #GtkMenuItem widgets, and shouldn't +be needed by applications. - + the width needed to display the accelerator key(s). + - + + Recreates the string representing the accelerator keys. +This should not be needed since the string is automatically updated whenever +accelerators are added or removed from the associated widget. - + always returns %FALSE. + - - - - - + c:identifier="gtk_accel_label_set_accel_closure"> + Sets the closure to be monitored by this accelerator label. The closure +must be connected to an accelerator group; see gtk_accel_group_connect(). + the closure to monitor for accelerator changes. - + + Sets the widget to be monitored by this accelerator label. - + + + + the widget to be monitored. + + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - + + - - + + - - + + - - + + + + - + Registers a new accelerator with the global accelerator map. This function should only be called once per @accel_path with the canonical @accel_key and @accel_mods for this path. To change the accelerator during runtime programatically, use gtk_accel_map_change_entry(). -The accelerator path must consist of "&lt;WINDOWTYPE&gt;/Category1/Category2/.../Action", +The accelerator path must consist of "&lt;WINDOWTYPE&gt;/Category1/Category2/.../Action", where &lt;WINDOWTYPE&gt; should be a unique application-specific identifier, that -corresponds to the kind of window the accelerator is being used in, e.g. "Gimp-Image", -"Abiword-Document" or "Gnumeric-Settings". +corresponds to the kind of window the accelerator is being used in, e.g. "Gimp-Image", +"Abiword-Document" or "Gnumeric-Settings". The Category1/.../Action portion is most appropriately chosen by the action the -accelerator triggers, i.e. for accelerators on menu items, choose the item's menu path, -e.g. "File/Save As", "Image/View/Zoom" or "Edit/Select All". +accelerator triggers, i.e. for accelerators on menu items, choose the item's menu path, +e.g. "File/Save As", "Image/View/Zoom" or "Edit/Select All". So a full valid accelerator path may look like: -"&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...". +"&lt;Gimp-Toolbox&gt;/File/Dialogs/Tool Options...". Note that @accel_path string will be stored in a #GQuark. Therefore, if you -pass a static string, you can save some memory by interning it first with -g_intern_static_string()."> +pass a static string, you can save some memory by interning it first with +g_intern_static_string(). + valid accelerator path - + the accelerator key + + the accelerator modifiers - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a filter to the global list of accel path filters. Accel map entries whose accel path matches one of the filters are skipped by gtk_accel_map_foreach(). This function is intended for GTK+ modules that create their own -menus, but don't want them to be saved into the applications accelerator -map dump."> +menus, but don't want them to be saved into the applications accelerator +map dump. + a pattern (see #GPatternSpec) - + Changes the @accel_key and @accel_mods currently associated with @accel_path. +Due to conflicts with other accelerators, a change may not always be possible, +conflicts. A change will only occur if all conflicts could be resolved (which +might not be the case if conflicting accelerators are locked). Successful +changes are indicated by a %TRUE return value. +Note that @accel_path string will be stored in a #GQuark. Therefore, if you +pass a static string, you can save some memory by interning it first with +g_intern_static_string(). + + %TRUE if the accelerator could be changed, %FALSE otherwise + + + + + a valid accelerator path + + + + the new accelerator key + + + + the new accelerator modifiers + + + + %TRUE if other accelerators may be deleted upon conflicts + + + + + + Loops over the entries in the accelerator map whose accel path +doesn't match any of the filters added with gtk_accel_map_add_filter(), +and execute @foreach_func on each. The signature of @foreach_func is +that of #GtkAccelMapForeach, the @changed parameter indicates whether this accelerator was changed during runtime (thus, would need -saving during an accelerator map dump)."> +saving during an accelerator map dump). - + data to be passed into @foreach_func + - + + function to be executed for each accel map entry which is not filtered out - + Loops over all entries in the accelerator map, and execute +#GtkAccelMapForeach, the @changed parameter indicates whether +this accelerator was changed during runtime (thus, would need +saving during an accelerator map dump). + + + + + + data to be passed into @foreach_func + + + + function to be executed for each accel map entry + + + + + + Gets the singleton global #GtkAccelMap object. This object is useful only for notification of changes to the accelerator -map via the ::changed signal; it isn't a parameter to the -other accelerator map functions." - version="2.4"> - +map via the ::changed signal; it isn't a parameter to the +other accelerator map functions. + + the global #GtkAccelMap object - - + + Parses a file previously saved with gtk_accel_map_save() for +accelerator specifications, and propagates them accordingly. + + + + + + a file containing accelerator specifications, in the GLib file name encoding + + + + + + Filedescriptor variant of gtk_accel_map_load(). +Note that the file descriptor will not be closed by this function. + + + + + + a valid readable file descriptor + + + + + + #GScanner variant of gtk_accel_map_load(). + + + + + + a #GScanner which has already been provided with an input file + + + + + + Locks the given accelerator path. If the accelerator map doesn't yet contain +an entry for @accel_path, a new one is created. +Locking an accelerator path prevents its accelerator from being changed +during runtime. A locked accelerator path can be unlocked by +gtk_accel_map_unlock_path(). Refer to gtk_accel_map_change_entry() +for information about runtime accelerator changes. +If called more than once, @accel_path remains locked until +gtk_accel_map_unlock_path() has been called an equivalent number +of times. +Note that locking of individual accelerator paths is independent from +locking the #GtkAccelGroup containing them. For runtime accelerator +changes to be possible both the accelerator path and its #GtkAccelGroup +have to be unlocked. + - + a valid accelerator path + - - + + + + Looks up the accelerator entry for @accel_path and fills in @key. + + %TRUE if @accel_path is known, %FALSE otherwise + + + + + a valid accelerator path + - - + + the accelerator key to be filled in (optional) + + + + + + Saves current accelerator specifications (accelerator path, key +and modifiers) to @file_name. +The file is written in a format suitable to be read back in by +gtk_accel_map_load(). + + + + + + the name of the file to contain accelerator specifications, in the GLib file name encoding + + + + + + Filedescriptor variant of gtk_accel_map_save(). +Note that the file descriptor will not be closed by this function. + + + + + + a valid writable file descriptor + + + + + + Undoes the last call to gtk_accel_map_lock_path() on this @accel_path. +Refer to gtk_accel_map_lock_path() for information about accelerator path locking. + + + + + + a valid accelerator path + + + + + + Notifies of a change in the global accelerator map. +The path is also used as the detail for the signal, +so it is possible to connect to +changed::<replaceable>accel_path</replaceable>. + + + + + + the path of the accelerator that changed + + + + the key value for the new accelerator + + + + the modifier mask for the new accelerator + @@ -1560,23 +1570,24 @@ changed::<replaceable>accel_path</replaceable>." - + - + - + + + Gets the #GtkWidget corresponding to the #GtkAccessible. The returned widget +does not have a reference added, so you do not need to unref it. +the #GtkAccessible, or %NULL. + + pointer to the #GtkWidget corresponding to + + + + + Sets the #GtkWidget corresponding to the #GtkAccessible. + + + + + + a #GtkWidget + + + + - - + + - + @@ -1620,86 +1655,77 @@ changed::<replaceable>accel_path</replaceable>." - - + + - - + + - - + + - - + + + + - + Creates a new #GtkAction object. To add the action to a #GtkActionGroup and set the accelerator for the action, call gtk_action_group_add_action_with_accel(). -See <xref linkend="XML-UI"/> for information on allowed action -names." - version="2.4"> +See <xref linkend="XML-UI"/> for information on allowed action +names. + a new #GtkAction + A unique name for the action - + + the label displayed in menu items and on buttons, or %NULL - + + a tooltip for the action, or %NULL + the stock icon to display in widgets representing the action, or %NULL - - - - - - - - - - - + @@ -1709,7 +1735,34 @@ names." - + + If @action provides a #GtkMenu widget as a submenu for the menu +item or the toolbar item it creates, this function returns an +instance of that menu. + + the menu item provided by the action, or %NULL. + + + + + Creates a menu item widget that proxies for the given action. + + a menu item connected to the action. + + + + + Creates a toolbar item widget that proxies for the given action. + + a toolbar item connected to the action. + + + + @@ -1719,630 +1772,586 @@ names." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emits the "activate" signal on the specified action, if it isn't +insensitive. This gets called by the proxy widgets when they get activated. -It can also be used to manually activate an action." +It can also be used to manually activate an action. + + + + + + Disable activation signals from the action +This is needed when updating the state of your proxy +#GtkActivatable widget could result in calling gtk_action_activate(), +this is a convenience function to avoid recursing in those +cases (updating toggle state for instance). + + + + + + Installs the accelerator for @action if @action has an +accel path and group. See gtk_action_set_accel_path() and +gtk_action_set_accel_group() +Since multiple proxies may independently trigger the installation +of the accelerator, the @action counts the number of times this +function has been called and doesn't remove the accelerator until +gtk_action_disconnect_accelerator() has been called as many times. + This function is intended for use by action implementations to +create icons displayed in the proxy widgets. + a widget that displays the icon for this action. - - + + the size of the icon that should be created. + + + If @action provides a #GtkMenu widget as a submenu for the menu +item or the toolbar item it creates, this function returns an +instance of that menu. + + the menu item provided by the action, or %NULL. + + + + Creates a menu item widget that proxies for the given action. + a menu item connected to the action. + Creates a toolbar item widget that proxies for the given action. + a toolbar item connected to the action. - + + Undoes the effect of one call to gtk_action_connect_accelerator(). + + + + + + Returns the accel closure for this action. +owned by GTK+ and must not be unreffed or modified. - + the accel closure for this action. The returned closure is + + + + + Returns the accel path for this action. +if none is set. The returned string is owned by GTK+ +and must not be freed or modified. + + the accel path for this action, or %NULL + + + + + Returns whether @action<!-- -->'s menu item proxies will ignore the +#GtkSettings:gtk-menu-images setting and always show their image, +if available. + + %TRUE if the menu item proxies will always show their image + + + + + Gets the gicon of @action. + + The action's #GIcon if one is set. + + + + + Gets the icon name of @action. + + the icon name + + + + + Checks whether @action is important or not + + whether @action is important + + + + + Gets the label text of @action. + + the label text + + + + + Returns the name of the action. +be freed. + + the name of the action. The string belongs to GTK+ and should not + - + Returns the proxy widgets for an action. +See also gtk_activatable_get_related_action(). +and must not be modified. + + a #GSList of proxy widgets. The list is owned by GTK+ - + Returns whether the action itself is sensitive. Note that this doesn't +necessarily mean effective sensitivity. See gtk_action_is_sensitive() +for that. - + %TRUE if the action itself is sensitive. + - - - - - - + + Gets the short label text of @action. + the short label text. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the stock id of @action. - + the stock id + - + Gets the tooltip text of @action. - + the tooltip text + - + Returns whether the action itself is visible. Note that this doesn't +necessarily mean effective visibility. See gtk_action_is_sensitive() +for that. - + %TRUE if the action itself is visible. + + + + + Checks whether @action is visible when horizontal + + whether @action is visible when horizontal + + + + + Checks whether @action is visible when horizontal + + whether @action is visible when horizontal + + + + + Returns whether the action is effectively sensitive. +are both sensitive. + + %TRUE if the action and its associated action group + + + + + Returns whether the action is effectively visible. +are both visible. + + %TRUE if the action and its associated action group + - - - - - + Sets the #GtkAccelGroup in which the accelerator for this action +will be installed. + allow-none="1"> + a #GtkAccelGroup or %NULL - + + Sets the accel path for this action. All proxy widgets associated +with the action will have this accel path, so that their +accelerators are consistent. +Note that @accel_path string will be stored in a #GQuark. Therefore, if you +pass a static string, you can save some memory by interning it first with +g_intern_static_string(). - + + the accelerator path - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets whether @action<!-- -->'s menu item proxies will ignore the #GtkSettings:gtk-menu-images setting and always show their image, if available. Use this if the menu item would be useless or hard to use -without their image." - version="2.20"> +without their image. - + %TRUE if menuitem proxies should always show their image + - + + Sets the icon of @action. - + + + + + the #GIcon to set + + + + + + Sets the icon name on @action + + + + + + the icon name to set + + + + + + Sets whether the action is important, this attribute is used +primarily by toolbar items to decide whether to show a label +or not. + + + + + + %TRUE to make the action important + + + + + + Sets the label of @action. + + + + + + the label text to set + + + + + + Sets the ::sensitive property of the action to @sensitive. Note that +this doesn't necessarily mean effective sensitivity. See +gtk_action_is_sensitive() +for that. + + + + + + %TRUE to make the action sensitive + + + + + + Sets a shorter label text on @action. + + + + + + the label text to set + + + + + + Sets the stock id on @action + + + + + + the stock id + + + + + + Sets the tooltip text on @action + + + + + + the tooltip text + + + + + + Sets the ::visible property of the action to @visible. Note that +this doesn't necessarily mean effective visibility. See +gtk_action_is_visible() +for that. + + + + + + %TRUE to make the action visible + + + + + + Sets whether @action is visible when horizontal + + + + + + whether the action is visible horizontally + + + + + + Sets whether @action is visible when vertical + + + + + + whether the action is visible vertically + + + + + + Reenable activation signals from the action + + - - + + + If %TRUE, the action's menu item proxies will ignore the #GtkSettings:gtk-menu-images setting and always show their image, if available. Use this property if the menu item would be useless or hard to use -without their image."> - +without their image. + + The #GIcon displayed in the #GtkAction. +Note that the stock icon is preferred, if the #GtkAction:stock-id property holds the id of an existing stock icon. -This is an appearance property and thus only applies if -#GtkActivatable:use-action-appearance is %TRUE."> - +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + - - + + + The name of the icon from the icon theme. +Note that the stock icon is preferred, if the #GtkAction:stock-id property holds the id of an existing stock icon, and the #GIcon is -preferred if the #GtkAction:gicon property is set. -This is an appearance property and thus only applies if -#GtkActivatable:use-action-appearance is %TRUE."> - +preferred if the #GtkAction:gicon property is set. +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + - - + + - + The label used for menu items and buttons that activate +this action. If the label is %NULL, GTK+ uses the stock label specified via the stock-id property. -This is an appearance property and thus only applies if -#GtkActivatable:use-action-appearance is %TRUE."> - +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + - - - - - - - - + construct-only="1" + transfer-ownership="none"> + - + + + + A shorter label that may be used on toolbar buttons. +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + + + + The stock icon displayed in widgets representing this action. +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + + + + + + + + + - - - - - - - - - - + transfer-ownership="none"> + - + transfer-ownership="none"> + When %TRUE, toolitem proxies for this action are represented in the +toolbar overflow menu. + - - + + @@ -2350,11 +2359,10 @@ toolbar overflow menu."> - - - + + The "activate" signal is emitted when the action is activated. + + @@ -2365,7 +2373,7 @@ toolbar overflow menu."> - + @@ -2383,8 +2391,9 @@ toolbar overflow menu."> - + + a menu item connected to the action. @@ -2395,8 +2404,9 @@ toolbar overflow menu."> - + + a toolbar item connected to the action. @@ -2407,7 +2417,7 @@ toolbar overflow menu."> - + @@ -2422,7 +2432,7 @@ toolbar overflow menu."> - + @@ -2437,8 +2447,9 @@ toolbar overflow menu."> - + + the menu item provided by the action, or %NULL. @@ -2448,22 +2459,22 @@ toolbar overflow menu."> - - + + - - + + - - + + @@ -2471,6 +2482,8 @@ toolbar overflow menu."> + #GtkActionEntry structs are used with gtk_action_group_add_actions() to +construct actions. @@ -2491,6 +2504,7 @@ toolbar overflow menu."> + Creates a new #GtkActionGroup object. The name of the action group +is used when associating <link linkend="Action-Accel">keybindings</link> +with the actions. + the new #GtkActionGroup + the name of the action group. - - + + Looks up an action in the action group by name. + + the action, or %NULL if no action by that name exists + the name of the action - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds an action object to the action group. Note that this function does not set up the accel path of the action, which can lead to problems if a user tries to modify the accelerator of a menuitem associated with the action. Therefore you must either set the accel path yourself with -gtk_action_set_accel_path(), or use -<literal>gtk_action_group_add_action_with_accel (..., NULL)</literal>." - version="2.4"> +gtk_action_set_accel_path(), or use +<literal>gtk_action_group_add_action_with_accel (..., NULL)</literal>. + an action + Adds an action object to the action group and sets up the accelerator. +If @accelerator is %NULL, attempts to use the accelerator associated +with the stock_id of the action. +Accel paths are set to +<literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. + the action to add + allow-none="1"> + the accelerator for the action, in the format understood by gtk_accelerator_parse(), or "" for no accelerator, or %NULL to use the stock accelerator - - - - - - - - - - + This is a convenience function to create a number of actions and add them +to the action group. +The "activate" signals of the actions are connected to the callbacks and +their accel paths are set to +<literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. + an array of action descriptions - + the number of entries + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + data to pass to the action callbacks + + This variant of gtk_action_group_add_actions() adds a #GDestroyNotify +callback for @user_data. + an array of action descriptions - + the number of entries + - + data to pass to the action callbacks + - + + destroy notification callback for @user_data - + + This is a convenience routine to create a group of radio actions and +add them to the action group. +The "changed" signal of the first radio action is connected to the +<literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. - + an array of radio action descriptions + - + the number of entries + + + + the value of the action to activate initially, or -1 if no action should be activated + + + + the callback to connect to the changed signal + - - - - + data to pass to the action callbacks + + This variant of gtk_action_group_add_radio_actions() adds a +#GDestroyNotify callback for @user_data. + an array of radio action descriptions - + the number of entries + - + the value of the action to activate initially, or -1 if no action should be activated + + closure="4" + destroy="5"> + the callback to connect to the changed signal - + data to pass to the action callbacks + - + + destroy notification callback for @user_data + + This is a convenience function to create a number of toggle actions and add them +to the action group. +The "activate" signals of the actions are connected to the callbacks and +their accel paths are set to +<literal>&lt;Actions&gt;/<replaceable>group-name</replaceable>/<replaceable>action-name</replaceable></literal>. + + + + + + an array of toggle action descriptions + + + + the number of entries + + + + data to pass to the action callbacks + + + + + + This variant of gtk_action_group_add_toggle_actions() adds a +#GDestroyNotify callback for @user_data. + + + + + + an array of toggle action descriptions + + + + the number of entries + + + + data to pass to the action callbacks + + + + destroy notification callback for @user_data + + + + + + Looks up an action in the action group by name. + + the action, or %NULL if no action by that name exists + + + + + the name of the action + + + + + + Gets the name of the action group. + + the name of the action group. + + + + + Returns %TRUE if the group is sensitive. The constituent actions +can only be logically sensitive (see gtk_action_is_sensitive()) if +they are sensitive (see gtk_action_get_sensitive()) and their group +is sensitive. + + %TRUE if the group is sensitive. + + + + + Returns %TRUE if the group is visible. The constituent actions +can only be logically visible (see gtk_action_is_visible()) if +they are visible (see gtk_action_get_visible()) and their group +is visible. + + %TRUE if the group is visible. + + + + + Lists the actions in the action group. + + an allocated list of the action objects in the action group + + + + + + + Removes an action object from the action group. + + + + + + an action + + + + + + Changes the sensitivity of @action_group + + + + + + new sensitivity + + + + + Sets a function to be used for translating the @label and @tooltip of #GtkActionGroupEntry<!-- -->s added by gtk_action_group_add_actions(). -If you're using gettext(), it is enough to set the translation domain -with gtk_action_group_set_translation_domain()." - version="2.4"> +If you're using gettext(), it is enough to set the translation domain +with gtk_action_group_set_translation_domain(). @@ -2832,130 +2864,155 @@ with gtk_action_group_set_translation_domain()." + closure="1" + destroy="2"> + a #GtkTranslateFunc - + data to be passed to @func and @notify + - + + a #GDestroyNotify function to be called when @action_group is destroyed and when the translation function is changed again + Sets the translation domain and uses g_dgettext() for translating the +gtk_action_group_add_actions(). +If you're not using gettext() for localization, see +gtk_action_group_set_translate_func(). - + + the translation domain to use for g_dgettext() calls + + Changes the visible of @action_group. + + + + + + new visiblity + + + + + Translates a string using the specified translate_func(). This +is mainly intended for language bindings. + the translation of @string + a string - - + + - - + + - - + + - + - + The ::connect-proxy signal is emitted after connecting a proxy to +an action in the group. Note that the proxy may have been connected to a different action before. This is intended for simple customizations for which a custom action class would be too clumsy, e.g. showing tooltips for menuitems in the statusbar. -#GtkUIManager proxies the signal and provides global notification +#GtkUIManager proxies the signal and provides global notification just before any action is connected to a proxy, which is probably more -convenient to use." - version="2.4"> - - +convenient to use. + + - - + + the action + - - + + the proxy + - + The ::disconnect-proxy signal is emitted after disconnecting a proxy +from an action in the group. +#GtkUIManager proxies the signal and provides global notification just before any action is connected to a proxy, which is probably more -convenient to use." - version="2.4"> - - +convenient to use. + + - - + + the action + - - + + the proxy + - + The ::post-activate signal is emitted just after the @action in the This is intended for #GtkUIManager to proxy the signal and provide global -notification just after any action is activated." - version="2.4"> - - +notification just after any action is activated. + + - - + + the action + - + The ::pre-activate signal is emitted just before the @action in the This is intended for #GtkUIManager to proxy the signal and provide global -notification just before any action is activated." - version="2.4"> - - +notification just before any action is activated. + + - - + + the action + @@ -2967,8 +3024,9 @@ notification just before any action is activated." - - + + + the action, or %NULL if no action by that name exists @@ -2976,49 +3034,70 @@ notification just before any action is activated." + the name of the action - - + + - - + + - - + + - - + + - + - + + + This is called to update the activatable completely, this is called +internally when the #GtkActivatable::related-action property is set +or unset and by the implementing class when +#GtkActivatable::use-action-appearance changes. + + + + + + the related #GtkAction or %NULL + + + + @@ -3032,106 +3111,98 @@ notification just before any action is activated." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This is a utility function for #GtkActivatable implementors. When implementing #GtkActivatable you must call this when handling changes of the #GtkActivatable:related-action, and you must also use this to break references in #GObject->dispose(). This function adds a reference to the currently set related action for you, it also makes sure the #GtkActivatable->update() method is called when the related #GtkAction properties change -and registers to the action's proxy list. +and registers to the action's proxy list. <note><para>Be careful to call this before setting the local -copy of the #GtkAction property, since this function uses -gtk_activatable_get_action() to retrieve the previous action</para></note>" - version="2.16"> +copy of the #GtkAction property, since this function uses +gtk_activatable_get_action() to retrieve the previous action</para></note> + the #GtkAction to set + + + + + + Gets the related #GtkAction for @activatable. + + the related #GtkAction if one is set. + + + + + Gets whether this activatable should reset its layout +and appearance when setting the related action or when +the action changes appearance. + + whether @activatable uses its actions appearance. + + + + + Sets the related action on the @activatable object. +<note><para>#GtkActivatable implementors need to handle the #GtkActivatable:related-action +property and call gtk_activatable_do_set_related_action() when it changes.</para></note> + + + + + + the #GtkAction to set + + + + + + Sets whether this activatable should reset its layout and appearance +when setting the related action or when the action changes appearance +<note><para>#GtkActivatable implementors need to handle the +#GtkActivatable:use-action-appearance property and call +gtk_activatable_sync_action_properties() to update @activatable +if needed.</para></note> + + + + + + whether to use the actions appearance + + + + + + This is called to update the activatable completely, this is called +internally when the #GtkActivatable::related-action property is set +or unset and by the implementing class when +#GtkActivatable::use-action-appearance changes. + + + + + + the related #GtkAction or %NULL @@ -3139,40 +3210,37 @@ gtk_activatable_get_action() to retrieve the previous action</para></no + The action that this activatable will activate and receive updates from for various states and possibly appearance. -<note><para>#GtkActivatable implementors need to handle the this property and -call gtk_activatable_do_set_related_action() when it changes.</para></note>"> - +<note><para>#GtkActivatable implementors need to handle the this property and +call gtk_activatable_do_set_related_action() when it changes.</para></note> + + Whether this activatable should reset its layout and appearance when setting the related action or when the action changes appearance. See the #GtkAction documentation directly to find which properties should be ignored by the #GtkActivatable when this property is %FALSE. <note><para>#GtkActivatable implementors need to handle this property and call gtk_activatable_sync_action_properties() on the activatable -widget when it changes.</para></note>"> - +widget when it changes.</para></note> + - + @@ -3190,8 +3258,7 @@ with a %NULL action at times</para></note>" - + @@ -3199,7 +3266,8 @@ with a %NULL action at times</para></note>" - + + the related #GtkAction or %NULL @@ -3207,33 +3275,34 @@ with a %NULL action at times</para></note>" - - + + - + - + - + - + - + - + @@ -3242,31 +3311,203 @@ with a %NULL action at times</para></note>" - - - - - - + - + - + + Sets all properties of the adjustment at once. +Use this function to avoid multiple emissions of the "changed" +signal. See gtk_adjustment_set_lower() for an alternative way +of compressing multiple emissions of "changed" into one. - + + + + the new value + + + + the new minimum value + + + + the new maximum value + + + + the new step increment + + + + the new page increment + + + + the new page size + + + + + + Retrieves the minimum value of the adjustment. + + The current minimum value of the adjustment. + + + + + Retrieves the page increment of the adjustment. + + The current page increment of the adjustment. + + + + + Retrieves the page size of the adjustment. + + The current page size of the adjustment. + + + + + Retrieves the step increment of the adjustment. + + The current step increment of the adjustment. + + + + + Retrieves the maximum value of the adjustment. + + The current maximum value of the adjustment. + + + + + Gets the current value of the adjustment. See +gtk_adjustment_set_value (). + + The current value of the adjustment. + + + + + Sets the minimum value of the adjustment. +When setting multiple adjustment properties via their individual +setters, multiple "changed" signals will be emitted. However, since +the emission of the "changed" signal is tied to the emission of the +"GObject::notify" signals of the changed properties, it's possible +to compress the "changed" signals into one by calling +g_object_freeze_notify() and g_object_thaw_notify() around the +calls to the individual setters. +Alternatively, using a single g_object_set() for all the properties +to change, or using gtk_adjustment_configure() has the same effect +of compressing "changed" emissions. + + + + + + the new minimum value + + + + + + Sets the page increment of the adjustment. +See gtk_adjustment_set_lower() about how to compress multiple +emissions of the "changed" signal when setting multiple adjustment +properties. + + + + + + the new page increment + + + + + + Sets the page size of the adjustment. +See gtk_adjustment_set_lower() about how to compress multiple +emissions of the "changed" signal when setting multiple adjustment +properties. + + + + + + the new page size + + + + + + Sets the step increment of the adjustment. +See gtk_adjustment_set_lower() about how to compress multiple +emissions of the "changed" signal when setting multiple adjustment +properties. + + + + + + the new step increment + + + + + + Sets the maximum value of the adjustment. +Note that values will be restricted by +<literal>upper - page-size</literal> if the page-size +property is nonzero. +See gtk_adjustment_set_lower() about how to compress multiple +emissions of the "changed" signal when setting multiple adjustment +properties. + + + + + + the new maximum value + + + @@ -3274,242 +3515,92 @@ gtk_adjustment_set_value ()."> - + - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + transfer-ownership="none"> + The minimum value of the adjustment. + - + transfer-ownership="none"> + The page increment of the adjustment. + + The page size of the adjustment. Note that the page-size is irrelevant and should be set to zero -if the adjustment is used for a simple scalar value, e.g. in a -#GtkSpinButton."> - +if the adjustment is used for a simple scalar value, e.g. in a +#GtkSpinButton. + - + transfer-ownership="none"> + The step increment of the adjustment. + - + transfer-ownership="none"> + The maximum value of the adjustment. +Note that values will be restricted by +<literal>upper - page-size</literal> if the page-size +property is nonzero. + - + transfer-ownership="none"> + The value of the adjustment. + - + - + - + - + - + - + - - + + - - + + @@ -3520,7 +3611,7 @@ property is nonzero."> - + @@ -3532,7 +3623,7 @@ property is nonzero."> - + @@ -3543,36 +3634,70 @@ property is nonzero."> - - + + - - + + - - + + - - + + + + no meaningful way to stretch +or bottom +or top +allocation +Controls how a widget deals with extra space in a single (x or y) +dimension. +Alignment only matters if the widget receives a "too large" +allocation, for example if you packed the widget with the "expand" +flag inside a #GtkBox, then the widget might get extra space. If +you have for example a 16x16 icon inside a 32x32 space, the icon +could be scaled and stretched, it could be centered, or it could be +positioned to one side of the space. + + + + + glib:type-struct="AlignmentClass"> + - - + Creates a new #GtkAlignment. + + the new #GtkAlignment. + - + the horizontal alignment of the child widget, from 0 (left) to 1 (right). + - + the vertical alignment of the child widget, from 0 (top) to 1 (bottom). + - + the amount that the child widget expands horizontally to fill up unused space, from 0 to 1. A value of 0 indicates that the child widget should never expand. A value of 1 indicates that the child widget will expand to fill all of the space allocated for the #GtkAlignment. + - + the amount that the child widget expands vertically to fill up unused space, from 0 to 1. The values are similar to @xscale. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the padding on the different sides of the widget. +See gtk_alignment_set_padding (). - + transfer-ownership="none" + allow-none="1"> + location to store the padding for the top of the widget, or %NULL + - + transfer-ownership="none" + allow-none="1"> + location to store the padding for the bottom of the widget, or %NULL + - + transfer-ownership="none" + allow-none="1"> + location to store the padding for the left of the widget, or %NULL + - + transfer-ownership="none" + allow-none="1"> + location to store the padding for the right of the widget, or %NULL + + + + + + Sets the #GtkAlignment values. + + + + + + the horizontal alignment of the child widget, from 0 (left) to 1 (right). + + + + the vertical alignment of the child widget, from 0 (top) to 1 (bottom). + + + + the amount that the child widget expands horizontally to fill up unused space, from 0 to 1. A value of 0 indicates that the child widget should never expand. A value of 1 indicates that the child widget will expand to fill all of the space allocated for the #GtkAlignment. + + + + the amount that the child widget expands vertically to fill up unused space, from 0 to 1. The values are similar to @xscale. + + + + + + Sets the padding on the different sides of the widget. +The padding adds blank space to the sides of the widget. For instance, +this can be used to indent the child widget towards the right by adding +padding on the left. + + + + + + the padding at the top of the widget + + + + the padding at the bottom of the widget + + + + the padding at the left of the widget + + + + the padding at the right of the widget. + - + transfer-ownership="none"> + The padding to insert at the bottom of the widget. + - + transfer-ownership="none"> + The padding to insert at the left of the widget. + - + transfer-ownership="none"> + The padding to insert at the right of the widget. + - + transfer-ownership="none"> + The padding to insert at the top of the widget. + - - + + - - + + - - + + - - + + - - - - - - - - - - - + + - + + + + + + Create a new #GtkApplication, or if one has already been initialized +in this process, return the existing instance. This function will as +a side effect initialize the display system; see gtk_init(). +For the behavior if this application is running in another process, +see g_application_new(). + + A newly-referenced #GtkApplication + + + + + System-dependent application identifier + + + + System argument count + + + + System argument vector + + + + + + Creates a new #GtkWindow for the application. +This function calls the #GtkApplication::create_window() virtual function, +which can be overridden by sub-classes, for instance to use #GtkBuilder to +create the user interface. After creating a new #GtkWindow instance, it will +be added to the list of toplevels associated to the application. + + the newly created application #GtkWindow + + + + + Adds a window to the #GtkApplication. +If all the windows managed by #GtkApplication are closed, the +#GtkApplication will call gtk_application_quit(), and quit +the application. +If your application uses only a single toplevel window, you can +use gtk_application_get_window(). If you are using a sub-class +of #GtkApplication you should call gtk_application_create_window() +to let the #GtkApplication instance create a #GtkWindow and add +it to the list of toplevels of the application. You should call +this function only to add #GtkWindow<!-- -->s that you created +directly using gtk_window_new(). + + + + + + a toplevel window to add to @app + + + + + + Creates a new #GtkWindow for the application. +This function calls the #GtkApplication::create_window() virtual function, +which can be overridden by sub-classes, for instance to use #GtkBuilder to +create the user interface. After creating a new #GtkWindow instance, it will +be added to the list of toplevels associated to the application. + + the newly created application #GtkWindow + + + + + A simple #GtkApplication has a "default window". This window should +act as the primary user interaction point with your application. +The window returned by this function is of type #GTK_WINDOW_TYPE_TOPLEVEL +and its properties such as "title" and "icon-name" will be initialized +as appropriate for the platform. +If the user closes this window, and your application hasn't created +any other windows, the default action will be to call gtk_application_quit(). +If your application has more than one toplevel window (e.g. an +single-document-interface application with multiple open documents), +or if you are constructing your toplevel windows yourself (e.g. using +#GtkBuilder), use gtk_application_create_window() or +gtk_application_add_window() instead. + + The default #GtkWindow for this application + + + + + Retrieves the list of windows previously registered with +gtk_application_create_window() or gtk_application_add_window(). +to the list of #GtkWindow<!-- -->s registered by this application, +or %NULL. The returned #GSList is owned by the #GtkApplication +and it should not be modified or freed directly. + + A pointer + + + + + + + Request the application exit. This function invokes +g_application_quit_with_data(), which normally will +in turn cause @app to emit #GtkApplication::quit. +To control an application's quit behavior (for example, to ask for +files to be saved), connect to the #GtkApplication::quit signal +handler. + + + + + + Runs the main loop; see g_application_run(). +The default implementation for #GtkApplication uses gtk_main(). + + + + + + Set @group as this application's global action group. +This will ensure the operating system interface uses +these actions as follows: +<itemizedlist> +<listitem>In GNOME 2 this exposes the actions for scripting.</listitem> +<listitem>In GNOME 3, this function populates the application menu.</listitem> +<listitem>In Windows prior to version 7, this function does nothing.</listitem> +<listitem>In Windows 7, this function adds "Tasks" to the Jump List.</listitem> +<listitem>In Mac OS X, this function extends the Dock menu.</listitem> +</itemizedlist> +It is an error to call this function more than once. + + + + + + A #GtkActionGroup + + + + + + + + + + + + This signal is emitted when an action is activated. The action name +is passed as the first argument, but also as signal detail, so it +is possible to connect to this signal for individual actions. +See also the #GApplication::action-with-data signal which may in +turn trigger this signal. +The signal is never emitted for disabled actions. + + + + + + The name of the activated action + + + + + + This signal is emitted when a non-primary process for a given +application is invoked while your application is running; for +example, when a file browser launches your program to open a +file. The raw operating system arguments are passed in the +variant @arguments. + + + + + + + + + + + This signal is emitted when a quit is initiated. See also +the #GApplication::quit-with-data signal which may in +turn trigger this signal. +The default handler for this signal exits the mainloop of the +application. It is possible to override the default handler +by simply returning %TRUE from a callback, e.g.: +|[ +static gboolean +my_application_quit (GtkApplication *application) +{ +/&ast; if some_condition is TRUE, do not quit &ast;/ +if (some_condition) +return TRUE; +/&ast; this will cause the application to quit &ast; +return FALSE; +} +g_signal_connect (application, "quit", +G_CALLBACK (my_application_quit), +NULL); +]| +signal emission + + %TRUE if the signal has been handled, %FALSE to continue + + + + + + + + + + + + the newly created application #GtkWindow + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + This is a structure that we use to pass in typed values (and names). @@ -3801,31 +4255,31 @@ See gtk_alignment_set_padding ()." - + - + - + - + - + - + - + - + - + @@ -3834,44 +4288,20 @@ See gtk_alignment_set_padding ()." - + - + - - - - - - - + - - + Creates a new #GtkArrow widget. + + the new #GtkArrow widget. + + a valid #GtkArrowType. + a valid #GtkShadowType. + Sets the direction and style of the #GtkArrow, @arrow. + a valid #GtkArrowType. + a valid #GtkShadowType. - - + + - - + + - - - - - + + + + + - - + Create a new #GtkAspectFrame. + + the new #GtkAspectFrame. + + Label text. - + Horizontal alignment of the child within the allocation of the #GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) + - + Vertical alignment of the child within the allocation of the #GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) + - + The desired aspect ratio. + - + If %TRUE, @ratio is ignored, and the aspect ratio is taken from the requistion of the child. + + Set parameters for an existing #GtkAspectFrame. - + Horizontal alignment of the child within the allocation of the #GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) + - + Vertical alignment of the child within the allocation of the #GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) + - + The desired aspect ratio. + - + If %TRUE, @ratio is ignored, and the aspect ratio is taken from the requistion of the child. + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - + + + + - - - + + + Creates a new #GtkAssistant. + + a newly created #GtkAssistant + - - - - - - + Adds a widget to the action area of a #GtkAssistant. - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GtkWidget - - + Appends a page to the @assistant. + + the index (starting at 0) of the inserted page + + a #GtkWidget + + + + + + Erases the visited page history so the back button is not +shown on the current page, and removes the cancel button +from subsequent pages. +Use this when the information provided up to the current +page is hereafter deemed permanent and cannot be modified +or undone. For example, showing a progress page to track +a long-running, unreversible operation after the user has +clicked apply on a confirmation page. + + + + + + Returns the page number of the current page +the @assistant, if the @assistant has no pages, -1 will be returned + + The index (starting from 0) of the current page in + + + + + Returns the number of pages in the @assistant + + The number of pages in the @assistant. + + + + + Returns the child widget contained in page number @page_num. +if @page_num is out of bounds. + + The child widget, or %NULL + + + + + The index of a page in the @assistant, or -1 to get the last page; + + + + + + Gets whether @page is complete. + + %TRUE if @page is complete. + + + + + a page of @assistant + + + + + + Gets the header image for @page. +if there's no header image for the page. + + the header image for @page, or %NULL + + + + + a page of @assistant + + + + + + Gets the header image for @page. +if there's no side image for the page. + + the side image for @page, or %NULL + + + + + a page of @assistant + + + + + + Gets the title for @page. + + the title for @page. + + + + + a page of @assistant + + + + + + Gets the page type of @page. + + the page type of @page. + + + + + a page of @assistant - - + Inserts a page in the @assistant at a given position. + + the index (starting from 0) of the inserted page + + a #GtkWidget - - + + the index (starting at 0) at which to insert the page, or -1 to append the page to the @assistant + + + + + + Prepends a page to the @assistant. + + the index (starting at 0) of the inserted page + + + + + a #GtkWidget + + + + + + Removes a widget from the action area of a #GtkAssistant. + + + + + + a #GtkWidget + + + + + + Switches the page to @page_num. Note that this will only be necessary +in custom buttons, as the @assistant flow can be set with +gtk_assistant_set_forward_page_func(). + + + + + + index of the page to switch to, starting from 0. If negative, the last page will be used. If greater than the number of pages in the @assistant, nothing will be done. + + Sets the page forwarding function to be @page_func, this function will be used to determine what will be the next page when the user presses the forward button. Setting @page_func to %NULL will make the assistant -to use the default forward function, which just goes to the next visible -page." - version="2.10"> +to use the default forward function, which just goes to the next visible +page. @@ -4179,212 +4748,125 @@ page." transfer-ownership="none" allow-none="1" scope="notified" - closure="2" - destroy="3" - doc="the #GtkAssistantPageFunc, or %NULL to use the default one"> + closure="1" + destroy="2"> + the #GtkAssistantPageFunc, or %NULL to use the default one - + user data for @page_func + - + + destroy notifier for @data - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets whether @page contents are complete. This will make + a page of @assistant - + the completeness status of the page + - + Sets a header image for @page. This image is displayed in the header +area of the assistant when @page is the current page. - + + a page of @assistant + + the new header image @page + + - + Sets a header image for @page. This image is displayed in the side +area of the assistant when @page is the current page. - + + a page of @assistant + + the new header image @page + + - + Sets a title for @page. The title is displayed in the header +area of the assistant when @page is the current page. - + + a page of @assistant + + the new title for @page + + + + + + Sets the page type for @page. The page type determines the page +behavior in the @assistant. + + + + + + a page of @assistant + + + + the new type for @page + + + Forces @assistant to recompute the buttons state. +GTK+ automatically takes care of this in most situations, e.g. when the user goes to a different page, or when the visibility or completeness of a page changes. One situation where it can be necessary to call this function is when changing a value on the current page -affects the future page flow of the assistant." - version="2.10"> +affects the future page flow of the assistant. @@ -4392,68 +4874,47 @@ affects the future page flow of the assistant." - - - - - - - - - - - - - - - - - - - + The ::apply signal is emitted when the apply button is clicked. The default behavior of the #GtkAssistant is to switch to the page after the current page, unless the current page is the last one. A handler for the ::apply signal should carry out the actions for which the wizard has collected data. If the action takes a long time to complete, -you might consider to put a page of type %GTK_ASSISTANT_PAGE_PROGRESS +you might consider putting a page of type %GTK_ASSISTANT_PAGE_PROGRESS after the confirmation page and handle this operation within the -#GtkAssistant::prepare signal of the progress page." - version="2.10"> - - +#GtkAssistant::prepare signal of the progress page. + + - - - + + The ::cancel signal is emitted when then the cancel button is clicked. + + - + The ::close signal is emitted either when the close button of a summary page is clicked, or when the apply button in the last -page in the flow (of type %GTK_ASSISTANT_PAGE_CONFIRM) is clicked." - version="2.10"> - - +page in the flow (of type %GTK_ASSISTANT_PAGE_CONFIRM) is clicked. + + - + The ::prepare signal is emitted when a new page is set as the assistant's current page, before making the new page visible. A handler for this signal -can do any preparation which are necessary before showing @page." - version="2.10"> - - +can do any preparation which are necessary before showing @page. + + - - + + the current page + @@ -4465,7 +4926,7 @@ can do any preparation which are necessary before showing @page." - + @@ -4480,7 +4941,7 @@ can do any preparation which are necessary before showing @page." - + @@ -4492,7 +4953,7 @@ can do any preparation which are necessary before showing @page." - + @@ -4504,7 +4965,7 @@ can do any preparation which are necessary before showing @page." - + @@ -4515,36 +4976,36 @@ can do any preparation which are necessary before showing @page." - - + + - - + + - - + + - - + + - - + + @@ -4552,15 +5013,22 @@ can do any preparation which are necessary before showing @page." + A function used by gtk_assistant_set_forward_page_func() to know which +is the next page given a current one. It's called both for computing the +next page when the user presses the "forward" button and for handling +the behavior of the "last" button. - + The next page number. + - + The page number used to calculate the next page. + - + user data. + @@ -4568,6 +5036,11 @@ can do any preparation which are necessary before showing @page." glib:type-name="GtkAssistantPageType" glib:get-type="gtk_assistant_page_type_get_type" c:type="GtkAssistantPageType"> + An enum for determining the page role inside the #GtkAssistant. It's +used to handle buttons sensitivity and visibility. +Note that an assistant needs to end its page flow with a page of type +%GTK_ASSISTANT_PAGE_CONFIRM, %GTK_ASSISTANT_PAGE_SUMMARY or +%GTK_ASSISTANT_PAGE_PROGRESS to be correct. - + - - - - - + + - + + Gets the child of the #GtkBin, or %NULL if the bin contains no child widget. The returned widget does not have a reference -added, so you do not need to unref it."> - +added, so you do not need to unref it. + + pointer to child of the #GtkBin - - + + + + - + - + @@ -4662,7 +5135,7 @@ added, so you do not need to unref it."> - + @@ -4671,13 +5144,13 @@ added, so you do not need to unref it."> - + - + - + @@ -4694,16 +5167,22 @@ added, so you do not need to unref it."> - + - + + + - + + + - + + + @@ -4712,54 +5191,46 @@ added, so you do not need to unref it."> - + - - - - - - - - - - - + + Find a key binding matching @keyval and @modifiers within - + %TRUE if a binding was found and activated + - + key value of the binding + + key modifier of the binding + object to activate when binding found - + + This function is used internally by the GtkRC parsing mechanism to +assign match patterns to #GtkBindingSet structures. + path type the pattern applies to + the actual match pattern + binding priority @@ -4773,7 +5244,7 @@ assign match patterns to #GtkBindingSet structures."> - + @@ -4782,308 +5253,265 @@ assign match patterns to #GtkBindingSet structures."> + glib:get-type="gtk_border_get_type" + c:symbol-prefix="border"> + A struct that specifies a border around a rectangular area that can +be of different width on each side. - + - + - + - + - + + Allocates a new #GtkBorder structure and initializes its elements to zero. +freed with gtk_border_free() + a new empty #GtkBorder. The newly allocated #GtkBorder should be - + + Copies a #GtkBorder structure. + a copy of @border_. - + + Frees a #GtkBorder structure. - + + + Creates a new #GtkBox. + + a new #GtkBox. + + + + + the box' orientation. + + + + %TRUE if all children are to be given equal space allocations. + + + + the number of pixels to place by default between children. + + + + + + Returns whether the box is homogeneous (all children are the +same size). See gtk_box_set_homogeneous(). + + %TRUE if the box is homogeneous. + + + + + Gets the value set by gtk_box_set_spacing(). + + spacing between children + + + + + Adds @child to @box, packed with reference to the end of @box. +The @child is packed after (away from end of) any other child +packed with reference to the end of @box. + the #GtkWidget to be added to @box - + %TRUE if the new child is to be given extra space allocated to @box. The extra space will be divided evenly between all children of @box that use this option + - + %TRUE if space given to @child by the @expand option is actually allocated to @child, rather than just padding it. This parameter has no effect if @expand is set to %FALSE. A child is always allocated the full height of a #GtkHBox and the full width of a #GtkVBox. This option affects the other dimension + - + extra space in pixels to put between this child and its neighbors, over and above the global amount specified by #GtkBox:spacing property. If @child is a widget at one of the reference ends of @box, then @padding pixels are also put between + - + + Adds @child to @box, packed with reference to the start of @box. +The @child is packed after any other child packed with reference +to the start of @box. + the #GtkWidget to be added to @box - + %TRUE if the new child is to be given extra space allocated to + - + %TRUE if space given to @child by the @expand option is actually allocated to @child, rather than just padding it. This parameter has no effect if @expand is set to %FALSE. A child is always allocated the full height of a #GtkHBox and the full width of a #GtkVBox. This option affects the other dimension + - + extra space in pixels to put between this child and its neighbors, over and above the global amount specified by #GtkBox:spacing property. If @child is a widget at one of the reference ends of @box, then @padding pixels are also put between + - + + Obtains information about how @child is packed into @box. - + + the #GtkWidget of the child to query + + pointer to return location for #GtkBox:expand child property + + + + pointer to return location for #GtkBox:fill child property + + + + pointer to return location for #GtkBox:padding child property + + + + pointer to return location for #GtkBox:pack-type child property + + - + + Moves @child to a new @position in the list of @box children. +The list is the <structfield>children</structfield> field of +#GtkBox-struct, and contains both widgets packed #GTK_PACK_START +as well as widgets packed #GTK_PACK_END, in the order that these +widgets were added to @box. +A widget's position in the @box children list determines where +the widget is packed into @box. A child widget at some position +in the list will be packed just after all other widgets of the +same packing type that appear earlier in the list. - + + the #GtkWidget to move + + the new position for @child in the list of children of @box, starting from 0. If negative, indicates the end of the list + + - + + Sets the way @child is packed into @box. + + + + + + the #GtkWidget of the child to set + + + + the new value of the #GtkBox:expand child property + + + + the new value of the #GtkBox:fill child property + + + + the new value of the #GtkBox:padding child property + + + + the new value of the #GtkBox:pack-type child property + + + + + + Sets the #GtkBox:homogeneous property of @box, controlling +whether or not all children of @box are given equal space +in the box. - + a boolean value, %TRUE to create equal allotments, %FALSE for variable allotments + - - - - - - + + Sets the #GtkBox:spacing property of @box, which is the +number of pixels to place between children of @box. - + the number of pixels to put between children + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - @@ -5091,350 +5519,434 @@ same packing type that appear earlier in the list."> + + - - - - - - - - - - - - - - - - + + Adds a child to @buildable. @type is an optional string +describing how the child should be added. + a #GtkBuilder + child to add - + + kind of child or %NULL + + Constructs a child of @buildable with the name @name. +#GtkBuilder calls this function if a "constructor" has been +specified in the UI definition. + + the constructed child + + + + + #GtkBuilder used to construct this object + + + + name of child to construct + + + + + + This is similar to gtk_buildable_parser_finished() but is +called once for each custom tag handled by the @buildable. + + + + + + a #GtkBuilder + + + + child object or %NULL for non-child tags + + + + the name of the tag + + + + user data created in custom_tag_start + + + + + + This is called at the end of each custom element handled by +the buildable. + + + + + + #GtkBuilder used to construct this object + + + + child object or %NULL for non-child tags + + + + name of tag + + + + user data that will be passed in to parser functions + + + + + + This is called for each unknown element under &lt;child&gt;. +if it doesn't. + + %TRUE if a object has a custom implementation, %FALSE + + + + + a #GtkBuilder used to construct this object + + + + child object or %NULL for non-child tags + + + + name of tag + + + + a #GMarkupParser structure to fill in + + + + return location for user data that will be passed in to parser functions + + + + + + Get the internal child called @childname of the @buildable object. + + the internal child of the buildable object + + + + + a #GtkBuilder + + + + name of child + + + + + + Gets the name of the @buildable object. +#GtkBuilder sets the name based on the the +<link linkend="BUILDER-UI">GtkBuilder UI definition</link> +used to construct the @buildable. + + the name set with gtk_buildable_set_name() + + + + + Called when the builder finishes the parsing of a +<link linkend="BUILDER-UI">GtkBuilder UI definition</link>. +Note that this will be called once for each time +gtk_builder_add_from_file() or gtk_builder_add_from_string() +is called on a builder. + + + + + + a #GtkBuilder + + + + + invoker="set_buildable_property" + version="2.12"> + Sets the property name @name to @value on the @buildable object. + a #GtkBuilder + name of property + value of property - - - + + Sets the name of the @buildable object. + + - - - + name to set - + + Adds a child to @buildable. @type is an optional string +describing how the child should be added. - + + a #GtkBuilder + child to add + + + + kind of child or %NULL + + + + + + Constructs a child of @buildable with the name @name. +#GtkBuilder calls this function if a "constructor" has been +specified in the UI definition. + + the constructed child + + + + + #GtkBuilder used to construct this object + + + + name of child to construct + + + + + + This is similar to gtk_buildable_parser_finished() but is +called once for each custom tag handled by the @buildable. + + + + + + a #GtkBuilder + + + + child object or %NULL for non-child tags + the name of the tag + + + + user data created in custom_tag_start + + + + + + This is called at the end of each custom element handled by +the buildable. + + + + + + #GtkBuilder used to construct this object + + + + child object or %NULL for non-child tags + + + + name of tag + + + + user data that will be passed in to parser functions + + + + + + This is called for each unknown element under &lt;child&gt;. +if it doesn't. + + %TRUE if a object has a custom implementation, %FALSE + + + + + a #GtkBuilder used to construct this object + + + + child object or %NULL for non-child tags + + + + name of tag + a #GMarkupParser structure to fill in - + return location for user data that will be passed in to parser functions + - - + + + Get the internal child called @childname of the @buildable object. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the internal child of the buildable object + a #GtkBuilder - - - - - - - - - - + name of child + Gets the name of the @buildable object. +#GtkBuilder sets the name based on the the +<link linkend="BUILDER-UI">GtkBuilder UI definition</link> +used to construct the @buildable. + the name set with gtk_buildable_set_name() - + Called when the builder finishes the parsing of a +<link linkend="BUILDER-UI">GtkBuilder UI definition</link>. +Note that this will be called once for each time +gtk_builder_add_from_file() or gtk_builder_add_from_string() +is called on a builder. + a #GtkBuilder - - - - - - + Sets the property name @name to @value on the @buildable object. + a #GtkBuilder + name of property + value of property - - - + Sets the name of the @buildable object. + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + name to set @@ -5443,11 +5955,14 @@ is called on a builder." + The GtkBuildableIface interface contains method that are +necessary to allow #GtkBuilder to construct an object from +a GtkBuilder UI definition. - + @@ -5456,14 +5971,16 @@ is called on a builder." + name to set - + + the name set with gtk_buildable_set_name() @@ -5474,7 +5991,7 @@ is called on a builder." - + @@ -5483,20 +6000,22 @@ is called on a builder." + a #GtkBuilder + child to add - + + kind of child or %NULL - + @@ -5505,20 +6024,24 @@ is called on a builder." + a #GtkBuilder + name of property + value of property - + + the constructed child @@ -5526,43 +6049,51 @@ is called on a builder." + #GtkBuilder used to construct this object + name of child to construct - + - + %TRUE if a object has a custom implementation, %FALSE + + a #GtkBuilder used to construct this object - + + child object or %NULL for non-child tags + name of tag + a #GMarkupParser structure to fill in - + return location for user data that will be passed in to parser functions + - + @@ -5571,22 +6102,26 @@ is called on a builder." + #GtkBuilder used to construct this object - + + child object or %NULL for non-child tags + name of tag - + user data that will be passed in to parser functions + - + @@ -5595,22 +6130,26 @@ is called on a builder." + a #GtkBuilder - + + child object or %NULL for non-child tags + the name of the tag - + user data created in custom_tag_start + - + @@ -5619,14 +6158,16 @@ is called on a builder." + a #GtkBuilder - - + + + the internal child of the buildable object @@ -5634,9 +6175,11 @@ is called on a builder." + a #GtkBuilder + name of child @@ -5644,163 +6187,151 @@ is called on a builder." - + + Creates a new builder object. + a new #GtkBuilder object - + + Looks up a type by name, using the virtual function that +#GtkBuilder has for that purpose. This is mainly used when +implementing the #GtkBuildable interface on a type. +if no type was found + the #GType found for @type_name or #G_TYPE_INVALID + type name to lookup + Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder +UI definition</link> and merges it with the current contents of @builder. +Upon errors 0 will be returned and @error will be assigned a +#GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR +domain. - + A positive value on success, 0 if an error occurred + + the name of the file to parse + Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder +UI definition</link> and merges it with the current contents of @builder. +Upon errors 0 will be returned and @error will be assigned a +#GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain. - + A positive value on success, 0 if an error occurred + + the string to parse - + the length of @buffer (may be -1 if @buffer is nul-terminated) + + Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder +UI definition</link> building only the requested objects and merges +them with the current contents of @builder. +Upon errors 0 will be returned and @error will be assigned a +#GError from the #GTK_BUILDER_ERROR, #G_MARKUP_ERROR or #G_FILE_ERROR +domain. +<note><para> +If you are adding an object that depends on an object that is not +its child (for instance a #GtkTreeView that depends on its +#GtkTreeModel), you have to explicitely list all of them in @object_ids. +</para></note> - + A positive value on success, 0 if an error occurred + + the name of the file to parse - - - + nul-terminated array of objects to build + + Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder UI definition</link> building only the requested objects and merges -them with the current contents of @builder. +them with the current contents of @builder. Upon errors 0 will be returned and @error will be assigned a #GError from the #GTK_BUILDER_ERROR or #G_MARKUP_ERROR domain. <note><para> -If you are adding an object that depends on an object that is not +If you are adding an object that depends on an object that is not its child (for instance a #GtkTreeView that depends on its -#GtkTreeModel), you have to explicitely list all of them in @object_ids. -</para></note>" - version="2.14" - throws="1"> +#GtkTreeModel), you have to explicitely list all of them in @object_ids. +</para></note> - + A positive value on success, 0 if an error occurred + + the string to parse - + the length of @buffer (may be -1 if @buffer is nul-terminated) + + nul-terminated array of objects to build - - - - - - - - - - - - - - - - - + This method is a simpler variation of gtk_builder_connect_signals_full(). +It uses #GModule's introspective features (by opening the module %NULL) +to look at the application's symbol table. From here it tries to match the signal handler names given in the interface description with symbols in the application and connects the signals. Note that this function will not work correctly if #GModule is not @@ -5809,23 +6340,23 @@ When compiling applications for Windows, you must declare signal callbacks with #G_MODULE_EXPORT, or they will not be put in the symbol table. On Linux and Unices, this is not necessary; applications should instead be compiled with the -Wl,--export-dynamic CFLAGS, and linked against -gmodule-export-2.0." - version="2.12"> +gmodule-export-2.0. - + a pointer to a structure sent in as user data to all signals + + This function can be thought of the interpreted language binding +version of gtk_builder_connect_signals(), except that it does not +require GModule to function correctly. @@ -5833,59 +6364,96 @@ require GModule to function correctly." + closure="1"> + the function used to connect the signals - + arbitrary data that will be passed to the connection function + - + Gets the object named @name. Note that this function does not +increment the reference count of the returned object. +it could not be found in the object tree. - + the object named @name or %NULL if + - + + name of object to get + + Gets all objects that have been constructed by @builder. Note that +this function does not increment the reference counts of the returned +objects. +constructed by the #GtkBuilder instance. It should be freed by +g_slist_free() + + a newly-allocated #GSList containing all the objects + + + + + + Gets the translation domain of @builder. +by the builder object and must not be modified or freed. + the translation domain. This string is owned + Looks up a type by name, using the virtual function that #GtkBuilder has for that purpose. This is mainly used when implementing the #GtkBuildable interface on a type. -if no type was found" - version="2.12"> +if no type was found + the #GType found for @type_name or #G_TYPE_INVALID + type name to lookup + + Sets the translation domain of @builder. +See #GtkBuilder:translation-domain. + + + + + + the translation domain or %NULL + + + + + This function demarshals a value from a string. This function calls g_value_init() on the @value argument, so it need not be initialised beforehand. This function can handle char, uchar, boolean, int, uint, long, @@ -5893,51 +6461,59 @@ ulong, enum, flags, float, double, string, #GdkColor and #GtkAdjustment type values. Support for #GtkWidget type values is still to come. Upon errors %FALSE will be returned and @error will be assigned a -#GError from the #GTK_BUILDER_ERROR domain." - version="2.12" - throws="1"> +#GError from the #GTK_BUILDER_ERROR domain. - + %TRUE on success + + the #GParamSpec for the property + the string representation of the value + the #GValue to store the result in + Like gtk_builder_value_from_string(), this function demarshals +a value from a string, but takes a #GType instead of #GParamSpec. +This function calls g_value_init() on the @value argument, so it +need not be initialised beforehand. +Upon errors %FALSE will be returned and @error will be assigned a +#GError from the #GTK_BUILDER_ERROR domain. - + %TRUE on success + + the #GType of the value + the string representation of the value + the #GValue to store the result in - - + + @@ -5953,8 +6529,9 @@ Upon errors %FALSE will be returned and @error will be assigned a - + + the #GType found for @type_name or #G_TYPE_INVALID @@ -5962,62 +6539,63 @@ Upon errors %FALSE will be returned and @error will be assigned a + type name to lookup - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -6026,36 +6604,43 @@ Upon errors %FALSE will be returned and @error will be assigned a + This is the signature of a function used to connect signals. It is used by the gtk_builder_connect_signals() and gtk_builder_connect_signals_full() methods. It is mainly intended for interpreted language bindings, but could be useful where the programmer wants more control over the signal -connection process." - version="2.12"> +connection process. + a #GtkBuilder + object to connect a signal to + name of the signal + name of the handler + a #GObject, if non-%NULL, use g_signal_connect_object() + #GConnectFlags to use - + user data + @@ -6064,6 +6649,8 @@ connection process." glib:get-type="gtk_builder_error_get_type" c:type="GtkBuilderError" glib:error-quark="gtk_builder_error_quark"> + Error codes that identify various errors that can occur while using +#GtkBuilder. - + - + + - - + Creates a new #GtkButton widget. To add a child widget to the button, +use gtk_container_add(). + + The newly created #GtkButton widget. + - - - + + Creates a new #GtkButton containing the image and text from a stock item. +Some stock ids have preprocessor macros like #GTK_STOCK_OK and +#GTK_STOCK_APPLY. +If @stock_id is unknown, then it will be treated as a mnemonic +label (as for gtk_button_new_with_mnemonic()). + + a new #GtkButton + - + + the name of the stock item - - - + + Creates a #GtkButton widget with a #GtkLabel child containing the given +text. + + The newly created #GtkButton widget. + - + + The text you want the #GtkLabel to hold. + Creates a new #GtkButton containing a label. If characters in @label are preceded by an underscore, they are underlined. -If you need a literal underscore character in a label, use '__' (two -underscores). The first underlined character represents a keyboard +If you need a literal underscore character in a label, use '__' (two +underscores). The first underlined character represents a keyboard accelerator called a mnemonic. -Pressing Alt and that key activates the button."> - - +Pressing Alt and that key activates the button. + + a new #GtkButton + + The text of the button, with an underscore in front of the mnemonic character - - - - - - - - - - + Emits a #GtkButton::clicked signal to the given #GtkButton. - + + Emits a #GtkButton::enter signal to the given #GtkButton. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the alignment of the child in the button. - + return location for horizontal alignment + - + return location for vertical alignment + - + Returns the button's event window if it is realized, %NULL otherwise. +This function should be rarely needed. + + @button's event window. + + + + + Returns whether the button grabs focus when it is clicked with the mouse. +See gtk_button_set_focus_on_click(). +the mouse. + + %TRUE if the button grabs focus when it is clicked with + + + + + Gets the widget that is currenty set as the image of @button. +This may have been explicitly set by gtk_button_set_image() +or constructed by gtk_button_new_from_stock(). + + a #GtkWidget or %NULL in case there is no image + + + + + Gets the position of the image relative to the text +inside the button. + + the position + + + + + Fetches the text from the label of the button, as set by +gtk_button_set_label(). If the label text has not +been set the return value will be %NULL. This will be the +case if you create an empty button with gtk_button_new() to +use as a container. +by the widget and must not be modified or freed. + + The text of the label widget. This string is owned + + + + + Returns the current relief style of the given #GtkButton. + + The current #GtkReliefStyle + + + + + Returns whether the button label is a stock item. +select a stock item instead of being +used directly as the label text. + + %TRUE if the button label is used to + + + + + Returns whether an embedded underline in the button label indicates a +mnemonic. See gtk_button_set_use_underline (). +indicates the mnemonic accelerator keys. + + %TRUE if an embedded underline in the button label + + + + + Emits a #GtkButton::leave signal to the given #GtkButton. + + + + + + Emits a #GtkButton::pressed signal to the given #GtkButton. + + + + + + Emits a #GtkButton::released signal to the given #GtkButton. + + + + + + Sets the alignment of the child. This property has no effect unless +the child is a #GtkMisc or a #GtkAligment. - - + + the horizontal position of the child, 0.0 is left aligned, 1.0 is right aligned + - - + + the vertical position of the child, 0.0 is top aligned, 1.0 is bottom aligned + + + + + + Sets whether the button will grab focus when it is clicked with the mouse. +Making mouse clicks not grab focus is useful in places like toolbars where +you don't want the keyboard focus removed from the main area of the +application. + + + + + + whether the button grabs focus when clicked with the mouse + + Set the image of @button to the given widget. Note that +it depends on the #GtkSettings:gtk-button-images setting whether the +image will be displayed or not, you don't have to call +gtk_widget_show() on @image yourself. + a widget to set as the image for the button - - - - - + Sets the position of the image relative to the text +inside the button. + the position - - - + + Sets the text of the label of the button to @str. This text is +also used to select the stock item if gtk_button_set_use_stock() +is used. +This will also clear any previously set labels. + + + + + a string + + + - - + + Sets the relief style of the edges of the given #GtkButton widget. +Three styles exist, GTK_RELIEF_NORMAL, GTK_RELIEF_HALF, GTK_RELIEF_NONE. +The default style is, as one can guess, GTK_RELIEF_NORMAL. +<!-- FIXME: put pictures of each style --> + + + + + + The GtkReliefStyle as described above. + + + + + + If %TRUE, the label set on the button is used as a +stock id to select the stock item for the button. + + + + + + %TRUE if the button should use a stock item + + + + + + If true, an underline in the text of the button label indicates +the next character should be used for the mnemonic accelerator key. + + + + + + %TRUE if underlines in the text indicate mnemonics + + + + + + - - + + - + transfer-ownership="none"> + The position of the image relative to the text inside the button. + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + If the child of the button is a #GtkMisc or #GtkAlignment, this property +can be used to control it's horizontal alignment. 0.0 is left aligned, +1.0 is right aligned. + - + transfer-ownership="none"> + If the child of the button is a #GtkMisc or #GtkAlignment, this property +can be used to control it's vertical alignment. 0.0 is top aligned, +1.0 is bottom aligned. + @@ -6433,142 +7088,129 @@ can be used to control it's vertical alignment. 0.0 is top aligned, - + - + - + - + - + - + - + - + - + - + - + The ::activate signal on GtkButton is an action signal and +emitting it causes the button to animate press then release. Applications should never connect to this signal, but use the -#GtkButton::clicked signal."> - - +#GtkButton::clicked signal. + + - - - + + Emitted when the button has been activated (pressed and released). + + - - + Emitted when the pointer enters the button. + + - - + Emitted when the pointer leaves the button. + + - - + Emitted when the button is pressed. + + - - + Emitted when the button is released. + + - - - - - - - - - - - - + + + Creates a new #GtkButtonBox. - + a new #GtkButtonBox. + - - + + the box' orientation. + - + + Returns whether @child should appear in a secondary group of children. - + whether @child should appear in a secondary group of children. + + a child of @widget + + Retrieves the method being used to arrange the buttons in a button box. + + the method used to lay out buttons in @widget. + + + @@ -6579,90 +7221,30 @@ Applications should never connect to this signal, but use the - + - + + Changes the way buttons are arranged in their container. - - - - - + + the new layout style + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - + + + + - - + @@ -6720,7 +7300,7 @@ Applications should never connect to this signal, but use the - + @@ -6732,7 +7312,7 @@ Applications should never connect to this signal, but use the - + @@ -6744,7 +7324,7 @@ Applications should never connect to this signal, but use the - + @@ -6756,7 +7336,7 @@ Applications should never connect to this signal, but use the - + @@ -6768,7 +7348,7 @@ Applications should never connect to this signal, but use the - + @@ -6779,29 +7359,29 @@ Applications should never connect to this signal, but use the - - + + - - + + - - + + - - + + @@ -6812,6 +7392,14 @@ Applications should never connect to this signal, but use the glib:type-name="GtkButtonsType" glib:get-type="gtk_buttons_type_get_type" c:type="GtkButtonsType"> + Prebuilt sets of buttons for the dialog. If +none of these choices are appropriate, simply use %GTK_BUTTONS_NONE +then call gtk_dialog_add_buttons(). +<note> +Please note that %GTK_BUTTONS_OK, %GTK_BUTTONS_YES_NO +and %GTK_BUTTONS_OK_CANCEL are discouraged by the +<ulink url="http://library.gnome.org/devel/hig-book/stable/">GNOME HIG</ulink>. +</note> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Creates a new calendar, with the current date being selected. + + a newly #GtkCalendar widget + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Remove all visual markers. - + + Obtains the selected date from a #GtkCalendar. - - + + location to store the year number, or %NULL + + + + location to store the month number (between 0 and 11), or %NULL + + + + location to store the day number (between 1 and 31), or %NULL + + + Returns if the @day of the @calendar is already marked. + + whether the day is marked. + + + + + the day number between 1 and 31. + + + + + + Queries the height of detail cells, in rows. +See #GtkCalendar:detail-width-chars. + + The height of detail cells, in rows. + + + + + Queries the width of detail cells, in characters. +See #GtkCalendar:detail-width-chars. + + The width of detail cells, in characters. + + + - + Returns the current display options of @calendar. + + the display options. - + + Places a visual marker on a particular day. - - + + the day number to mark between 1 and 31. + - + + Selects a day from the current month. - - + + the day number between 1 and 31, or 0 to unselect the currently selected day. + - - + + + + Shifts the calendar to a different month. + + + + + + a month number between 0 and 11. + - - + + the year the month is in. + + Installs a function which provides Pango markup with detail information for each day. Examples for such details are holidays or appointments. That information is shown below each day when #GtkCalendar:show-details is set. A tooltip containing with full detail information is provided, if the entire @@ -10406,8 +7564,7 @@ text should not fit into the details area, or if #GtkCalendar:show-details is not set. The size of the details area can be restricted by setting the #GtkCalendar:detail-width-chars and #GtkCalendar:detail-height-rows -properties." - version="2.14"> +properties. @@ -10415,263 +7572,195 @@ properties." + closure="1" + destroy="2"> + a function providing details for each day. - + data to pass to @func invokations. + - + + a function for releasing @data. - - - - - - - - - - + Updates the height of detail cells. +See #GtkCalendar:detail-height-rows. - + detail height in rows. + - - - - - - - - - - - + Updates the width of detail cells. +See #GtkCalendar:detail-width-chars. + + + detail width in characters. + + + - + + Sets display options (whether to display the heading and the month +headings). + + + the display options to set + + + - + Removes the visual marker from a particular day. + + + + + + the day number to unmark between 1 and 31. + + + + + + The selected day (as a number between 1 and 31, or 0 to unselect the currently selected day). -This property gets initially set to the current day."> - +This property gets initially set to the current day. + - + transfer-ownership="none"> + Height of a detail cell, in rows. +A value of 0 allows any width. See gtk_calendar_set_detail_func(). + - + transfer-ownership="none"> + Width of a detail cell, in characters. +A value of 0 allows any width. See gtk_calendar_set_detail_func(). + - - + + The selected month (as a number between 0 and 11). +This property gets initially set to the current month. + - + transfer-ownership="none"> + Determines whether the selected month can be changed. + - + transfer-ownership="none"> + Determines whether day names are displayed. + + Determines whether details are shown directly in the widget, or if they are available only as tooltip. When this property is set days with details are -marked."> - +marked. + - + transfer-ownership="none"> + Determines whether a heading is displayed. + - + transfer-ownership="none"> + Determines whether week numbers are displayed. + - - + + The selected year. +This property gets initially set to the current year. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emitted when the user selects a day. + + - - + Emitted when the user double-clicks a day. + + - - + Emitted when the user clicks a button to change the selected month on a +calendar. + + - - + Emitted when the user switched to the next month. + + - - + Emitted when user switched to the next year. + + - - + Emitted when the user switched to the previous month. + + - - + Emitted when user switched to the previous year. + + @@ -10682,7 +7771,7 @@ This property gets initially set to the current year."> - + @@ -10694,7 +7783,7 @@ This property gets initially set to the current year."> - + @@ -10706,8 +7795,7 @@ This property gets initially set to the current year."> - + @@ -10719,7 +7807,7 @@ This property gets initially set to the current year."> - + @@ -10731,7 +7819,7 @@ This property gets initially set to the current year."> - + @@ -10743,7 +7831,7 @@ This property gets initially set to the current year."> - + @@ -10755,7 +7843,7 @@ This property gets initially set to the current year."> - + @@ -10769,40 +7857,43 @@ This property gets initially set to the current year."> + This kind of functions provide Pango markup with detail information for the specified day. Examples for such details are holidays or appointments. The function returns %NULL when no information is available. -for the specified day, or %NULL." - version="2.14"> +for the specified day, or %NULL. + Newly allocated string with Pango markup with details + a #GtkCalendar. - + the year for which details are needed. + - + the month for which details are needed. + - + the day of @month for which details are needed. + - + the data passed with gtk_calendar_set_detail_func(). + + These options can be used to influence the display and behaviour of a #GtkCalendar. - - + - + + The type of the callback functions used for e.g. iterating over +the children of a container, see gtk_container_foreach(). + the widget to operate on - + user-supplied data + + Defines a function pointer. + #GtkObject* - + #gpointer + - + #guint + + #GtkArg* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Begins editing on a @cell_editable. @event is the #GdkEvent that began +the editing process. It may be %NULL, in the instance that editing was +initiated through programatic means. - + + A #GdkEvent, or %NULL - - - - - - - - - - + c:identifier="gtk_cell_editable_editing_done"> + Emits the #GtkCellEditable::editing-done signal. + c:identifier="gtk_cell_editable_remove_widget"> + Emits the #GtkCellEditable::remove-widget signal. + + Begins editing on a @cell_editable. @event is the #GdkEvent that began +the editing process. It may be %NULL, in the instance that editing was +initiated through programatic means. + + + + + + A #GdkEvent, or %NULL + + + + - + transfer-ownership="none"> + Indicates whether editing on the cell has been canceled. + - + This signal is a sign for the cell renderer to update its value from the @cell_editable. Implementations of #GtkCellEditable are responsible for emitting this signal when they are done editing, e.g. #GtkEntry is emitting it when the user presses Enter. gtk_cell_editable_editing_done() is a convenience method -for emitting ::editing-done."> - - +for emitting #GtkCellEditable::editing-done. + + - + This signal is meant to indicate that the cell is finished editing, and the widget may now be destroyed. Implementations of #GtkCellEditable are responsible for emitting this signal when they are done editing. It must be emitted after the #GtkCellEditable::editing-done signal, -to give the cell renderer a chance to update the cell's value +to give the cell renderer a chance to update the cell's value before the widget is removed. gtk_cell_editable_remove_widget() is a convenience method -for emitting ::remove-widget."> - - +for emitting #GtkCellEditable::remove-widget. + + @@ -10996,7 +8049,7 @@ for emitting ::remove-widget."> - + @@ -11008,7 +8061,7 @@ for emitting ::remove-widget."> - + @@ -11020,7 +8073,7 @@ for emitting ::remove-widget."> - + @@ -11028,7 +8081,8 @@ for emitting ::remove-widget."> - + + A #GdkEvent, or %NULL @@ -11036,175 +8090,292 @@ for emitting ::remove-widget."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Adds an attribute mapping to the list in @cell_layout. The @column is the +column of the model to get a value from, and the @attribute is the +parameter on @cell to be set from the value. So for example if column 2 +of the model contains strings, you could have the "text" attribute of a +#GtkCellRendererText get its values from column 2. + A #GtkCellRenderer. + An attribute on the renderer. - + The column position on the model to get the attribute from. + - + + Unsets all the mappings on all renderers on @cell_layout and +removes all renderers from @cell_layout. + + + + + + Clears all existing attributes previously set with +gtk_cell_layout_set_attributes(). + A #GtkCellRenderer to clear the attribute mapping on. - + + + + Returns the cell renderers which have been added to @cell_layout. +renderers has been newly allocated and should be freed with +g_list_free() when no longer needed. + + a list of cell renderers. The list, but not the + + + + + + + Adds the @cell to the end of @cell_layout. If @expand is %FALSE, then the +divided evenly between cells for which @expand is %TRUE. +Note that reusing the same cell renderer is not supported. + + + + + + A #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @cell_layout. + + + + + + Packs the @cell into the beginning of @cell_layout. If @expand is %FALSE, +then the @cell is allocated no more space than it needs. Any unused space +is divided evenly between cells for which @expand is %TRUE. +Note that reusing the same cell renderer is not supported. + + + + + + A #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @cell_layout. + + + + + + Re-inserts @cell at @position. Note that @cell has already to be packed +into @cell_layout for this to function properly. + + + + + + A #GtkCellRenderer to reorder. + + + + New position to insert @cell at. + + + + + + Sets the #GtkCellLayoutDataFunc to use for @cell_layout. This function +is used instead of the standard attributes mapping for setting the +column value, and should set the value of @cell_layout's cell renderer(s) +as appropriate. @func may be %NULL to remove and older one. + + + + + + A #GtkCellRenderer. + + + + The #GtkCellLayoutDataFunc to use. - + The user data for @func. + - + + The destroy notification for @func_data. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds an attribute mapping to the list in @cell_layout. The @column is the +column of the model to get a value from, and the @attribute is the +parameter on @cell to be set from the value. So for example if column 2 +of the model contains strings, you could have the "text" attribute of a +#GtkCellRendererText get its values from column 2. + A #GtkCellRenderer. - - + + An attribute on the renderer. + + + + The column position on the model to get the attribute from. + - + Unsets all the mappings on all renderers on @cell_layout and +removes all renderers from @cell_layout. + + + + + + Clears all existing attributes previously set with +gtk_cell_layout_set_attributes(). + A #GtkCellRenderer to clear the attribute mapping on. - - - - + Returns the cell renderers which have been added to @cell_layout. +renderers has been newly allocated and should be freed with +g_list_free() when no longer needed. + + a list of cell renderers. The list, but not the - - - - - - + Adds the @cell to the end of @cell_layout. If @expand is %FALSE, then the +divided evenly between cells for which @expand is %TRUE. +Note that reusing the same cell renderer is not supported. + A #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @cell_layout. + + + + + + Packs the @cell into the beginning of @cell_layout. If @expand is %FALSE, +then the @cell is allocated no more space than it needs. Any unused space +is divided evenly between cells for which @expand is %TRUE. +Note that reusing the same cell renderer is not supported. + + + + + + A #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @cell_layout. + + + + + + Re-inserts @cell at @position. Note that @cell has already to be packed +into @cell_layout for this to function properly. + + + + + + A #GtkCellRenderer to reorder. + + + + New position to insert @cell at. + + + + + + Sets the attributes in list as the attributes of @cell_layout. The +attributes should be in attribute/column order, as in +gtk_cell_layout_add_attribute(). All existing attributes are removed, and +replaced with the new attributes. + + + + + + A #GtkCellRenderer. @@ -11213,89 +8384,39 @@ replaced with the new attributes." - - - - - - - - - - - - - - - - + Sets the #GtkCellLayoutDataFunc to use for @cell_layout. This function +is used instead of the standard attributes mapping for setting the +column value, and should set the value of @cell_layout's cell renderer(s) +as appropriate. @func may be %NULL to remove and older one. + A #GtkCellRenderer. + closure="2" + destroy="3"> + The #GtkCellLayoutDataFunc to use. - + The user data for @func. + - + + The destroy notification for @func_data. - - - - - - - - - - - - - - - - - - - - - - - @@ -11315,7 +8436,7 @@ into @cell_layout for this to function properly." - + @@ -11326,7 +8447,7 @@ into @cell_layout for this to function properly." - + @@ -11335,16 +8456,18 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer. - + %TRUE if @cell is to be given extra space allocated to @cell_layout. + - + @@ -11353,16 +8476,18 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer. - + %TRUE if @cell is to be given extra space allocated to @cell_layout. + - + @@ -11374,7 +8499,7 @@ into @cell_layout for this to function properly." - + @@ -11383,19 +8508,22 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer. + An attribute on the renderer. - + The column position on the model to get the attribute from. + - + @@ -11404,22 +8532,30 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer. - + + The #GtkCellLayoutDataFunc to use. - + The user data for @func. + - + + The destroy notification for @func_data. - + @@ -11428,13 +8564,14 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer to clear the attribute mapping on. - + @@ -11443,18 +8580,23 @@ into @cell_layout for this to function properly." + A #GtkCellRenderer to reorder. - + New position to insert @cell at. + - - - + + + a list of cell renderers. The list, but not the + + + @@ -11464,594 +8606,547 @@ into @cell_layout for this to function properly." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Passes an activate event to the cell renderer for possible processing. +Some cell renderers may use events; for example, #GtkCellRendererToggle +toggles when it gets a mouse click. + + %TRUE if the event was consumed/handled + + + + + a #GdkEvent + + + + widget that received the event + + + + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + + + + background area as passed to gtk_cell_renderer_render() + + + + cell area as passed to gtk_cell_renderer_render() + + + + render flags + + + + + + Obtains the width and height needed to render the cell. Used by view +widgets to determine the appropriate size for the cell_area passed to +gtk_cell_renderer_render(). If @cell_area is not %NULL, fills in the +x and y offsets (if set) of the cell relative to this location. +Please note that the values set in @width and @height, as well as those +in @x_offset and @y_offset are inclusive of the xpad and ypad properties. + the widget the renderer is rendering to - + + The area a cell will be allocated, or %NULL - - + + location to return x offset of cell relative to @cell_area, or %NULL + - - + + location to return y offset of cell relative to @cell_area, or %NULL + - - + + location to return width needed to render a cell, or %NULL + - - + + location to return height needed to render a cell, or %NULL + + Invokes the virtual render function of the #GtkCellRenderer. The three +passed-in rectangles are areas of @window. Most renderers will draw within +should be honored with respect to @cell_area. @background_area includes the +blank space around the cell, and also the area containing the tree expander; +so the @background_area rectangles for all cells tile to cover the entire + a #GdkDrawable to draw to + the widget owning @window + entire cell area (including tree expanders and maybe padding on the sides) + area normally rendered by a cell renderer + area that actually needs updating - - - - - - - - - - - - - - - - - - - - - - - - - + flags that affect rendering + Passes an activate event to the cell renderer for possible processing. + A new #GtkCellEditable, or %NULL + a #GdkEvent + widget that received the event + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + background area as passed to gtk_cell_renderer_render() + cell area as passed to gtk_cell_renderer_render() + render flags - + + Passes an activate event to the cell renderer for possible processing. +Some cell renderers may use events; for example, #GtkCellRendererToggle +toggles when it gets a mouse click. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the event was consumed/handled + + a #GdkEvent + widget that received the event + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + background area as passed to gtk_cell_renderer_render() + cell area as passed to gtk_cell_renderer_render() + render flags - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Fills in @xalign and @yalign with the appropriate values of @cell. - - + + location to fill in with the x alignment of the cell, or %NULL + - - + + location to fill in with the y alignment of the cell, or %NULL + - + + Fills in @width and @height with the appropriate size of @cell. - - + + location to fill in with the fixed width of the cell, or %NULL + - - + + location to fill in with the fixed height of the cell, or %NULL + + Fills in @xpad and @ypad with the appropriate values of @cell. - - + + location to fill in with the x padding of the cell, or %NULL + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + location to fill in with the y padding of the cell, or %NULL + + Returns the cell renderer's sensitivity. - + %TRUE if the cell renderer is sensitive + - + + Obtains the width and height needed to render the cell. Used by view +widgets to determine the appropriate size for the cell_area passed to +gtk_cell_renderer_render(). If @cell_area is not %NULL, fills in the +x and y offsets (if set) of the cell relative to this location. +Please note that the values set in @width and @height, as well as those +in @x_offset and @y_offset are inclusive of the xpad and ypad properties. + + + the widget the renderer is rendering to + + + + The area a cell will be allocated, or %NULL + + + + location to return x offset of cell relative to @cell_area, or %NULL + + + + location to return y offset of cell relative to @cell_area, or %NULL + + + + location to return width needed to render a cell, or %NULL + + + + location to return height needed to render a cell, or %NULL + + + + + + Returns the cell renderer's visibility. + + %TRUE if the cell renderer is visible + + + + + Invokes the virtual render function of the #GtkCellRenderer. The three +passed-in rectangles are areas of @window. Most renderers will draw within +should be honored with respect to @cell_area. @background_area includes the +blank space around the cell, and also the area containing the tree expander; +so the @background_area rectangles for all cells tile to cover the entire + + + + + + a #GdkDrawable to draw to + + + + the widget owning @window + + + + entire cell area (including tree expanders and maybe padding on the sides) + + + + area normally rendered by a cell renderer + + + + area that actually needs updating + + + + flags that affect rendering + + + + + + Sets the renderer's alignment within its available space. + + + + + + the x alignment of the cell renderer + + + + the y alignment of the cell renderer + + + + + + Sets the renderer size to be explicit, independent of the properties set. + + + + + + the width of the cell renderer, or -1 + + + + the height of the cell renderer, or -1 + + + + + + Sets the renderer's padding. + + + + + + the x padding of the cell renderer + + + + the y padding of the cell renderer + + + + + + Sets the cell renderer's sensitivity. + + + + + + the sensitivity of the cell + + + + + + Sets the cell renderer's visibility. + + + + + + the visibility of the cell + + + + + + Passes an activate event to the cell renderer for possible processing. + + A new #GtkCellEditable, or %NULL + + + + + a #GdkEvent + + + + widget that received the event + + + + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + + + + background area as passed to gtk_cell_renderer_render() + + + + cell area as passed to gtk_cell_renderer_render() + + + + render flags + + + + Informs the cell renderer that the editing is stopped. +If @canceled is %TRUE, the cell renderer will emit the +#GtkCellRenderer::editing-canceled signal. +This function should be called by cell renderer implementations +in response to the #GtkCellEditable::editing-done signal of +#GtkCellEditable. - + %TRUE if the editing has been canceled + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel -editing when the user presses Escape." - version="2.4"> - - +editing when the user presses Escape. + + - + This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on @editable, e.g. adding a #GtkEntryCompletion or setting up additional columns in a #GtkComboBox. -Note that GTK+ doesn't guarantee that cell renderers will +Note that GTK+ doesn't guarantee that cell renderers will continue to use the same kind of widget for editing in future releases, therefore you should check the type of @editable before doing any specific setup, as in the following example: @@ -12062,125 +9157,119 @@ GtkCellEditable *editable, const gchar *path, gpointer data) { -if (GTK_IS_ENTRY (editable)) +if (GTK_IS_ENTRY (editable)) { GtkEntry *entry = GTK_ENTRY (editable); /&ast; ... create a GtkEntryCompletion &ast;/ gtk_entry_set_completion (entry, completion); } } -]|" - version="2.6"> - - +]| + + - - + + the #GtkCellEditable + - - + + the path identifying the edited cell + + - - + Creates a new #GtkCellRendererAccel. + + the new cell renderer + - + transfer-ownership="none"> + The keyval of the accelerator. + + Determines if the edited accelerators are GTK+ accelerators. If they are, consumed modifiers are suppressed, only accelerators accepted by GTK+ are allowed, and the accelerators are rendered -in the same way as they are in menus."> - +in the same way as they are in menus. + - + transfer-ownership="none"> + The modifier mask of the accelerator. + + The hardware keycode of the accelerator. Note that the hardware keycode is only relevant if the key does not have a keyval. Normally, the keyboard -configuration should assign keyvals to all keys."> - +configuration should assign keyvals to all keys. + - - + + - - - - - - - - - - - - - - - - - - - - - + + Gets emitted when the user has removed the accelerator. + + - - + + the path identifying the row of the edited cell + - - - + + Gets emitted when the user has selected a new accelerator. + + - - + + the path identifying the row of the edited cell + - - + + the new accelerator keyval + - - + + the new acclerator modifier mask + - - + + the keycode of the new accelerator + @@ -12192,7 +9281,7 @@ configuration should assign keyvals to all keys."> - + @@ -12204,19 +9293,19 @@ configuration should assign keyvals to all keys."> - + - + - + @@ -12230,36 +9319,36 @@ configuration should assign keyvals to all keys."> - - + + - - + + - - + + - - + + - - + + @@ -12279,6 +9368,10 @@ configuration should assign keyvals to all keys."> c:identifier="GTK_CELL_RENDERER_ACCEL_MODE_OTHER" glib:nick="other"/> + + @@ -12286,7 +9379,7 @@ configuration should assign keyvals to all keys."> - + @@ -12295,32 +9388,40 @@ configuration should assign keyvals to all keys."> + the widget the renderer is rendering to - + + The area a cell will be allocated, or %NULL - + transfer-ownership="none" + allow-none="1"> + location to return x offset of cell relative to @cell_area, or %NULL + - + transfer-ownership="none" + allow-none="1"> + location to return y offset of cell relative to @cell_area, or %NULL + - - + + location to return width needed to render a cell, or %NULL + - - + + location to return height needed to render a cell, or %NULL + - + @@ -12329,59 +9430,73 @@ configuration should assign keyvals to all keys."> + a #GdkDrawable to draw to + the widget owning @window + entire cell area (including tree expanders and maybe padding on the sides) + area normally rendered by a cell renderer + area that actually needs updating + flags that affect rendering - + - + %TRUE if the event was consumed/handled + + a #GdkEvent + widget that received the event + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + background area as passed to gtk_cell_renderer_render() + cell area as passed to gtk_cell_renderer_render() + render flags - + + A new #GtkCellEditable, or %NULL @@ -12389,28 +9504,34 @@ configuration should assign keyvals to all keys."> + a #GdkEvent + widget that received the event + widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath + background area as passed to gtk_cell_renderer_render() + cell area as passed to gtk_cell_renderer_render() + render flags - + @@ -12422,7 +9543,7 @@ configuration should assign keyvals to all keys."> - + @@ -12439,15 +9560,15 @@ configuration should assign keyvals to all keys."> - - + + - - + + @@ -12455,66 +9576,61 @@ configuration should assign keyvals to all keys."> + - - + Creates a new #GtkCellRendererCombo. +Adjust how text is drawn using object properties. +Object properties can be set globally (with g_object_set()). +Also, with #GtkTreeViewColumn, you can bind a property to a value +in a #GtkTreeModel. For example, you can bind the "text" property +on the cell renderer to a string value in the model, thus rendering +a different string in each row of the #GtkTreeView. + + the new cell renderer + - - + + - + transfer-ownership="none"> + Holds a tree model containing the possible values for the combo box. +Use the text_column property to specify the column holding the values. + + Specifies the model column which holds the possible values for the +combo box. +Note that this refers to the model specified in the model property, +<emphasis>not</emphasis> the model backing the tree view to which this cell renderer is attached. -#GtkCellRendererCombo automatically adds a text cell renderer for -this column to its combo box."> - +#GtkCellRendererCombo automatically adds a text cell renderer for +this column to its combo box. + - - + + - - - - - - - - - - + This signal is emitted each time after the user selected an item in the combo box, either by using the mouse or the arrow keys. Contrary to GtkComboBox, GtkCellRendererCombo::changed is not emitted for changes made to a selected item in the entry. The argument @new_iter @@ -12523,17 +9639,18 @@ to the GtkTreeModel set via the model property on GtkCellRendererCombo. Note that as soon as you change the model displayed in the tree view, the tree view will immediately cease the editing operating. This means that you most probably want to refrain from changing the model -until the combo cell renderer emits the edited or editing_canceled signal." - version="2.14"> - - +until the combo cell renderer emits the edited or editing_canceled signal. + + - - + + a string of the path identifying the edited cell (relative to the tree view model) + - - + + the new iter selected in the combo box (relative to the combo box model) + @@ -12545,6 +9662,10 @@ until the combo cell renderer emits the edited or editing_canceled signal." + + - + + Creates a new #GtkCellRendererPixbuf. Adjust rendering parameters using object properties. Object properties can be set globally (with g_object_set()). Also, with #GtkTreeViewColumn, you can bind a property to a value in a #GtkTreeModel. For example, you -can bind the "pixbuf" property on the cell renderer to a pixbuf value +can bind the "pixbuf" property on the cell renderer to a pixbuf value in the model, thus rendering a different image in each row of the -#GtkTreeView."> - - +#GtkTreeView. + + the new cell renderer + - + transfer-ownership="none"> + Specifies whether the rendered pixbuf should be colorized +according to the #GtkCellRendererState. + + The GIcon representing the icon to display. If the icon theme is changed, the image will be updated -automatically."> - +automatically. + - + transfer-ownership="none"> + The name of the themed icon to display. +This property only has an effect if not overridden by "stock_id" +or "pixbuf" properties. + - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - + + - - + + - - + + - - + + - - + + + + + + + + - - + Creates a new #GtkCellRendererProgress. + + the new cell renderer + - - + + + Setting this to a non-negative value causes the cell renderer to +enter "activity mode", where a block bounces back and forth to indicate that some progress is made, without specifying exactly how much. -Each increment of the property causes the block to move by a little +Each increment of the property causes the block to move by a little bit. To indicate that the activity has not started yet, set the property -to zero. To indicate completion, set the property to %G_MAXINT."> - +to zero. To indicate completion, set the property to %G_MAXINT. + - + transfer-ownership="none"> + The "text" property determines the label which will be drawn +over the progress bar. Setting this property to %NULL causes the default +label to be displayed. Setting this property to an empty string causes +no label to be displayed. + + The "text-xalign" property controls the horizontal alignment of the text in the progress bar. Valid values range from 0 (left) to 1 -(right). Reserved for RTL layouts."> - +(right). Reserved for RTL layouts. + + The "text-yalign" property controls the vertical alignment of the text in the progress bar. Valid values range from 0 (top) to 1 -(bottom)."> - +(bottom). + - + transfer-ownership="none"> + The "value" property determines the percentage to which the +progress bar will be "filled in". + @@ -12752,29 +9888,29 @@ progress bar will be "filled in"."> - - + + - - + + - - + + - - + + @@ -12782,44 +9918,55 @@ progress bar will be "filled in"."> + c:type="GtkCellRendererProgressPrivate" + disguised="1"> + - - + Creates a new #GtkCellRendererSpin. + + a new #GtkCellRendererSpin + - + transfer-ownership="none"> + The adjustment that holds the value of the spinbutton. +This must be non-%NULL for the cell renderer to be editable. + - + transfer-ownership="none"> + The acceleration rate when you hold down a button. + - + transfer-ownership="none"> + The number of decimal places to display. + + + + - + + - - + + - - + + + Pulse of the spinner. Increment this value to draw the next frame of the spinner animation. Usually, you would update this value in a timeout. The #GtkSpinner widget draws one full cycle of the animation per second by default. You can learn about the number of frames used by the theme by looking at the #GtkSpinner:num-steps style property and the duration -of the cycle by looking at #GtkSpinner:cycle-duration."> - +of the cycle by looking at #GtkSpinner:cycle-duration. + - + transfer-ownership="none"> + The #GtkIconSize value that specifies the size of the rendered spinner. + - + @@ -12875,29 +10028,29 @@ of the cycle by looking at #GtkSpinner:cycle-duration."> - - + + - - + + - - + + - - + + @@ -12905,7 +10058,8 @@ of the cycle by looking at #GtkSpinner:cycle-duration."> + c:type="GtkCellRendererSpinnerPrivate" + disguised="1"> glib:nick="focused"/> - + + Creates a new #GtkCellRendererText. Adjust how text is drawn using object properties. Object properties can be set globally (with g_object_set()). Also, with #GtkTreeViewColumn, you can bind a property to a value in a #GtkTreeModel. For example, -you can bind the "text" property on the cell renderer to a string +you can bind the "text" property on the cell renderer to a string value in the model, thus rendering a different string in each row -of the #GtkTreeView"> - - +of the #GtkTreeView + + the new cell renderer + + Sets the height of a renderer to explicitly be determined by the "font" and +"y_pad" property set on it. Further changes in these properties do not affect the height, so they must be accompanied by a subsequent call to this function. Using this function is unflexible, and should really only be used if calculating the size of a cell is too slow (ie, a massive number of cells displayed). If @number_of_rows is -1, then the fixed height is unset, and -the height is determined by the properties again."> +the height is determined by the properties again. - + Number of rows of text each cell renderer is allocated, or -1 + - - + + - + transfer-ownership="none"> + Specifies how to align the lines of text with respect to each other. +Note that this property describes how to align the lines of text in +case there are several of them. The "xalign" property of #GtkCellRenderer, +on the other hand, sets the horizontal alignment of the whole text. + - - + + - - + + - - + + - - + + - - + + - - + + + Specifies the preferred place to ellipsize the string, if the cell renderer +does not have enough room to display the entire string. Setting it to %PANGO_ELLIPSIZE_NONE turns off ellipsizing. See the wrap-width property -for another way of making the text fit into a given width."> - +for another way of making the text fit into a given width. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + The desired maximum width of the cell, in characters. If this property +is set to -1, the width will be calculated automatically. +For cell renderers that ellipsize or wrap text; this property +controls the maximum reported width of the cell. The +cell should not receive any greater allocation unless it is +set to expand in its #GtkCellLayout and all of the cell's siblings +have received their natural width. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + The desired width of the cell, in characters. If this property is set to -1, the width will be calculated automatically, otherwise the cell will -request either 3 characters or the property value, whichever is greater."> - +request either 3 characters or the property value, whichever is greater. + - + transfer-ownership="none"> + Specifies how to break the string into multiple lines, if the cell +renderer does not have enough room to display the entire string. +This property has no effect unless the wrap-width property is set. + + Specifies the minimum width at which the text is wrapped. The wrap-mode property can be used to influence at what character positions the line breaks can be placed. -Setting wrap-width to -1 turns wrapping off."> - +Setting wrap-width to -1 turns wrapping off. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - + @@ -13209,7 +10344,7 @@ Setting wrap-width to -1 turns wrapping off."> - + @@ -13226,157 +10361,164 @@ Setting wrap-width to -1 turns wrapping off."> - - + + - - + + - - + + - - + + + + - + + Creates a new #GtkCellRendererToggle. Adjust rendering parameters using object properties. Object properties can be set globally (with g_object_set()). Also, with #GtkTreeViewColumn, you can bind a property to a value in a #GtkTreeModel. For example, you -can bind the "active" property on the cell renderer to a boolean value +can bind the "active" property on the cell renderer to a boolean value in the model, thus causing the check button to reflect the state of -the model."> - - +the model. + + the new cell renderer + - + + Returns whether the cell renderer is activatable. See +gtk_cell_renderer_toggle_set_activatable(). - + %TRUE if the cell renderer is activatable. + + + Returns whether the cell renderer is active. See +gtk_cell_renderer_toggle_set_active(). + + %TRUE if the cell renderer is active. + + + + + Returns whether we're rendering radio toggles rather than checkboxes. + + %TRUE if we're rendering radio toggles rather than checkboxes + + + + + Makes the cell renderer activatable. + + + + + + the value to set. + + + + + + Activates or deactivates a cell renderer. + + + + + + the value to set. + + + + + If @radio is %TRUE, the cell renderer renders a radio toggle (i.e. a toggle in a group of mutually-exclusive toggles). If %FALSE, it renders a check toggle (a standalone boolean option). This can be set globally for the cell renderer, or changed just before rendering each cell in the model (for #GtkTreeView, you set up a per-row setting using #GtkTreeViewColumn to associate model -columns with cell renderer properties)."> +columns with cell renderer properties). - + %TRUE to make the toggle look like a radio button + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - + + The ::toggled signal is emitted when the cell is toggled. + + - - + + string representation of #GtkTreePath describing the event location + @@ -13388,7 +10530,7 @@ The ::toggled signal is emitted when the cell is toggled."> - + @@ -13402,78 +10544,414 @@ The ::toggled signal is emitted when the cell is toggled."> - - + + - - + + - - + + - - + + - - - + + + + + + Retreives a renderer's natural size when rendered to @widget. + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + + + Retreives a cell renderers's minimum and natural height if it were rendered to + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + + + Gets whether the cell renderer prefers a height-for-width layout +or a width-for-height layout. + + The #GtkSizeRequestMode preferred by this renderer. + + + + + Retreives a renderer's natural size when rendered to @widget. + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + + + Retreives a cell renderers's minimum and natural width if it were rendered to + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + + + Retreives a renderer's natural size when rendered to @widget. + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + + + Retreives a cell renderers's minimum and natural height if it were rendered to + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + + + Gets whether the cell renderer prefers a height-for-width layout +or a width-for-height layout. + + The #GtkSizeRequestMode preferred by this renderer. + + + + + Retrieves the minimum and natural size of a cell taking +into account the widget's preference for height-for-width management. +If request_natural is specified, the non-contextual natural value will +be used to make the contextual request; otherwise the minimum will be used. + + + + + + the #GtkWidget this cell will be rendering to + + + + location for storing the minimum size, or %NULL + + + + location for storing the natural size, or %NULL + + + + + + Retreives a renderer's natural size when rendered to @widget. + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + + + Retreives a cell renderers's minimum and natural width if it were rendered to + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + + + + + - - + + + + The #GtkSizeRequestMode preferred by this renderer. + + + + + + + + - - + + + + + + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + - - + + + + + + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + - - + + + + + + + + + + + the #GtkWidget this cell will be rendering to + + + + location to store the minimum size, or %NULL + + + + location to store the natural size, or %NULL + + + + + + + + + + + + + + + + the #GtkWidget this cell will be rendering to + + + + the size which is available for allocation + + + + location for storing the minimum size, or %NULL + + + + location for storing the preferred size, or %NULL + + + + - - - - - - - - - - + + + Creates a new #GtkCellView widget. + + A newly created #GtkCellView widget. + - - - - - - - - - - - - + Creates a new #GtkCellView widget, adds a #GtkCellRendererText +to it, and makes it show @markup. The text can be +marked up with the <link linkend="PangoMarkupFormat">Pango text +markup language</link>. + + A newly created #GtkCellView widget. + + the text to display in the cell view - - + Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf +to it, and makes its show @pixbuf. + + A newly created #GtkCellView widget. + + the image to display in the cell view - + + Creates a new #GtkCellView widget, adds a #GtkCellRendererText +to it, and makes its show @text. + + A newly created #GtkCellView widget. + + + + + the text to display in the cell view + + + + + + Sets @minimum_size and @natural_size to the height desired by @cell_view +if it were allocated a width of @avail_size to display the model row +pointed to by @path. - - + + a #GtkTreePath + + + + available width + + + + location to store the minimum height + + + + location to store the natural height + - - - - - - + + Sets @minimum_size and @natural_size to the width desired by @cell_view +to display the model row pointed to by @path. - + + a #GtkTreePath + + location to store the minimum size + + + + location to store the natural size + + + Returns a #GtkTreePath referring to the currently +displayed row. If no row is currently displayed, +%NULL is returned. + the currently displayed row or %NULL + + Returns the model for @cell_view. If no model is used %NULL is +returned. + + a #GtkTreeModel used or %NULL + + + + version="2.6" + deprecated="Use gtk_cell_view_get_desired_width_of_row() and" + deprecated-version="3.0"> + Sets @requisition to the size needed by @cell_view to display +the model row pointed to by @path. +gtk_cell_view_get_desired_height_for_width_of_row() instead. - + %TRUE + + a #GtkTreePath + return location for the size + Sets the background color of @view. + the new background color - - - + + Sets the row of the model that is currently displayed +by the #GtkCellView. If the path is unset, then the +contents of the cellview "stick" at their last value; +this is not normally a desired result, but may be +a needed intermediate state if say, the model for +the #GtkCellView becomes temporarily empty. + + + + + a #GtkTreePath or %NULL to unset. + + + - - + + Sets the model for @cell_view. If @cell_view already has a model +set, it will remove it before setting the new model. If @model is +%NULL, then it will unset the old model. + + + + + + a #GtkTreeModel + + + + + + - - + + - - + + - - + + @@ -13660,43 +11191,28 @@ g_list_free() when no longer needed." - - - - - - - - - - - - - - - - - - + - + + - - + + - - + + @@ -13705,16 +11221,17 @@ g_list_free() when no longer needed." + Creates a new #GtkCheckButton containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores -in @label indicate the mnemonic for the check button."> - - +in @label indicate the mnemonic for the check button. + + a new #GtkCheckButton + + The text of the button, with an underscore in front of the mnemonic character @@ -13740,7 +11257,7 @@ in @label indicate the mnemonic for the check button."> - + @@ -13754,29 +11271,29 @@ in @label indicate the mnemonic for the check button."> - - + + - - + + - - + + - - + + @@ -13784,23 +11301,25 @@ in @label indicate the mnemonic for the check button."> - + + - - + + - - + + @@ -13809,16 +11328,17 @@ in @label indicate the mnemonic for the check button."> + Creates a new #GtkCheckMenuItem containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores -in @label indicate the mnemonic for the menu item."> - - +in @label indicate the mnemonic for the menu item. + + a new #GtkCheckMenuItem + + The text of the button, with an underscore in front of the mnemonic character @@ -13833,114 +11353,98 @@ in @label indicate the mnemonic for the menu item."> + + Returns whether the check menu item is active. See +gtk_check_menu_item_set_active (). + + %TRUE if the menu item is checked. + + + + + Returns whether @check_menu_item looks like a #GtkRadioMenuItem + + Whether @check_menu_item looks like a #GtkRadioMenuItem + + + + + Retrieves the value set by gtk_check_menu_item_set_inconsistent(). + + %TRUE if inconsistent + + + - + - + + Sets whether @check_menu_item is drawn like a #GtkRadioMenuItem - + + + + whether @check_menu_item is drawn like a #GtkRadioMenuItem + + + + + + If the user has selected a range of elements (such as some text or +spreadsheet cells) that are affected by a boolean setting, and the +current values in that range are inconsistent, you may want to +display the check in an "in between" state. This function turns on +"in between" display. Normally you would turn off the inconsistent +state again if the user explicitly selects a setting. This has to be +done manually, gtk_check_menu_item_set_inconsistent() only affects +visual appearance, it doesn't affect the semantics of the widget. + + + + + + %TRUE to display an "inconsistent" third state check + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - - - - - - - - - - + + - - + + @@ -13951,7 +11455,7 @@ visual appearance, it doesn't affect the semantics of the widget."> - + @@ -13963,7 +11467,7 @@ visual appearance, it doesn't affect the semantics of the widget."> - + @@ -13977,44 +11481,66 @@ visual appearance, it doesn't affect the semantics of the widget."> - - + + - - + + - - + + - - + + + + + + Returns the clipboard object for the given selection. +See gtk_clipboard_get_for_display() for complete details. +already exists, a new one will be created. Once a clipboard +object has been created, it is persistent and, since it is +owned by GTK+, must not be freed or unreffed. + + the appropriate clipboard object. If no clipboard + + + + + a #GdkAtom which identifies the clipboard to use + + + + + Returns the clipboard object for the given selection. Cut/copy/paste menu items and keyboard shortcuts should use the default clipboard, returned by passing %GDK_SELECTION_CLIPBOARD for @selection. (%GDK_NONE is supported as a synonym for GDK_SELECTION_CLIPBOARD @@ -14025,371 +11551,452 @@ conceptually copy the contents of the #GDK_SELECTION_PRIMARY clipboard to the default clipboard, i.e. they copy the selection to what the user sees as the clipboard. (Passing #GDK_NONE is the same as using <literal>gdk_atom_intern -("CLIPBOARD", FALSE)</literal>. See <ulink -url="http://www.freedesktop.org/Standards/clipboards-spec"> +("CLIPBOARD", FALSE)</literal>. See <ulink +url="http://www.freedesktop.org/Standards/clipboards-spec"> http://www.freedesktop.org/Standards/clipboards-spec</ulink> -for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY" +for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY" selections under the X window system. On Win32 the #GDK_SELECTION_PRIMARY clipboard is essentially ignored.) -It's possible to have arbitrary named clipboards; if you do invent +It's possible to have arbitrary named clipboards; if you do invent new clipboards, you should prefix the selection name with an underscore (because the ICCCM requires that nonstandard atoms are underscore-prefixed), and namespace it as well. For example, -if your application called "Foo" has a special-purpose -clipboard, you might call it "_FOO_SPECIAL_CLIPBOARD". +if your application called "Foo" has a special-purpose +clipboard, you might call it "_FOO_SPECIAL_CLIPBOARD". clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent and, since it is owned by GTK+, must not be freed or -unrefd." - version="2.2"> - +unrefd. + + the appropriate clipboard object. If no + the display for which the clipboard is to be retrieved or created + a #GdkAtom which identifies the clipboard to use. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Clears the contents of the clipboard. Generally this should only be called between the time you call gtk_clipboard_set_with_owner() or gtk_clipboard_set_with_data(), and when the @clear_func you supplied is called. Otherwise, the -clipboard may be owned by someone else."> +clipboard may be owned by someone else. - + + Gets the #GdkDisplay associated with @clipboard - + the #GdkDisplay associated with @clipboard + - - - - - - - - - + + If the clipboard contents callbacks were set with +gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or +gtk_clipboard_clear() has not subsequently called, returns the owner set +by gtk_clipboard_set_with_owner(). +otherwise %NULL. - + the owner of the clipboard, if any; + - - - - - + Requests the contents of clipboard as the given target. When the results of the result are later received the supplied callback -will be called."> +will be called. + an atom representing the form into which the clipboard owner should convert the selection. + scope="async" + closure="2"> + A function to call when the results are received (or the retrieval fails). If the retrieval fails the length field of - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + user data to pass to @callback + + Requests the contents of the clipboard as image. When the image is later received, it will be converted to a #GdkPixbuf, and The @pixbuf parameter to @callback will contain the resulting #GdkPixbuf if the request succeeded, or %NULL if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be -converted into an image." - version="2.6"> +converted into an image. + scope="async" + closure="1"> + a function to call when the image is received, or the retrieval fails. (It will always be called one way or the other.) - + user data to pass to @callback. + - + + Requests the contents of the clipboard as rich text. When the rich +text is later received, @callback will be called. +The @text parameter to @callback will contain the resulting rich +text if the request succeeded, or %NULL if it failed. The @length +parameter will contain @text's length. This function can fail for +various reasons, in particular if the clipboard was empty or if the +contents of the clipboard could not be converted into rich text form. + + a #GtkTextBuffer + + - + a function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.) + - + user data to pass to @callback. + + Requests the contents of the clipboard as list of supported targets. When the list is later received, @callback will be called. The @targets parameter to @callback will contain the resulting targets if -the request succeeded, or %NULL if it failed." - version="2.4"> +the request succeeded, or %NULL if it failed. + scope="async" + closure="1"> + a function to call when the targets are received, or the retrieval fails. (It will always be called one way or the other.) - + user data to pass to @callback. + + + Requests the contents of the clipboard as text. When the text is +later received, it will be converted to UTF-8 if necessary, and +The @text parameter to @callback will contain the resulting text if +the request succeeded, or %NULL if it failed. This could happen for +various reasons, in particular if the clipboard was empty or if the +contents of the clipboard could not be converted into text form. + + + + + + a function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.) + + + + user data to pass to @callback. + + + + + + Requests the contents of the clipboard as URIs. When the URIs are +later received @callback will be called. +The @uris parameter to @callback will contain the resulting array of +URIs if the request succeeded, or %NULL if it failed. This could happen +for various reasons, in particular if the clipboard was empty or if the +contents of the clipboard could not be converted into URI form. + + + + + + a function to call when the URIs are received, or the retrieval fails. (It will always be called one way or the other.) + + + + user data to pass to @callback. + + + + + + Hints that the clipboard data should be stored somewhere when the +application exits or when gtk_clipboard_store () is called. +This value is reset when the clipboard owner changes. +Where the clipboard data is stored is platform dependent, +see gdk_display_store_clipboard () for more information. + + + + + + array containing information about which forms should be stored or %NULL to indicate that all forms should be stored. + + + + number of elements in @targets + + + + + + Sets the contents of the clipboard to the given #GdkPixbuf. +GTK+ will take responsibility for responding for requests +for the image, and for converting the image into the +requested format. + + + + + + a #GdkPixbuf + + + + + + Sets the contents of the clipboard to the given UTF-8 string. GTK+ will +make a copy of the text and take responsibility for responding +for requests for the text, and for converting the text into +the requested format. + + + + + + a UTF-8 string. + + + + length of @text, in bytes, or -1, in which case the length will be determined with <function>strlen()</function>. + + + + + + Virtually sets the contents of the specified clipboard by providing +a list of supported formats for the clipboard data and a function +to call to get the actual data when it is requested. +If setting the clipboard data failed the provided callback +functions will be ignored. + + %TRUE if setting the clipboard data succeeded. + + + + + array containing information about the available forms for the clipboard data + + + + number of elements in @targets + + + + function to call to get the actual clipboard data + + + + when the clipboard contents are set again, this function will be called, and @get_func will not be subsequently called. + + + + user data to pass to @get_func and @clear_func. + + + + + + Virtually sets the contents of the specified clipboard by providing +a list of supported formats for the clipboard data and a function +to call to get the actual data when it is requested. +The difference between this function and gtk_clipboard_set_with_data() +is that instead of an generic @user_data pointer, a #GObject is passed +in. +If setting the clipboard data failed the provided callback +functions will be ignored. + + %TRUE if setting the clipboard data succeeded. + + + + + array containing information about the available forms for the clipboard data + + + + number of elements in @targets + + + + function to call to get the actual clipboard data + + + + when the clipboard contents are set again, this function will be called, and @get_func will not be subsequently called + + + + an object that "owns" the data. This object will be passed to the callbacks when called + + + + + + Stores the current clipboard data somewhere so that it will stay +around after the application has quit. + + + + + Requests the contents of the clipboard using the given target. +This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. if retrieving the given target failed. If non-%NULL, -this value must be freed with gtk_selection_data_free() -when you are finished with it."> +this value must be freed with gtk_selection_data_free() +when you are finished with it. + a newly-allocated #GtkSelectionData object or %NULL + an atom representing the form into which the clipboard owner should convert the selection. - + Requests the contents of the clipboard as image and converts +the result to a #GdkPixbuf. This function waits for +the data to be received using the main loop, so events, +timeouts, etc, may be dispatched during the wait. +object which must be disposed with g_object_unref(), or +%NULL if retrieving the selection data failed. (This could +happen for various reasons, in particular if the clipboard +was empty or if the contents of the clipboard could not be +converted into an image.) + + a newly-allocated #GdkPixbuf + + + + + Requests the contents of the clipboard as rich text. This function +waits for the data to be received using the main loop, so events, +timeouts, etc, may be dispatched during the wait. +be freed with g_free(), or %NULL if retrieving +the selection data failed. (This could happen +for various reasons, in particular if the +clipboard was empty or if the contents of the +clipboard could not be converted into text form.) + + a newly-allocated binary block of data which must + + + + + a #GtkTextBuffer + + + + return location for the format of the returned data + + + + return location for the length of the returned data + + + + + + + + + + + + + + + + + + + Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. @@ -14397,58 +12004,16 @@ be freed with g_free(), or %NULL if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the -clipboard could not be converted into text form.)"> +clipboard could not be converted into text form.) + a newly-allocated UTF-8 string which must - - - - - - - - - - - - - - - - - - - - - - - + Requests the contents of the clipboard as URIs. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. %NULL-terminated array of strings which must @@ -14456,152 +12021,113 @@ be freed with g_strfreev(), or %NULL if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of -the clipboard could not be converted into URI form.)" - version="2.14"> - +the clipboard could not be converted into URI form.) + + a newly-allocated - - - - - - - - - - - - - - + Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking -if it contains any of the supported text targets. This function -waits for the data to be received using the main loop, so events, +if it contains any of the supported image targets. This function +waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. This function is a little faster than calling -gtk_clipboard_wait_for_text() since it doesn't need to retrieve -the actual text."> +gtk_clipboard_wait_for_image() since it doesn't need to retrieve +the actual image data. - + %TRUE is there is an image available, %FALSE otherwise. + + Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. This function is a little faster than calling -gtk_clipboard_wait_for_rich_text() since it doesn't need to retrieve -the actual text." - version="2.10"> +gtk_clipboard_wait_for_rich_text() since it doesn't need to retrieve +the actual text. - + %TRUE is there is rich text available, %FALSE otherwise. + + a #GtkTextBuffer - - - - - - - - - - + Checks if a clipboard supports pasting data of a given type. This +function can be used to determine if a "Paste" menu item should be +insensitive or not. +If you want to see if there's text available on the clipboard, use +gtk_clipboard_wait_is_text_available () instead. - + %TRUE if the target is available, %FALSE otherwise. + + A #GdkAtom indicating which target to look for. - + + Test to see if there is text available to be pasted +This is done by requesting the TARGETS atom and checking +if it contains any of the supported text targets. This function +waits for the data to be received using the main loop, so events, +timeouts, etc, may be dispatched during the wait. +This function is a little faster than calling +gtk_clipboard_wait_for_text() since it doesn't need to retrieve +the actual text. - - - - - - - - - - - - - - + %TRUE is there is text available, %FALSE otherwise. + - - - + + Test to see if there is a list of URIs available to be pasted +This is done by requesting the TARGETS atom and checking +if it contains the URI targets. This function +waits for the data to be received using the main loop, so events, +timeouts, etc, may be dispatched during the wait. +This function is a little faster than calling +gtk_clipboard_wait_for_uris() since it doesn't need to retrieve +the actual URI data. + + %TRUE is there is an URI list available, %FALSE otherwise. + + + + + The ::owner-change signal is emitted when GTK+ receives an +event that indicates that the ownership of the selection +associated with @clipboard has changed. + + - - + + the @GdkEventOwnerChange event + @@ -14615,7 +12141,7 @@ associated with @clipboard has changed." - + @@ -14631,10 +12157,10 @@ associated with @clipboard has changed." - + - + @@ -14651,7 +12177,7 @@ associated with @clipboard has changed." - + @@ -14667,7 +12193,7 @@ associated with @clipboard has changed." - + @@ -14684,15 +12210,13 @@ associated with @clipboard has changed." - - - + - + - + @@ -14709,10 +12233,10 @@ associated with @clipboard has changed." - + - + @@ -14729,7 +12253,7 @@ associated with @clipboard has changed." - + @@ -14743,163 +12267,178 @@ associated with @clipboard has changed." - - - + - + - + + - - + Creates a new color button. This returns a widget in the form of +a small button containing a swatch representing the current selected +color. When the button is clicked, a color-selection dialog will open, +allowing the user to select a color. The swatch will be updated to reflect +the new color when the user finishes. + + a new color button. + - - + Creates a new color button. + + a new color button. + + A #GdkColor to set the current color with. - + Returns the current alpha value. - + an integer between 0 and 65535. + - - - - - - - - - - - - - - - + Sets @color to be the current color in the #GtkColorButton widget. + a #GdkColor to fill in with the current color. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the title of the color selection dialog. + An internal string, do not free the return value + + Does the color selection dialog use the alpha channel? + + %TRUE if the color sample uses alpha channel, %FALSE if not. + + + + + Sets the current opacity to be @alpha. + + + + + + an integer between 0 and 65535. + + + + + + Sets the current color to be @color. + + + + + + A #GdkColor to set the current color with. + + + + + + Sets the title for the color selection dialog. + + + + + + String containing new window title. + + + + + + Sets whether or not the color button should use the alpha channel. + + + + + + %TRUE if color button should use alpha channel, %FALSE if not. + + + + - + transfer-ownership="none"> + The selected opacity value (0 fully transparent, 65535 fully opaque). + - + transfer-ownership="none"> + The selected color. + - + transfer-ownership="none"> + The title of the color selection dialog + - + transfer-ownership="none"> + If this property is set to %TRUE, the color swatch on the button is rendered against a +checkerboard background to show its opacity and the opacity slider is displayed in the +color selection dialog. + @@ -14907,16 +12446,15 @@ color selection dialog."> - + The ::color-set signal is emitted when the user selects a color. +When handling this signal, use gtk_color_button_get_color() and gtk_color_button_get_alpha() to find out which color was just selected. Note that this signal is only emitted when the <emphasis>user</emphasis> changes the color. If you need to react to programmatic color changes -as well, use the notify::color signal." - version="2.4"> - - +as well, use the notify::color signal. + + @@ -14927,7 +12465,7 @@ as well, use the notify::color signal." - + @@ -14938,38 +12476,41 @@ as well, use the notify::color signal." - - + + - - + + - - + + - - + + - + - - - + + + Creates a new GtkColorSelection. + + a new #GtkColorSelection + + c:identifier="gtk_color_selection_palette_from_string"> + Parses a color palette string; the string is a colon-separated +list of color names readable by gdk_color_parse(). - + %TRUE if a palette was successfully parsed. + + a string encoding a color palette. + return location for allocated array of #GdkColor. - - + + return location for length of array. + + c:identifier="gtk_color_selection_palette_to_string"> + Encodes a palette as a string, useful for persistent storage. + allocated string encoding the palette. + an array of colors. - - - - - - - - - - - + length of the array. + + Installs a global function to be called whenever the user tries to modify the palette in a color selection. This function should save the new palette contents, and update the GtkSettings property -"gtk-color-palette" so all GtkColorSelection widgets will be modified." - version="2.2"> - +"gtk-color-palette" so all GtkColorSelection widgets will be modified. + + the previous change palette hook (that was replaced). - + + a function to call when the custom palette needs saving. - + + Returns the current alpha value. - + an integer between 0 and 65535. + + + Sets @color to be the current color in the GtkColorSelection widget. + + + + + + a #GdkColor to fill in with the current color. + + + + + + Determines whether the colorsel has an opacity control. + + %TRUE if the @colorsel has an opacity control. %FALSE if it does't. + + + + + Determines whether the color selector has a color palette. + + %TRUE if the selector has a palette. %FALSE if it hasn't. + + + + + Returns the previous alpha value. + + an integer between 0 and 65535. + + + + + Fills @color in with the original color value. + + + + + + a #GdkColor to fill in with the original color value. + + + + + + Gets the current state of the @colorsel. +if the selection has stopped. + + %TRUE if the user is currently dragging a color around, and %FALSE + + + + + Sets the current opacity to be @alpha. The first time this is called, it will +also set the original opacity to be @alpha too. + + + + + + an integer between 0 and 65535. + + + + + + Sets the current color to be @color. The first time this is called, it will +also set the original color to be @color too. + + + + + + A #GdkColor to set the current color with. + + + + + c:identifier="gtk_color_selection_set_has_opacity_control"> + Sets the @colorsel to use or not use opacity. - + %TRUE if @colorsel can set the opacity, %FALSE otherwise. + - - - - - + c:identifier="gtk_color_selection_set_has_palette"> + Shows and hides the palette based upon the value of @has_palette. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if palette is to be visible, %FALSE otherwise. + + c:identifier="gtk_color_selection_set_previous_alpha"> + Sets the 'previous' alpha to be @alpha. This function should be called with +some hesitations, as it might seem confusing to have that alpha change. - + an integer between 0 and 65535. + - + + Sets the 'previous' color to be @color. This function should be called with +some hesitations, as it might seem confusing to have that color change. +Calling gtk_color_selection_set_current_color() will also set this color the first +time it is called. + a #GdkColor to set the previous color with. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - + - - + + @@ -15270,7 +12779,7 @@ also set the original color to be @color too." - + @@ -15287,7 +12796,7 @@ also set the original color to be @color too." - + @@ -15298,7 +12807,7 @@ also set the original color to be @color too." - + @@ -15309,29 +12818,29 @@ also set the original color to be @color too." - - + + - - + + - - + + - - + + @@ -15339,6 +12848,7 @@ also set the original color to be @color too." + - - + + @@ -15358,38 +12869,31 @@ also set the original color to be @color too." - + Retrieves the #GtkColorSelection widget embedded in the dialog. + + the embedded #GtkColorSelection - - + + - - + + - - + + - - + + - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + - + + Creates a new empty #GtkComboBox. + + A new #GtkComboBox. + + + + - - + Convenience function which constructs a new text combo box, which is a +#GtkComboBox just displaying strings. If you use this function to create +a text combo box, you should only manipulate its data source with the +gtk_combo_box_insert_text(), gtk_combo_box_prepend_text() and +gtk_combo_box_remove_text(). + + A new text combo box. + - - + Creates a new #GtkComboBox with the model initialized to @model. + + A new #GtkComboBox. + + A #GtkTreeModel. - - - - - - + + Returns the currently active string in @combo_box or %NULL if none +is selected. Note that you can only use this function with combo +boxes constructed with gtk_combo_box_new_text() and with +#GtkComboBoxEntry<!-- -->s. +Must be freed with g_free(). + a newly allocated string containing the currently active text. - - - - - - + Appends @string to the list of strings stored in @combo_box. Note that +you can only use this function with combo boxes constructed with +gtk_combo_box_new_text(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + A string - - - - - - - - - - - - - - - + Returns the index of the currently active item, or -1 if there's no +active item. If the model is a non-flat treemodel, and the active item +is not an immediate child of the root of the tree, this function returns +<literal>gtk_tree_path_get_indices (path)[0]</literal>, where +<literal>path</literal> is the #GtkTreePath of the active item. +or -1 if there's no active item. - + An integer which is the index of the currently active item, + + + Sets @iter to point to the current active item, if it exists. + + %TRUE, if @iter was set + + + + + The uninitialized #GtkTreeIter + + + + + + Returns the currently active string in @combo_box or %NULL if none +is selected. Note that you can only use this function with combo +boxes constructed with gtk_combo_box_new_text() and with +#GtkComboBoxEntry<!-- -->s. +Must be freed with g_free(). + + a newly allocated string containing the currently active text. + + + + + Gets the current value of the :add-tearoffs property. + + the current value of the :add-tearoffs property. + + + + + Returns whether the combo box sets the dropdown button +sensitive or not when there are no items in the model. +is sensitive when the model is empty, %GTK_SENSITIVITY_OFF +if the button is always insensitive or +%GTK_SENSITIVITY_AUTO if it is only sensitive as long as +the model has one item to be selected. + + %GTK_SENSITIVITY_ON if the dropdown button + + + + + Returns the column with column span information for @combo_box. + + the column span column. + + + + + Returns whether the combo box grabs focus when it is clicked +with the mouse. See gtk_combo_box_set_focus_on_click(). +clicked with the mouse. + + %TRUE if the combo box grabs focus when it is + + + + + Returns the #GtkTreeModel which is acting as data source for @combo_box. +during construction. + + A #GtkTreeModel which was passed + + + + + Gets the accessible object corresponding to the combo box's popup. +This function is mostly intended for use by accessibility technologies; +applications should have little use for it. +to the combo box's popup. + + the accessible object corresponding + + + + + Returns the current row separator function. + + the current row separator function. + + + + + Returns the column with row span information for @combo_box. + + the row span column. + + + + + Gets the current title of the menu in tearoff mode. See +gtk_combo_box_set_add_tearoffs(). +string which must not be freed. + + the menu's title in tearoff mode. This is an internal copy of the + + + + + Returns the wrap width which is used to determine the number of columns +for the popup menu. If the wrap width is larger than 1, the combo box +is in table mode. + + the wrap width. + + + + + Inserts @string at @position in the list of strings stored in @combo_box. +Note that you can only use this function with combo boxes constructed +with gtk_combo_box_new_text(). + + + + + + An index to insert @text + + + + A string + + + + + + Hides the menu or dropdown list of @combo_box. +This function is mostly intended for use by accessibility technologies; +applications should have little use for it. + + + + + + Pops up the menu or dropdown list of @combo_box. +This function is mostly intended for use by accessibility technologies; +applications should have little use for it. + + + + + + Pops up the menu or dropdown list of @combo_box, the popup window +will be grabbed so only @device and its associated pointer/keyboard +are the only #GdkDevice<!-- -->s able to send events to it. + + + + + + a #GdkDevice + + + + + + Prepends @string to the list of strings stored in @combo_box. Note that +you can only use this function with combo boxes constructed with +gtk_combo_box_new_text(). + + + + + + A string + + + + + + Removes the string at @position from @combo_box. Note that you can only use +this function with combo boxes constructed with gtk_combo_box_new_text(). + + + + + + Index of the item to remove + + + + + Sets the active item of @combo_box to be the item at @index. - - - - - - - - - - - + An index in the model passed during construction, or -1 to have no active item + + Sets the current active item to be the one referenced by @iter, or +unsets the active item if @iter is %NULL. - + + The #GtkTreeIter, or %NULL + + Sets whether the popup menu should have a tearoff +menu item. + + + + + + %TRUE to add tearoff menu items + + + + + + Sets whether the dropdown button of the combo box should be +always sensitive (%GTK_SENSITIVITY_ON), never sensitive (%GTK_SENSITIVITY_OFF) +or only if there is at least one item to display (%GTK_SENSITIVITY_AUTO). + + + + + + specify the sensitivity of the dropdown button + + + + + + Sets the column with column span information for @combo_box to be +how many columns an item should span. + + + + + + A column in the model passed during construction + + + + + + Sets whether the combo box will grab focus when it is clicked with +the mouse. Making mouse clicks not grab focus is useful in places +like toolbars where you don't want the keyboard focus removed from +the main area of the application. + + + + + + whether the combo box grabs focus when clicked with the mouse + + + + + Sets the model used by @combo_box to be @model. Will unset a previously set +model (if applicable). If model is %NULL, then it will unset the model. +Note that this function does not clear the cell renderers, you have to +call gtk_cell_layout_clear() yourself if you need to set up different +cell renderers for the new model. - + + A #GtkTreeModel - - - - - - - - - - + Sets the row separator function, which is used to determine +whether a row should be drawn as a separator. If the row separator +function is %NULL, no separators are drawn. This is the default value. @@ -15871,240 +13374,161 @@ function is %NULL, no separators are drawn. This is the default value." + closure="1" + destroy="2"> + a #GtkTreeViewRowSeparatorFunc - - + + user data to pass to @func, or %NULL + + scope="async"> + destroy notifier for @data, or %NULL - + + Sets the column with row span information for @combo_box to be @row_span. +The row span column contains integers which indicate how many rows +an item should span. - - + + A column in the model passed during construction. + - - - - - - + + Sets the menu's title in tearoff mode. - + + a title for the menu in tearoff mode - + Sets the wrap width of @combo_box to be @width. The wrap width is basically +the preferred number of columns when you want the popup to be layed out +in a table. - - - - - + + Preferred number of columns + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The item which is currently active. If the model is a non-flat treemodel, and the active item is not an immediate child of the root of the tree, -this property has the value +this property has the value <literal>gtk_tree_path_get_indices (path)[0]</literal>, -where <literal>path</literal> is the #GtkTreePath of the active item."> - +where <literal>path</literal> is the #GtkTreePath of the active item. + - + transfer-ownership="none"> + The add-tearoffs property controls whether generated menus +have tearoff menu items. +Note that this only affects menu style combo boxes. + - + transfer-ownership="none"> + Whether the dropdown button is sensitive when +the model is empty. + - + transfer-ownership="none"> + If this is set to a non-negative value, it must be the index of a column +of type %G_TYPE_INT in the model. +The values of that column are used to determine how many columns a value +in the list will span. + - - + + - + transfer-ownership="none"> + The has-frame property controls whether a frame +is drawn around the entry. + - + transfer-ownership="none"> + The model from which the combo box takes the values shown +in the list. + - + Whether the combo boxes dropdown is popped up. Note that this property is mainly useful, because -it allows you to connect to notify::popup-shown."> - +it allows you to connect to notify::popup-shown. + - + transfer-ownership="none"> + If this is set to a non-negative value, it must be the index of a column +of type %G_TYPE_INT in the model. +The values of that column are used to determine how many rows a value in +the list will span. Therefore, the values in the model column pointed to +by this property must be greater than zero and not larger than wrap-width. + - + transfer-ownership="none"> + A title that may be displayed by the window manager +when the popup is torn-off. + + If wrap-width is set to a positive value, the list will be displayed in multiple columns, the number of columns is -determined by wrap-width."> - +determined by wrap-width. + @@ -16112,50 +13536,47 @@ determined by wrap-width."> - + The changed signal is emitted when the active item is changed. The can be due to the user selecting -a different item from the list, or due to a +a different item from the list, or due to a call to gtk_combo_box_set_active_iter(). -It will also be emitted while typing into a GtkComboBoxEntry, -as well as when selecting an item from the GtkComboBoxEntry's list." - version="2.4"> - - +It will also be emitted while typing into a GtkComboBoxEntry, +as well as when selecting an item from the GtkComboBoxEntry's list. + + - - - + + The ::move-active signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to move the active selection. + + - - + + a #GtkScrollType + - + The ::popdown signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to popdown the combo box list. -The default bindings for this signal are Alt+Up and Escape." - version="2.12"> - - +The default bindings for this signal are Alt+Up and Escape. + + - + The ::popup signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to popup the combo box list. -The default binding for this signal is Alt+Down." - version="2.12"> - - +The default binding for this signal is Alt+Down. + + @@ -16166,7 +13587,7 @@ The default binding for this signal is Alt+Down." - + @@ -16178,8 +13599,9 @@ The default binding for this signal is Alt+Down." - + + a newly allocated string containing the currently active text. @@ -16189,22 +13611,22 @@ The default binding for this signal is Alt+Down." - - + + - - + + - - + + @@ -16212,6 +13634,7 @@ The default binding for this signal is Alt+Down." + - - + Creates a new #GtkComboBoxEntry which has a #GtkEntry as child. After +construction, you should set a model using gtk_combo_box_set_model() and a +text column using gtk_combo_box_entry_set_text_column(). + + A new #GtkComboBoxEntry. + + + + + Convenience function which constructs a new editable text combo box, which +is a #GtkComboBoxEntry just displaying strings. If you use this function to +create a text combo box, you should only manipulate its data source with +gtk_combo_box_insert_text(), gtk_combo_box_prepend_text() and +gtk_combo_box_remove_text(). + + A new text #GtkComboBoxEntry. + + Creates a new #GtkComboBoxEntry which has a #GtkEntry as child and a list of strings as popup. You can get the #GtkEntry from a #GtkComboBoxEntry using GTK_ENTRY (GTK_BIN (combo_box_entry)->child). To add and remove strings from the list, just modify @model using its data manipulation -API." - version="2.4"> - - +API. + + A new #GtkComboBoxEntry. + + A #GtkTreeModel. - + A column in @model to get the strings from. + - - - + + Returns the column which @entry_box is using to get the strings from. + + A column in the data source model of @entry_box. + - + + Sets the model column which @entry_box should use to get strings from +to be @text_column. - + A column in @model to get the strings from. + - - - - - - - + + @@ -16301,75 +13732,43 @@ to be @text_column." - - + + - - + + - - + + - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Returns the type of the children supported by the container. +Note that this may return %G_TYPE_NONE to indicate that no more +children can be added, e.g. for a #GtkPaned which already has two +children. + a #GType. @@ -16444,22 +13798,19 @@ Returns all child properties of a container class."> - + - - + + - - + + - - - - - + + @@ -16472,7 +13823,7 @@ Returns all child properties of a container class."> - + @@ -16482,361 +13833,86 @@ Returns all child properties of a container class."> - + - - + + + + + + + + + + + - - - - - - - + Adds @widget to @container. Typically used for simple containers such as #GtkWindow, #GtkFrame, or #GtkButton; for more complicated layout containers such as #GtkBox or #GtkTable, this function will pick default packing parameters that may not be correct. So consider functions such as gtk_box_pack_start() and gtk_table_attach() as an alternative to gtk_container_add() in those cases. A widget may be added to only one container at a time; -you can't place the same widget inside two different containers."> +you can't place the same widget inside two different containers. + a widget to be placed inside @container - + + Adds @widget to @container, setting child properties at the same time. +See gtk_container_add() and gtk_container_child_set() for more details. + a widget to be placed inside @container - - - - - - - - - + + the name of the first child property to set + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the values of one or more child properties for @child and @container. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a widget which is a child of @container + the name of the first property to get @@ -16845,38 +13921,63 @@ See gtk_container_add() and gtk_container_child_set() for more details."> + + Gets the value of a child property for @child and @container. + + + + + + a widget which is a child of @container + + + + the name of the property to get + + + + a location to return the value + + + + + + Gets the values of one or more child properties for @child and @container. + + + + + + a widget which is a child of @container + + + + the name of the first property to get + + + + return location for the first property, followed optionally by more name/return location pairs, followed by %NULL + + + + - - - - - - - - - - - - - - - - - + introspectable="0"> + Sets one or more child properties for @child and @container. + a widget which is a child of @container + the name of the first property to set @@ -16886,49 +13987,86 @@ Gets the values of one or more child properties for @child and @container."> + c:identifier="gtk_container_child_set_property"> + Sets a child property for @child and @container. + a widget which is a child of @container + the name of the property to set + the value to set the property to - + + Sets one or more child properties for @child and @container. + a widget which is a child of @container - + + the name of the first property to set - - + + a %NULL-terminated list of property names and values, starting with @first_prop_name + + + Returns the type of the children supported by the container. +Note that this may return %G_TYPE_NONE to indicate that no more +children can be added, e.g. for a #GtkPaned which already has two +children. + + a #GType. + + + + Invokes @callback on each child of @container, including children +that are considered "internal" (implementation details of the +container). "Internal" children generally weren't added by the user of the container, but were added by the container implementation itself. Most applications should use gtk_container_foreach(), -rather than gtk_container_forall()."> +rather than gtk_container_forall(). + + + + + + a callback + + + + callback user data + + + + + + Invokes @callback on each non-internal child of @container. See +gtk_container_forall() for details on what constitutes an +"internal" child. Most applications should use +gtk_container_foreach(), rather than gtk_container_forall(). @@ -16936,76 +14074,339 @@ rather than gtk_container_forall()."> + closure="1"> + a callback - + callback user data + - - + + Retrieves the border width of the container. See +gtk_container_set_border_width(). + + the current border width + + + + + Returns the container's non-internal children. See +gtk_container_forall() for details on what constitutes an "internal" child. + + a newly-allocated list of the container's non-internal children. + + + + + + + Retrieves the focus chain of the container, if one has been +set explicitly. If no focus chain has been explicitly +set, GTK+ computes the focus chain based on the positions +of the children. In that case, GTK+ stores %NULL in +has been set explicitly. + + %TRUE if the focus chain of the container + + + + + location to store the focus chain of the container, or %NULL. You should free this list using g_list_free() when you are done with it, however no additional reference count is added to the individual widgets in the focus chain. + + + + + + + + Returns the current focus child widget inside @container. This is not the +currently focused widget. That can be obtained by calling +gtk_window_get_focus(). +the @conatiner is focussed, or %NULL if none is set. + + The child widget which will recieve the focus inside @container when + + + + + Retrieves the horizontal focus adjustment for the container. See +gtk_container_set_focus_hadjustment (). +none has been set. + + the horizontal focus adjustment, or %NULL if + + + + + Retrieves the vertical focus adjustment for the container. See +gtk_container_set_focus_vadjustment(). +none has been set. + + the vertical focus adjustment, or %NULL if + + + + + Returns the resize mode for the container. See +gtk_container_set_resize_mode (). + + the current resize mode + + + + + When a container receives an expose event, it must send synthetic +expose events to all children that don't have their own #GdkWindows. +This function provides a convenient way of doing this. A container, +when it receives an expose event, calls gtk_container_propagate_expose() +once for each child, passing in the event the container received. +gtk_container_propagate_expose() takes care of deciding whether +an expose event needs to be sent to the child, intersecting +the event's area with the child area, and sending the event. +In most cases, a container can simply either simply inherit the +#GtkWidget::expose implementation from #GtkContainer, or, do some drawing +and then chain to the ::expose implementation from #GtkContainer. + + + + + + a child of @container + + + + a expose event sent to container + + + + + + Removes @widget from @container. @widget must be inside @container. +Note that @container will own a reference to @widget, and that this +may be the last reference held; so removing a widget from its +container can destroy that widget. If you want to use @widget +again, you need to add a reference to it while it's not inside +a container, using g_object_ref(). If you don't want to use @widget +again it's usually more efficient to simply destroy it directly +using gtk_widget_destroy() since this will remove it from the +container and help break any circular reference count cycles. + + + + + + a current child of @container + + + + + + + + + + + Sets the border width of the container. +The border width of a container is the amount of space to leave +around the outside of the container. The only exception to this is +#GtkWindow; because toplevel windows can't leave space outside, +they leave the space inside. The border is added on all sides of +the container. To add space to only one side, one approach is to +create a #GtkAlignment widget, call gtk_widget_set_size_request() +to give it a size, and place it on the side of the container as +a spacer. + + + + + + amount of blank space to leave <emphasis>outside</emphasis> the container. Valid values are in the range 0-65535 pixels. + + + + + + Sets a focus chain, overriding the one computed automatically by GTK+. +In principle each widget in the chain should be a descendant of the +container, but this is not enforced by this method, since it's allowed +to set the focus chain before you pack the widgets, or have a widget +in the chain that isn't always packed. The necessary checks are done +when the focus chain is actually traversed. + + + + + + the new focus chain + + + + + + + + Sets, or unsets if @child is %NULL, the focused child of @container. +This function emits the GtkContainer::set_focus_child signal of +default behaviour by overriding the class closure of this signal. +This is function is mostly meant to be used by widgets. Applications can use +gtk_widget_grab_focus() to manualy set the focus to a specific widget. + + + + + + a #GtkWidget, or %NULL + + + + + + Hooks up an adjustment to focus handling in a container, so when a child +of the container is focused, the adjustment is scrolled to show that +widget. This function sets the horizontal alignment. +See gtk_scrolled_window_get_hadjustment() for a typical way of obtaining +the adjustment and gtk_container_set_focus_vadjustment() for setting +the vertical adjustment. +The adjustments have to be in pixel units and in the same coordinate +system as the allocation for immediate children of the container. + + + + + + an adjustment which should be adjusted when the focus is moved among the descendents of @container + + + + + + Hooks up an adjustment to focus handling in a container, so when a +child of the container is focused, the adjustment is scrolled to +show that widget. This function sets the vertical alignment. See +gtk_scrolled_window_get_vadjustment() for a typical way of obtaining +the adjustment and gtk_container_set_focus_hadjustment() for setting +the horizontal adjustment. +The adjustments have to be in pixel units and in the same coordinate +system as the allocation for immediate children of the container. + + + + + + an adjustment which should be adjusted when the focus is moved among the descendents of @container + + + + + + Sets the @reallocate_redraws flag of the container to the given value. +Containers requesting reallocation redraws get automatically +redrawn if any of their children changed allocation. + + + + + + the new value for the container's @reallocate_redraws flag + + + + + + Sets the resize mode for the container. +The resize mode of a container determines whether a resize request +will be passed to the container's parent, queued for later execution +or executed immediately. + + + + + + the new resize mode + + + + + + Removes a focus chain explicitly set with gtk_container_set_focus_chain(). + + + + + + - - + + - - + + - - - - - - - - - - - - - - - - - + + - - + + - + - - + + - - + + - + - - + + - + @@ -17016,8 +14417,11 @@ rather than gtk_container_forall()."> + + + - + @@ -17032,7 +14436,7 @@ rather than gtk_container_forall()."> - + @@ -17047,7 +14451,7 @@ rather than gtk_container_forall()."> - + @@ -17058,8 +14462,8 @@ rather than gtk_container_forall()."> - - + + @@ -17068,19 +14472,19 @@ rather than gtk_container_forall()."> - + - + - + - + @@ -17095,8 +14499,9 @@ rather than gtk_container_forall()."> - + + a #GType. @@ -17107,7 +14512,7 @@ rather than gtk_container_forall()."> - + @@ -17122,7 +14527,7 @@ rather than gtk_container_forall()."> - + @@ -17134,7 +14539,7 @@ rather than gtk_container_forall()."> - + @@ -17146,7 +14551,7 @@ rather than gtk_container_forall()."> - + @@ -17158,7 +14563,7 @@ rather than gtk_container_forall()."> - + @@ -17169,50 +14574,69 @@ rather than gtk_container_forall()."> - - + + - - + + - - + + - - + + + + Modifies a subclass of #GtkContainerClass to automatically add and +remove the border-width setting on GtkContainer. This allows the +subclass to ignore the border width in its size request and +allocate methods. The intent is for a subclass to invoke this +in its class_init function. +gtk_container_class_handle_border_width() is necessary because it +would break API too badly to make this behavior the default. So +subclasses must "opt in" to the parent class handling border_width +for them. + + + + + c:identifier="gtk_container_class_install_child_property"> + Installs a child property on a container class. - + the id for the property + + the #GParamSpec for the property + + c:identifier="GTK_CORNER_BOTTOM_RIGHT" glib:nick="bottom-right"/> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - value="2048" c:identifier="GTK_DEBUG_BUILDER" glib:nick="builder"/> + c:identifier="GTK_DEST_DEFAULT_ALL" glib:nick="all"/> - - - - - - - - - - glib:type-struct="DialogClass"> + - - + + + Creates a new #GtkDialog with title @title (or %NULL for the default title; see gtk_window_set_title()) and transient parent @parent (or %NULL for none; see gtk_window_set_transient_for()). The @flags argument can be used to make the dialog modal (#GTK_DIALOG_MODAL) @@ -17595,15 +14803,15 @@ the list. Button text can be either a stock ID such as any positive number, or one of the values in the #GtkResponseType enumeration. If the user clicks one of these dialog buttons, #GtkDialog will emit the #GtkDialog::response signal with the corresponding -response ID. If a #GtkDialog receives the #GtkWidget::delete-event signal, +response ID. If a #GtkDialog receives the #GtkWidget::delete-event signal, it will emit ::response with a response ID of #GTK_RESPONSE_DELETE_EVENT. However, destroying a dialog does not emit the ::response signal; -so be careful relying on ::response when using the +so be careful relying on ::response when using the #GTK_DIALOG_DESTROY_WITH_PARENT flag. Buttons are from left to right, so the first button in the list will be the leftmost button in the dialog. -Here's a simple example: +Here's a simple example: |[ -GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog", +GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog", main_app_window, GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT, GTK_STOCK_OK, @@ -17611,30 +14819,28 @@ GTK_RESPONSE_ACCEPT, GTK_STOCK_CANCEL, GTK_RESPONSE_REJECT, NULL); -]|"> - - +]| + + a new #GtkDialog + - + + Title of the dialog, or %NULL - + + Transient parent of the dialog, or %NULL + from #GtkDialogFlags + allow-none="1"> + stock ID or text to go in first button, or %NULL @@ -17644,55 +14850,61 @@ NULL); + c:identifier="gtk_dialog_add_action_widget"> + Adds an activatable widget to the action area of a #GtkDialog, +connecting a signal handler that will emit the #GtkDialog::response +signal on the dialog when the widget is activated. The widget is +appended to the end of the dialog's action area. If you want to add a +non-activatable widget, simply pack it into the @action_area field +of the #GtkDialog struct. + an activatable widget - + response ID for @child + - + Adds a button with the given text (or a stock button, if @button_text is a stock ID) and sets things up so that clicking the button will emit the -#GtkDialog::response signal with the given @response_id. The button is -appended to the end of the dialog's action area. The button widget is -returned, but usually you don't need it."> +#GtkDialog::response signal with the given @response_id. The button is +appended to the end of the dialog's action area. The button widget is +returned, but usually you don't need it. + the button widget that was added + text of button, or stock ID - + response ID for the button + + Adds more buttons, same as calling gtk_dialog_add_button() repeatedly. The variable argument list should be %NULL-terminated as with gtk_dialog_new_with_buttons(). Each button must have both -text and response ID."> +text and response ID. + button text or stock ID @@ -17701,187 +14913,89 @@ text and response ID."> - + + Returns the action area of @dialog. - + the action area. + - - - - - - - - - + + Returns the content area of @dialog. - + the content area #GtkVBox. + + + + + Gets the response id of a widget in the action area +of a dialog. +if @widget doesn't have a response id set. + + the response id of @widget, or %GTK_RESPONSE_NONE + - - + + a widget in the action area of @dialog + - + Gets the widget button that uses the given response ID in the action area +of a dialog. + + the @widget button that uses the given @response_id, or %NULL. - + the response ID used by the @dialog widget + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emits the #GtkDialog::response signal with the given response ID. Used to indicate that the user has responded to the dialog in some way; typically either you or gtk_dialog_run() will be monitoring the -::response signal and take appropriate action."> +::response signal and take appropriate action. - + response ID + - + Blocks in a recursive main loop until the @dialog either emits the +#GtkDialog::response signal, or is destroyed. If the dialog is +destroyed during the call to gtk_dialog_run(), gtk_dialog_run() returns +#GTK_RESPONSE_NONE. Otherwise, it returns the response ID from the ::response signal emission. Before entering the recursive main loop, gtk_dialog_run() calls gtk_widget_show() on the dialog for you. Note that you still need to show any children of the dialog yourself. -During gtk_dialog_run(), the default behavior of #GtkWidget::delete-event +During gtk_dialog_run(), the default behavior of #GtkWidget::delete-event is disabled; if the dialog receives ::delete_event, it will not be destroyed as windows usually are, and gtk_dialog_run() will return -#GTK_RESPONSE_DELETE_EVENT. Also, during gtk_dialog_run() the dialog +#GTK_RESPONSE_DELETE_EVENT. Also, during gtk_dialog_run() the dialog will be modal. You can force gtk_dialog_run() to return at any time by -calling gtk_dialog_response() to emit the ::response signal. Destroying -the dialog during gtk_dialog_run() is a very bad idea, because your -post-run code won't know whether the dialog was destroyed or not. +calling gtk_dialog_response() to emit the ::response signal. Destroying +the dialog during gtk_dialog_run() is a very bad idea, because your +post-run code won't know whether the dialog was destroyed or not. After gtk_dialog_run() returns, you are responsible for hiding or destroying the dialog if you wish to do so. Typical usage of this function might be: @@ -17899,69 +15013,147 @@ break; gtk_widget_destroy (dialog); ]| Note that even though the recursive main loop gives the effect of a -modal dialog (it prevents the user from interacting with other -windows in the same window group while the dialog is run), callbacks -such as timeouts, IO channel watches, DND drops, etc, <emphasis>will</emphasis> -be triggered during a gtk_dialog_run() call."> +modal dialog (it prevents the user from interacting with other +windows in the same window group while the dialog is run), callbacks +such as timeouts, IO channel watches, DND drops, etc, <emphasis>will</emphasis> +be triggered during a gtk_dialog_run() call. - + response ID + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets an alternative button order. If the +#GtkSettings:gtk-alternative-button-order setting is set to %TRUE, +the dialog buttons are reordered according to the order of the +response ids passed to this function. +By default, GTK+ dialogs use the button order advocated by the Gnome +<ulink url="http://developer.gnome.org/projects/gup/hig/2.0/">Human +Interface Guidelines</ulink> with the affirmative button at the far +right, and the cancel button left of it. But the builtin GTK+ dialogs +and #GtkMessageDialog<!-- -->s do provide an alternative button order, +which is more suitable on some platforms, e.g. Windows. +Use this function after adding all the buttons to your dialog, as the +following example shows: +|[ +cancel_button = gtk_dialog_add_button (GTK_DIALOG (dialog), +GTK_STOCK_CANCEL, +GTK_RESPONSE_CANCEL); +ok_button = gtk_dialog_add_button (GTK_DIALOG (dialog), +GTK_STOCK_OK, +GTK_RESPONSE_OK); +gtk_widget_grab_default (ok_button); +help_button = gtk_dialog_add_button (GTK_DIALOG (dialog), +GTK_STOCK_HELP, +GTK_RESPONSE_HELP); +gtk_dialog_set_alternative_button_order (GTK_DIALOG (dialog), +GTK_RESPONSE_OK, +GTK_RESPONSE_CANCEL, +GTK_RESPONSE_HELP, +-1); +]| + - - - + + + a response id used by one @dialog's buttons + + + + + + + + + + Sets an alternative button order. If the +#GtkSettings:gtk-alternative-button-order setting is set to %TRUE, +the dialog buttons are reordered according to the order of the +response ids in @new_order. +See gtk_dialog_set_alternative_button_order() for more information. +This function is for use by language bindings. + + + + + + the number of response ids in @new_order + + + + an array of response ids of @dialog's buttons + + + + + + Sets the last widget in the dialog's action area with the given @response_id +as the default widget for the dialog. Pressing "Enter" normally activates +the default widget. + - + a response ID + + + + + + Calls <literal>gtk_widget_set_sensitive (widget, @setting)</literal> +for each widget in the dialog's action area with the given @response_id. +A convenient way to sensitize/desensitize dialog buttons. + + + + + + a response ID + + + + %TRUE for sensitive + + + + + + + + + + + + The ::close signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted when the user uses a keybinding to close +the dialog. +The default binding for this signal is the Escape key. + + + + + + Emitted when an action widget is clicked, the dialog receives a +delete event, or the application programmer calls gtk_dialog_response(). +On a delete event, the response ID is #GTK_RESPONSE_DELETE_EVENT. +Otherwise, it depends on which action widget was clicked. + + + + + + the response ID + @@ -17973,7 +15165,7 @@ Otherwise, it depends on which action widget was clicked."> - + @@ -17982,13 +15174,13 @@ Otherwise, it depends on which action widget was clicked."> - + - + @@ -17999,29 +15191,29 @@ Otherwise, it depends on which action widget was clicked."> - - + + - - + + - - + + - - + + @@ -18040,11 +15232,9 @@ Otherwise, it depends on which action widget was clicked."> value="2" c:identifier="GTK_DIALOG_DESTROY_WITH_PARENT" glib:nick="destroy-with-parent"/> - + + c:identifier="GTK_DIR_RIGHT" glib:nick="right"/> - - - - - - - - - - - - glib:nick="error"/> glib:type-struct="DrawingAreaClass"> + - - + + - - - - - - - - - - - - - - + - - + + - - + + - - + + - - + + @@ -18181,10 +15348,24 @@ Otherwise, it depends on which action widget was clicked."> + glib:type-struct="EditableInterface"> + + + + + + + + + + + + + @@ -18194,36 +15375,88 @@ Otherwise, it depends on which action widget was clicked."> - + - - - - - - - - - - - - - - - + + + Retrieves a sequence of characters. The characters that are retrieved +are those characters at positions from @start_pos up to, but not +including @end_pos. If @end_pos is negative, then the the characters +retrieved are those characters from @start_pos to the end of the text. +Note that positions are specified in characters, not bytes. +string. This string is allocated by the #GtkEditable +implementation and should be freed by the caller. + a pointer to the contents of the widget as a - + start of text + - + end of text + + + + + + Retrieves the current position of the cursor relative to the start +of the content of the editable. +Note that this position is in characters, not in bytes. + + the cursor position + + + + + Retrieves the selection bound of the editable. start_pos will be filled +with the start of the selection and @end_pos with end. If no text was +selected both will be identical and %FALSE will be returned. +Note that positions are specified in characters, not bytes. + + %TRUE if an area is selected, %FALSE otherwise + + + + + location to store the starting position, or %NULL + + + + location to store the end position, or %NULL + + + + + + Sets the cursor position in the editable to the given value. +The cursor is displayed before the character with the given (base 0) +index in the contents of the editable. The value must be less than or +equal to the number of characters in the editable. A value of -1 +indicates that the position should be set after the last character +of the editable. Note that @position is in characters, not in bytes. + + + + + + the position of the cursor + @@ -18233,247 +15466,222 @@ Otherwise, it depends on which action widget was clicked."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Copies the contents of the currently selected content in the editable and +puts it on the clipboard. - - - - - - + + Removes the contents of the currently selected content in the editable and +puts it on the clipboard. + c:identifier="gtk_editable_delete_selection"> + Deletes the currently selected text of the editable. +This call doesn't do anything if there is no selected text. - + + Deletes a sequence of characters. The characters that are deleted are +those characters at positions from @start_pos up to, but not including +are those from @start_pos to the end of the text. +Note that the positions are specified in characters, not bytes. - - + + start position + + + + end position + - + + Retrieves a sequence of characters. The characters that are retrieved +are those characters at positions from @start_pos up to, but not +including @end_pos. If @end_pos is negative, then the the characters +retrieved are those characters from @start_pos to the end of the text. +Note that positions are specified in characters, not bytes. +string. This string is allocated by the #GtkEditable +implementation and should be freed by the caller. + + a pointer to the contents of the widget as a + + + + + start of text + + + + end of text + + + + + + Retrieves whether @editable is editable. See +gtk_editable_set_editable(). - + %TRUE if @editable is editable. + - + + Retrieves the current position of the cursor relative to the start +of the content of the editable. +Note that this position is in characters, not in bytes. + + the cursor position + + + + + Retrieves the selection bound of the editable. start_pos will be filled +with the start of the selection and @end_pos with end. If no text was +selected both will be identical and %FALSE will be returned. +Note that positions are specified in characters, not bytes. + + %TRUE if an area is selected, %FALSE otherwise + + + + + location to store the starting position, or %NULL + + + + location to store the end position, or %NULL + + + + + + Inserts @new_text_length bytes of @new_text into the contents of the +widget, at position @position. +Note that the position is in characters, not in bytes. +The function updates @position to point after the newly inserted text. + + + + + + the text to append + + + + the length of the text in bytes, or -1 + + + + location of the position text will be inserted at + + + + + + Pastes the content of the clipboard to the current position of the +cursor in the editable. + + + + + + Selects a region of text. The characters that are selected are +those characters at positions from @start_pos up to, but not +including @end_pos. If @end_pos is negative, then the the +characters selected are those characters from @start_pos to +the end of the text. +Note that positions are specified in characters, not bytes. + + + + + + start of region + + + + end of region + + + + + + Determines if the user can edit the text in the editable +widget or not. - + %TRUE if the user is allowed to edit the text in the widget + - + + Sets the cursor position in the editable to the given value. +The cursor is displayed before the character with the given (base 0) +index in the contents of the editable. The value must be less than or +equal to the number of characters in the editable. A value of -1 +indicates that the position should be set after the last character +of the editable. Note that @position is in characters, not in bytes. - + + + + the position of the cursor + + + - + The ::changed signal is emitted at the end of a single user-visible operation on the contents of the #GtkEditable. E.g., a paste operation that replaces the contents of the selection will cause only one signal emission (even though it is implemented by first deleting the selection, then inserting the new content, and may cause multiple ::notify::text signals -to be emitted)."> - - +to be emitted). + + - + This signal is emitted when text is deleted from the widget by the user. The default handler for this signal will normally be responsible for deleting the text, so by connecting to this signal and then @@ -18481,55 +15689,56 @@ stopping the signal with g_signal_stop_emission(), it is possible to modify the range of deleted text, or prevent it from being deleted entirely. The @start_pos and @end_pos parameters are interpreted as for -gtk_editable_delete_text()."> - - +gtk_editable_delete_text(). + + - - + + the starting position + - - + + the end position + - + This signal is emitted when text is inserted into the widget by the user. The default handler for this signal will normally be responsible for inserting the text, so by connecting to this signal and then stopping the signal with g_signal_stop_emission(), it is possible to modify the inserted text, or prevent -it from being inserted entirely."> - - +it from being inserted entirely. + + - - + + the new text to insert + - - + + the length of the new text, in bytes, or -1 if new_text is nul-terminated + - - + + the position, in characters, at which to insert the new text. this is an in-out parameter. After the signal emission is finished, it should point after the newly inserted text. + - - + @@ -18541,18 +15750,16 @@ it from being inserted entirely."> - + - - + + - + @@ -18561,16 +15768,16 @@ it from being inserted entirely."> - + - + - + @@ -18582,7 +15789,7 @@ it from being inserted entirely."> - + @@ -18594,18 +15801,16 @@ it from being inserted entirely."> - + - - + + - + @@ -18614,17 +15819,18 @@ it from being inserted entirely."> - + - + - + + a pointer to the contents of the widget as a @@ -18632,16 +15838,18 @@ it from being inserted entirely."> - + start of text + - + end of text + - + @@ -18650,18 +15858,19 @@ it from being inserted entirely."> - + - + - + - + %TRUE if an area is selected, %FALSE otherwise + @@ -18669,19 +15878,25 @@ it from being inserted entirely."> - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + location to store the starting position, or %NULL + - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + location to store the end position, or %NULL + - + @@ -18690,15 +15905,17 @@ it from being inserted entirely."> - + the position of the cursor + - + - + the cursor position + @@ -18709,6 +15926,7 @@ it from being inserted entirely."> - - - + + + Creates a new entry. + + a new #GtkEntry. + - - + Creates a new entry with the specified text buffer. + + a new #GtkEntry + + The buffer to use for the new #GtkEntry. - - - - - - - - - - - - + + - - + + - - + + - - + + + + Retrieves the value set by gtk_entry_set_activates_default(). + + %TRUE if the entry will activate the default widget + + + + + Gets the value set by gtk_entry_set_alignment(). + + the alignment + + + - + Get the #GtkEntryBuffer object which holds the text for +this widget. + + A #GtkEntryBuffer object. - + + Returns the auxiliary completion object currently in use by @entry. +in use by @entry. - + The auxiliary completion object currently + + + + + Returns the index of the icon which is the source of the current +DND operation, or -1. +This function is meant to be used in a #GtkWidget::drag-data-get +callback. +DND operation, or -1. + + index of the icon which is the source of the current + + + + + Retrieves the horizontal cursor adjustment for the entry. +See gtk_entry_set_cursor_hadjustment(). +if none has been set. + + the horizontal cursor adjustment, or %NULL + + + + + Gets the value set by gtk_entry_set_has_frame(). + + whether the entry has a beveled frame + + + + + Returns whether the icon is activatable. + + %TRUE if the icon is activatable. + - - + + Icon position + - + + Finds the icon at the given position and return its index. +If @x, @y doesn't lie inside an icon, -1 is returned. +This function is intended for use in a #GtkWidget::query-tooltip +signal handler. + + the index of the icon at the given position, or -1 + + + + + the x coordinate of the position to find + + + + the y coordinate of the position to find + + + + + + Retrieves the #GIcon used for the icon, or %NULL if there is +no icon or if the icon was set by some other method (e.g., by +stock, pixbuf, or icon name). +or if the icon is not a #GIcon + + A #GIcon, or %NULL if no icon is set + + + + + Icon position + + + + + + Retrieves the icon name used for the icon, or %NULL if there is +no icon or if the icon was set by some other method (e.g., by +pixbuf, stock or gicon). +wasn't set from an icon name + + An icon name, or %NULL if no icon is set or if the icon + + + + + Icon position + + + + + + Retrieves the image used for the icon. +Unlike the other methods of setting and getting icon data, this +method will work regardless of whether the icon was set using a +#GdkPixbuf, a #GIcon, a stock item, or an icon name. +set for this position. + + A #GdkPixbuf, or %NULL if no icon is + + + + + Icon position + + + + + + Returns whether the icon appears sensitive or insensitive. + + %TRUE if the icon is sensitive. + + + + + Icon position + + + + + + Retrieves the stock id used for the icon, or %NULL if there is +no icon or if the icon was set by some other method (e.g., by +pixbuf, icon name or gicon). +wasn't set from a stock id + + A stock id, or %NULL if no icon is set or if the icon + + + + + Icon position + + + + + + Gets the type of representation being used by the icon +to store image data. If the icon has no image data, +the return value will be %GTK_IMAGE_EMPTY. + + image representation being used + + + + + Icon position + + + + + + Gets the contents of the tooltip on the icon at the specified +position in @entry. +with g_free() when done. + the tooltip text, or %NULL. Free the returned string + + + + + the icon position + + + + + + Gets the contents of the tooltip on the icon at the specified +position in @entry. +with g_free() when done. + + the tooltip text, or %NULL. Free the returned string + + + + + the icon position + + + + + + Returns the #GdkWindow which contains the entry's icon at +entry in an expose-event callback because it enables the callback +to distinguish between the text window and entry's icon windows. +See also gtk_entry_get_text_window(). + + the entry's icon window at @icon_pos. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Icon position + - + This function returns the entry's #GtkEntry:inner-border property. See +gtk_entry_set_inner_border() for more information. + + the entry's #GtkBorder, or %NULL if none was set. - + + Retrieves the character displayed in place of the real characters +for entries with visibility set to false. See gtk_entry_set_invisible_char(). +show invisible text at all. - - - - - - - - - - - + the current invisible char, or 0, if the entry does not + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the #PangoLayout used to display the entry. The layout is useful to e.g. convert text positions to pixel positions, in combination with gtk_entry_get_layout_offsets(). -The returned layout is owned by the entry and must not be +The returned layout is owned by the entry and must not be modified or freed by the caller. Keep in mind that the layout text may contain a preedit string, so gtk_entry_layout_index_to_text_index() and gtk_entry_text_index_to_layout_index() are needed to convert byte -indices in the layout to byte indices in the entry contents."> - +indices in the layout to byte indices in the entry contents. + + the #PangoLayout for this entry + Obtains the position of the #PangoLayout used to render text in the entry, in widget coordinates. Useful if you want to line up the text in an entry with some other text, e.g. when using the entry to implement editable cells in a sheet widget. @@ -19091,934 +16286,953 @@ Also useful to convert mouse events into coordinates inside the #PangoLayout, e.g. to take some action if some part of the entry text is clicked. Note that as the user scrolls around in the entry the offsets will -change; you'll need to connect to the "notify::scroll-offset" +change; you'll need to connect to the "notify::scroll-offset" signal to track this. Remember when using the #PangoLayout functions you need to convert to and from pixels using PANGO_PIXELS() or #PANGO_SCALE. Keep in mind that the layout text may contain a preedit string, so gtk_entry_layout_index_to_text_index() and gtk_entry_text_index_to_layout_index() are needed to convert byte -indices in the layout to byte indices in the entry contents."> +indices in the layout to byte indices in the entry contents. - - + + location to store X offset of layout, or %NULL + - - + + location to store Y offset of layout, or %NULL + + + + + + Retrieves the maximum allowed length of the text in +This is equivalent to: +<informalexample><programlisting> +gtk_entry_buffer_get_max_length (gtk_entry_get_buffer (entry)); +</programlisting></informalexample> +in #GtkEntry, or 0 if there is no maximum. + + the maximum allowed number of characters + + + + + Gets the value set by gtk_entry_set_overwrite_mode(). + + whether the text is overwritten when typing. + + + + + Returns the current fraction of the task that's been completed. +See gtk_entry_set_progress_fraction(). + + a fraction from 0.0 to 1.0 + + + + + Retrieves the pulse step set with gtk_entry_set_progress_pulse_step(). + + a fraction from 0.0 to 1.0 + + + + + Retrieves the contents of the entry widget. +See also gtk_editable_get_chars(). +This is equivalent to: +<informalexample><programlisting> +gtk_entry_buffer_get_text (gtk_entry_get_buffer (entry)); +</programlisting></informalexample> +string. This string points to internally allocated +storage in the widget and must not be freed, modified or +stored. + + a pointer to the contents of the widget as a + + + + + Retrieves the current length of the text in +This is equivalent to: +<informalexample><programlisting> +gtk_entry_buffer_get_length (gtk_entry_get_buffer (entry)); +</programlisting></informalexample> +in #GtkEntry, or 0 if there are none. + + the current number of characters + + + + + Returns the #GdkWindow which contains the text. This function is +useful when drawing something to the entry in an expose-event +callback because it enables the callback to distinguish between +the text window and entry's icon windows. +See also gtk_entry_get_icon_window(). + + the entry's text window. + + + + + Retrieves whether the text in @entry is visible. See +gtk_entry_set_visibility(). + + %TRUE if the text is currently visible + + + + + Gets the value set by gtk_entry_set_width_chars(). + + number of chars to request space for, or negative if unset + + + + + Allow the #GtkEntry input method to internally handle key press +and release events. If this function returns %TRUE, then no further +processing should be done for this key event. See +gtk_im_context_filter_keypress(). +Note that you are expected to call this function from your handler +when overriding key event handling. This is needed in the case when +you need to insert your own key handling between the input method +and the default key event handling of the #GtkEntry. +See gtk_text_view_reset_im_context() for an example of use. + + %TRUE if the input method handled the key event. + + + + + the key event + + + + + + Converts from a position in the entry contents (returned +by gtk_entry_get_text()) to a position in the +entry's #PangoLayout (returned by gtk_entry_get_layout(), +with text retrieved via pango_layout_get_text()). + + byte index into the entry contents + + + + + byte index into the entry layout text + + + + + + Indicates that some progress is made, but you don't know how much. +Causes the entry's progress indicator to enter "activity mode," +where a block bounces back and forth. Each call to +gtk_entry_progress_pulse() causes the block to move by a little bit +(the amount of movement per pulse is determined by +gtk_entry_set_progress_pulse_step()). + + + + + + Reset the input method context of the entry if needed. +This can be necessary in the case where modifying the buffer +would confuse on-going input method behavior. + + + + + + If @setting is %TRUE, pressing Enter in the @entry will activate the default +widget for the window containing the entry. This usually means that +the dialog box containing the entry will be closed, since the default +widget is usually one of the dialog buttons. +(For experts: if @setting is %TRUE, the entry calls +gtk_window_activate_default() on the window containing the entry, in +the default handler for the #GtkWidget::activate signal.) + + + + + + %TRUE to activate window's default widget on Enter keypress + + Sets the alignment for the contents of the entry. This controls +the horizontal positioning of the contents when the displayed +text is shorter than the width of the entry. - + The horizontal alignment, from 0 (left) to 1 (right). Reversed for RTL layouts + - + + Set the #GtkEntryBuffer object which holds the text for +this widget. - + + + + a #GtkEntryBuffer + + + + Sets @completion to be the auxiliary completion object to use with @entry. +All further configuration of the completion mechanism is done on + allow-none="1"> + The #GtkEntryCompletion or %NULL - - - - - - - - - - - - - - - - - - - - - - - - - + Hooks up an adjustment to the cursor position in an entry, so that when +the cursor is moved, the adjustment is scrolled to show that position. +See gtk_scrolled_window_get_hadjustment() for a typical way of obtaining +the adjustment. +The adjustment has to be in pixel units and in the same coordinate system +as the entry. + an adjustment which should be adjusted when the cursor is moved, or %NULL - - - - - - + + Sets whether the entry has a beveled frame around it. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + new value + + Sets whether the icon is activatable. + Icon position - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the icon should be activatable + + Sets up the icon at the given position so that GTK+ will start a drag operation when the user clicks and drags the icon. To handle the drag operation, you need to connect to the usual #GtkWidget::drag-data-get (or possibly #GtkWidget::drag-data-delete) signal, and use gtk_entry_get_current_icon_drag_source() in your signal handler to find out if the drag was started from an icon. -By default, GTK+ uses the icon as the drag icon. You can use the -#GtkWidget::drag-begin signal to set a different icon. Note that you +By default, GTK+ uses the icon as the drag icon. You can use the +#GtkWidget::drag-begin signal to set a different icon. Note that you have to use g_signal_connect_after() to ensure that your signal handler -gets executed after the default handler." - version="2.16"> +gets executed after the default handler. + icon position - + + the targets (data formats) in which the data can be provided + a bitmask of the allowed drag actions - + Sets the icon shown in the entry at the specified position +from the current icon theme. +If the icon isn't known, a "broken image" icon will be displayed +instead. +If @icon is %NULL, no icon will be shown in the specified position. - - - - - - + + The position at which to set the icon + + The icon to set, or %NULL + + - + + Sets the icon shown in the entry at the specified position +from the current icon theme. +If the icon name isn't known, a "broken image" icon will be displayed +instead. +If @icon_name is %NULL, no icon will be shown in the specified position. + + + + + + The position at which to set the icon + + + + An icon name, or %NULL + + + + + + Sets the icon shown in the specified position using a pixbuf. +If @pixbuf is %NULL, no icon will be shown in the specified position. + + + + + + Icon position + + + + A #GdkPixbuf, or %NULL + + + + + + Sets the icon shown in the entry at the specified position from +a stock image. +If @stock_id is %NULL, no icon will be shown in the specified position. + + + + + + Icon position + + + + The name of the stock item, or %NULL + + + + + + Sets the sensitivity for the specified icon. + + + + + + Icon position + + + + Specifies whether the icon should appear sensitive or insensitive + + + + + + Sets @tooltip as the contents of the tooltip for the icon at +the specified position. @tooltip is assumed to be marked up with +the <link linkend="PangoMarkupFormat">Pango text markup language</link>. +Use %NULL for @tooltip to remove an existing tooltip. +See also gtk_widget_set_tooltip_markup() and +gtk_enty_set_icon_tooltip_text(). + + + + + + the icon position + + + + the contents of the tooltip for the icon, or %NULL + + + + + + Sets @tooltip as the contents of the tooltip for the icon +at the specified position. +Use %NULL for @tooltip to remove an existing tooltip. +See also gtk_widget_set_tooltip_text() and +gtk_entry_set_icon_tooltip_markup(). + + + + + + the icon position + + + + the contents of the tooltip for the icon, or %NULL + + + + + + Sets %entry's inner-border property to %border, or clears it if %NULL +is passed. The inner-border is the area around the entry's text, but +inside its frame. +If set, this property overrides the inner-border style property. +Overriding the style-provided border is useful when you want to do +in-place editing of some text in a canvas or list widget, where +pixel-exact positioning of the entry is important. + + + + + + a #GtkBorder, or %NULL + + + + + + Sets the character to use in place of the actual text when +gtk_entry_set_visibility() has been called to set text visibility +to %FALSE. i.e. this is the character used in "password mode" to +show the user how many characters have been typed. By default, GTK+ +picks the best invisible char available in the current font. If you +set the invisible char to 0, then the user will get no feedback +at all; there will be no text on the screen as they type. + + + + + + a Unicode character + + + + + + Sets the maximum allowed length of the contents of the widget. If +the current contents are longer than the given length, then they +will be truncated to fit. +This is equivalent to: +<informalexample><programlisting> +gtk_entry_buffer_set_max_length (gtk_entry_get_buffer (entry), max); +</programlisting></informalexample> + + + + + + the maximum length of the entry, or 0 for no maximum. (other than the maximum length of entries.) The value passed in will be clamped to the range 0-65536. + + + + + + Sets whether the text is overwritten when typing in the #GtkEntry. + + + + + + new value + + + + + + Causes the entry's progress indicator to "fill in" the given +fraction of the bar. The fraction should be between 0.0 and 1.0, +inclusive. + + + + + + fraction of the task that's been completed + + + + + + Sets the fraction of total entry width to move the progress +bouncing block for each call to gtk_entry_progress_pulse(). + + + + + + fraction between 0.0 and 1.0 + + + + + + Sets the text in the widget to the given +value, replacing the current contents. +See gtk_entry_buffer_set_text(). + the new text - + + Sets whether the contents of the entry are visible or not. +When visibility is set to %FALSE, characters are displayed +as the invisible char, and will also appear that way when +the text in the entry widget is copied elsewhere. +By default, GTK+ picks the best invisible character available +in the current font, but it can be changed with +gtk_entry_set_invisible_char(). - - + + %TRUE if the contents of the entry are displayed as plaintext + - + + Changes the size request of the entry to be about the right size +for @n_chars characters. Note that it changes the size +<emphasis>request</emphasis>, the size can still be affected by +how you pack the widget into containers. If @n_chars is -1, the +size reverts to the default entry size. - - + + width in chars + - + + Converts from a position in the entry's #PangoLayout (returned by +gtk_entry_get_layout()) to a position in the entry contents +(returned by gtk_entry_get_text()). + + byte index into the entry layout text + + + + + byte index into the entry contents + + + + + + Unsets the invisible char previously set with +gtk_entry_set_invisible_char(). So that the +default invisible char is used again. - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - + + + Which IM (input method) module should be used for this entry. See #GtkIMContext. Setting this to a non-%NULL value overrides the -system-wide IM module setting. See the GtkSettings -#GtkSettings:gtk-im-module property."> - +system-wide IM module setting. See the GtkSettings +#GtkSettings:gtk-im-module property. + - + transfer-ownership="none"> + Sets the text area's border between the text and the frame. + + The invisible character is used when masking entry contents (in +\"password mode\")"). When it is not explicitly set with the #GtkEntry::invisible-char property, GTK+ determines the character to use from a list of possible candidates, depending on availability in the current font. This style property allows the theme to prepend a character -to the list of candidates."> - +to the list of candidates. + - + transfer-ownership="none"> + Whether the invisible char has been set for the #GtkEntry. + - - + + - + transfer-ownership="none"> + If text is overwritten when typing in the #GtkEntry. + - + transfer-ownership="none"> + Whether the primary icon is activatable. +GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release +signals only on sensitive, activatable icons. +Sensitive, but non-activatable icons can be used for purely +informational purposes. + - + transfer-ownership="none"> + The #GIcon to use for the primary icon for the entry. + - + transfer-ownership="none"> + The icon name to use for the primary icon for the entry. + - + transfer-ownership="none"> + A pixbuf to use as the primary icon for the entry. + + Whether the primary icon is sensitive. +An insensitive icon appears grayed out. GTK+ does not emit the +#GtkEntry::icon-press and #GtkEntry::icon-release signals and does not allow DND from insensitive icons. An icon should be set insensitive if the action that would trigger -when clicked is currently not available."> - +when clicked is currently not available. + - + transfer-ownership="none"> + The stock id to use for the primary icon for the entry. + - + transfer-ownership="none"> + The representation which is used for the primary icon of the entry. + + The contents of the tooltip on the primary icon, which is marked up +with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. -Also see gtk_entry_set_icon_tooltip_markup()."> - +Also see gtk_entry_set_icon_tooltip_markup(). + - + transfer-ownership="none"> + The contents of the tooltip on the primary icon. +Also see gtk_entry_set_icon_tooltip_text(). + - + transfer-ownership="none"> + The current fraction of the task that's been completed. + - + transfer-ownership="none"> + The fraction of total entry width to move the progress +bouncing block for each call to gtk_entry_progress_pulse(). + - - + + + Whether the secondary icon is activatable. +GTK+ emits the #GtkEntry::icon-press and #GtkEntry::icon-release signals only on sensitive, activatable icons. -Sensitive, but non-activatable icons can be used for purely -informational purposes."> - +Sensitive, but non-activatable icons can be used for purely +informational purposes. + - + transfer-ownership="none"> + The #GIcon to use for the secondary icon for the entry. + - + transfer-ownership="none"> + The icon name to use for the secondary icon for the entry. + - + transfer-ownership="none"> + An pixbuf to use as the secondary icon for the entry. + + Whether the secondary icon is sensitive. +An insensitive icon appears grayed out. GTK+ does not emit the +#GtkEntry::icon-press and #GtkEntry::icon-release signals and does not allow DND from insensitive icons. An icon should be set insensitive if the action that would trigger -when clicked is currently not available."> - +when clicked is currently not available. + - + transfer-ownership="none"> + The stock id to use for the secondary icon for the entry. + - + transfer-ownership="none"> + The representation which is used for the secondary icon of the entry. + + The contents of the tooltip on the secondary icon, which is marked up +with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. -Also see gtk_entry_set_icon_tooltip_markup()."> - +Also see gtk_entry_set_icon_tooltip_markup(). + - + transfer-ownership="none"> + The contents of the tooltip on the secondary icon. +Also see gtk_entry_set_icon_tooltip_text(). + - - + + - + transfer-ownership="none"> + Which kind of shadow to draw around the entry when +#GtkEntry:has-frame is set to %TRUE. + - - + + - - + + The length of the text in the #GtkEntry. + - + transfer-ownership="none"> + When %TRUE, pasted multi-line text is truncated to the first line. + - - + + - - + + - + transfer-ownership="none"> + The horizontal alignment, from 0 (left) to 1 (right). +Reversed for RTL layouts. + - - - - + - + - + - - - - - - - + @@ -20030,211 +17244,216 @@ Reversed for RTL layouts."> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - + + - + - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user activates the entry. Applications should not connect to it, but may emit it with -g_signal_emit_by_name() if they need to control activation +g_signal_emit_by_name() if they need to control activation programmatically. -The default bindings for this signal are all forms of the Enter key."> - - +The default bindings for this signal are all forms of the Enter key. + + - + The ::backspace signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user asks for it. The default bindings for this signal are -Backspace and Shift-Backspace."> - - +Backspace and Shift-Backspace. + + - + The ::copy-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to copy the selection to the clipboard. The default bindings for this signal are -Ctrl-c and Ctrl-Insert."> - - +Ctrl-c and Ctrl-Insert. + + - + The ::cut-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to cut the selection to the clipboard. The default bindings for this signal are -Ctrl-x and Shift-Delete."> - - +Ctrl-x and Shift-Delete. + + - + The ::delete-from-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates a text deletion. If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection if there is one, otherwise it deletes the requested number of characters. The default bindings for this signal are Delete for deleting a character and Ctrl-Delete for -deleting a word."> - - +deleting a word. + + - - + + the granularity of the deletion, as a #GtkDeleteType + - - + + the number of @type units to delete + - - - + + The ::icon-press signal is emitted when an activatable icon +is clicked. + + - - + + The position of the clicked icon + - - + + the button press event + - - - + + The ::icon-release signal is emitted on the button release from a +mouse click over an activatable icon. + + - - + + The position of the clicked icon + - - + + the button release event + - + The ::insert-at-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates the insertion of a fixed string at the cursor. -This signal has no default bindings."> - - +This signal has no default bindings. + + - - + + the string to insert + - + The ::move-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates a cursor movement. If the cursor is not visible in @entry, this signal causes the viewport to be moved instead. @@ -20249,72 +17468,77 @@ There are too many key combinations to list them all here. <listitem>Arrow keys move by individual characters/lines</listitem> <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem> <listitem>Home/End keys move to the ends of the buffer</listitem> -</itemizedlist>"> - - +</itemizedlist> + + - - + + the granularity of the move, as a #GtkMovementStep + - - + + the number of @step units to move + - - + + %TRUE if the move should extend the selection + - + The ::paste-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to paste the contents of the clipboard into the text view. The default bindings for this signal are -Ctrl-v and Shift-Insert."> - - +Ctrl-v and Shift-Insert. + + - + The ::populate-popup signal gets emitted before showing the +context menu of the entry. If you need to add items to the context menu, connect -to this signal and append your menuitems to the @menu."> - - +to this signal and append your menuitems to the @menu. + + - - + + the menu that is being populated + - + If an input method is used, the typed text will not immediately be committed to the buffer. So if you are interested in the text, -connect to this signal." - version="2.20"> - - +connect to this signal. + + - - + + the current preedit string + - + The ::toggle-overwrite signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to toggle the overwrite mode of the entry. -The default bindings for this signal is Insert."> - - +The default bindings for this signal is Insert. + + glib:type-struct="EntryBufferClass"> + Create a new GtkEntryBuffer object. +Optionally, specify initial text to set in the buffer. + A new GtkEntryBuffer object. + allow-none="1"> + initial buffer text, or %NULL - + number of characters in @initial_chars, or -1 + + + Deletes a sequence of characters from the buffer. @n_chars characters are +deleted starting at @position. If @n_chars is negative, then all characters +until the end of the text are deleted. +If @position or @n_chars are out of bounds, then they are coerced to sane +values. +Note that the positions are specified in characters, not bytes. + + The number of characters deleted. + + + + + position at which to delete text + + + + number of characters to delete + + + + + + Retrieves the length in characters of the buffer. + + The number of characters in the buffer. + + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Inserts @n_chars characters of @chars into the contents of the buffer, at position @position. If @n_chars is negative, then characters from chars will be inserted until a null-terminator is found. If @position or @n_chars are out of bounds, or the maximum buffer text length is exceeded, then they are coerced to sane values. -Note that the position and length are in characters, not in bytes." - version="2.18"> +Note that the position and length are in characters, not in bytes. - + The number of characters actually inserted. + - + the position at which to insert text. + + the text to insert into the buffer. - + the length of the text in characters, or -1 + - + + Deletes a sequence of characters from the buffer. @n_chars characters are deleted starting at @position. If @n_chars is negative, then all characters until the end of the text are deleted. If @position or @n_chars are out of bounds, then they are coerced to sane values. -Note that the positions are specified in characters, not bytes." - version="2.18"> +Note that the positions are specified in characters, not bytes. - + The number of characters deleted. + - + position at which to delete text + - - - - - - - - - - - - - - - - - + number of characters to delete + + Used when subclassing #GtkEntryBuffer - + position at which text was deleted + - + number of characters deleted + - - + + Used when subclassing #GtkEntryBuffer + + + + + + position at which text was inserted + + + + text that was inserted + + + + number of characters inserted + + + + + + Retrieves the length in bytes of the buffer. +See gtk_entry_buffer_get_length(). + + The byte length of the buffer. + + + + + Retrieves the length in characters of the buffer. + + The number of characters in the buffer. + + + + + Retrieves the maximum allowed length of the text in +in #GtkEntryBuffer, or 0 if there is no maximum. + + the maximum allowed number of characters + + + + + Retrieves the contents of the buffer. +The memory pointer returned by this call will not change +unless this object emits a signal, or is finalized. +string. This string points to internally allocated +storage in the buffer and must not be freed, modified or +stored. + + a pointer to the contents of the widget as a + + + + + Inserts @n_chars characters of @chars into the contents of the +buffer, at position @position. +If @n_chars is negative, then characters from chars will be inserted +until a null-terminator is found. If @position or @n_chars are out of +bounds, or the maximum buffer text length is exceeded, then they are +coerced to sane values. +Note that the position and length are in characters, not in bytes. + + The number of characters actually inserted. + + + + + the position at which to insert text. + + + + the text to insert into the buffer. + + + + the length of the text in characters, or -1 + + + + + + Sets the maximum allowed length of the contents of the buffer. If +the current contents are longer than the given length, then they +will be truncated to fit. + + + + + + the maximum length of the entry buffer, or 0 for no maximum. (other than the maximum length of entries.) The value passed in will be clamped to the range 0-65536. + + + + + + Sets the text in the buffer. +This is roughly equivalent to calling gtk_entry_buffer_delete_text() +and gtk_entry_buffer_insert_text(). +Note that @n_chars is in characters, not in bytes. + + + + + + the new text + + + + the number of characters in @text, or -1 + + + + + + The length (in characters) of the text in buffer. + - + transfer-ownership="none"> + The maximum length (in characters) of the text in the buffer. + - + transfer-ownership="none"> + The contents of the buffer. + @@ -20563,32 +17829,39 @@ Note that the positions are specified in characters, not bytes." - - - + + This signal is emitted after text is deleted from the buffer. + + - + the position the text was deleted at. + - + The number of characters that were deleted. + - - - + + This signal is emitted after text is inserted into the buffer. + + - + the position the text was inserted at. + - + The text that was inserted. + - + The number of characters that were inserted. + @@ -20600,7 +17873,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20609,19 +17882,19 @@ Note that the positions are specified in characters, not bytes." - + - + - + @@ -20630,16 +17903,16 @@ Note that the positions are specified in characters, not bytes." - + - + - + @@ -20647,18 +17920,17 @@ Note that the positions are specified in characters, not bytes." - - + + - + - + The number of characters in the buffer. + @@ -20668,88 +17940,97 @@ Note that the positions are specified in characters, not bytes." - + - + The number of characters actually inserted. + - + the position at which to insert text. + + the text to insert into the buffer. - + the length of the text in characters, or -1 + - + - + The number of characters deleted. + - + position at which to delete text + - + number of characters to delete + - - + + - - + + - - + + - - + + - - + + - - + + - + - + @@ -20773,7 +18054,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20785,7 +18066,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20797,16 +18078,16 @@ Note that the positions are specified in characters, not bytes." - + - + - + @@ -20821,7 +18102,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20833,13 +18114,13 @@ Note that the positions are specified in characters, not bytes." - + - + @@ -20851,7 +18132,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20863,7 +18144,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20875,7 +18156,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20887,7 +18168,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20899,7 +18180,7 @@ Note that the positions are specified in characters, not bytes." - + @@ -20907,30 +18188,30 @@ Note that the positions are specified in characters, not bytes." - - + + - - + + - - + + - - + + - - + + - - + + @@ -20938,6 +18219,7 @@ Note that the positions are specified in characters, not bytes." + Creates a new #GtkEntryCompletion object. + A newly created #GtkEntryCompletion object. - - - + Requests a completion operation, or in other words a refiltering of the +current list with completions, using the current key. The completion list +view will be updated accordingly. + + - + Deletes the action at @index_ from @completion's action list. - - + + The index of the item to Delete. + + + Get the original text entered by the user that triggered +the completion or %NULL if there's no completion ongoing. + + the prefix for the current completion + + + + + Gets the entry @completion has been attached to. + + The entry @completion has been attached to. + + + + + Returns whether the common prefix of the possible completions should +be automatically inserted in the entry. + + %TRUE if inline completion is turned on + + + + + Returns %TRUE if inline-selection mode is turned on. + + %TRUE if inline-selection mode is on + + + + + Returns the minimum key length as set for @completion. + + The currently used minimum key length. + + + - + Returns the model the #GtkEntryCompletion is using as data source. +Returns %NULL if the model is unset. +is currently being used. + + A #GtkTreeModel, or %NULL if none + + Returns whether the completions should be presented in a popup window. + + %TRUE if popup completion is turned on + + + + + Returns whether the completion popup window will be resized to the +width of the entry. +the entry + + %TRUE if the popup window will be resized to the width of + + + + + Returns whether the completion popup window will appear even if there is +only a single match. +number of matches. + + %TRUE if the popup window will appear regardless of the + + + + + Returns the column in the model of @completion to get strings from. + + the column containing the strings + + + + + Inserts an action in @completion's action item list at position @index_ +with markup @markup. + + + + + + The index of the item to insert. + + + + Markup of the item to insert. + + + + + + Inserts an action in @completion's action item list at position @index_ +with text @text. If you want the action item to have markup, use +gtk_entry_completion_insert_action_markup(). + + + + + + The index of the item to insert. + + + + Text of the item to insert. + + + + + + Requests a prefix insertion. + + + + + + Sets whether the common prefix of the possible completions should +be automatically inserted in the entry. + + + + + + %TRUE to do inline completion + + + + + + Sets whether it is possible to cycle through the possible completions +inside the entry. + + + + + + %TRUE to do inline selection + + + + + Sets the match function for @completion to be @func. The match function +is used to determine if a row should or should not be in the completion +list. @@ -21001,312 +18448,181 @@ list." + closure="1" + destroy="2"> + The #GtkEntryCompletionMatchFunc to use. - + The user data for @func. + - + + Destroy notifier for @func_data. + Requires the length of the search key for @completion to be at least +key takes a lot of time and will come up with meaningless results anyway +(ie, a too large dataset). - + The minimum length of the key in order to start completing. + - - - - - - - - - - - - - - - - + Sets the model for a #GtkEntryCompletion. If @completion already has +a model set, it will remove it before setting the new model. +If model is %NULL, then it will unset the model. - - - - - + + The #GtkTreeModel. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets whether the completions should be presented in a popup window. - + %TRUE to do popup completion + - - - - - + Sets whether the completion popup window will be resized to be the same +width as the entry. - + %TRUE to make the width of the popup the same as the entry + - - - - - + Sets whether the completion popup window will appear even if there is +only a single match. You may want to set this to %FALSE if you +are using <link linkend="GtkEntryCompletion--inline-completion">inline +completion</link>. - + %TRUE if the popup should appear even for a single match + - - - - - - - - - - + completion list with just strings. This function will set up @completion to have a list displaying all (and just) strings in the completion list, and to get those strings from @column in the model of @completion. -This functions creates and adds a #GtkCellRendererText for the selected -column. If you need to set the text column, but don't want the cell -renderer, use g_object_set() to set the ::text_column property directly." - version="2.4"> +This functions creates and adds a #GtkCellRendererText for the selected +column. If you need to set the text column, but don't want the cell +renderer, use g_object_set() to set the ::text_column property directly. - + The column in the model of @completion to get strings from. + - - - - - + Determines whether the common prefix of the possible completions should be inserted automatically in the entry. Note that this requires text-column to be set, even if you are using a custom -match function."> - +match function. + - + transfer-ownership="none"> + Determines whether the possible completions on the popup +will appear in the entry as you navigate through them. + - - + + - - + + - + transfer-ownership="none"> + Determines whether the possible completions should be +shown in a popup window. + - + transfer-ownership="none"> + Determines whether the completions popup window will be +resized to the width of the entry. + + Determines whether the completions popup window will shown for a single possible completion. You probably want to set -this to %FALSE if you are using -<link linkend="GtkEntryCompletion--inline-completion">inline -completion</link>."> - +this to %FALSE if you are using +<link linkend="GtkEntryCompletion--inline-completion">inline +completion</link>. + - + transfer-ownership="none"> + The column of the model containing the strings. +Note that the strings must be UTF-8. + @@ -21315,69 +18631,74 @@ Note that the strings must be UTF-8."> - - - + + Gets emitted when an action is activated. + + - - + + the index of the activated action + - + Gets emitted when a match from the cursor is on a match +of the list. The default behaviour is to replace the contents of the entry with the contents of the text column in the row -pointed to by @iter." - version="2.12"> - - +pointed to by @iter. + + %TRUE if the signal has been handled + - - + + the #GtkTreeModel containing the matches + - - + + a #GtkTreeIter positioned at the selected match + - + Gets emitted when the inline autocompletion is triggered. The default behaviour is to make the entry display the whole prefix and select the newly inserted part. Applications may connect to this signal in order to insert only a smaller part of the @prefix into the entry - e.g. the entry used in the #GtkFileChooser inserts only the part of the prefix up to the -next '/'." - version="2.6"> - - +next '/'. + + %TRUE if the signal has been handled + - - + + the common prefix of all possible completions + - + Gets emitted when a match from the list is selected. The default behaviour is to replace the contents of the entry with the contents of the text column in the row -pointed to by @iter." - version="2.4"> - - +pointed to by @iter. + + %TRUE if the signal has been handled + - - + + the #GtkTreeModel containing the matches + - - + + a #GtkTreeIter positioned at the selected match + @@ -21389,9 +18710,9 @@ pointed to by @iter." - + - + @@ -21407,7 +18728,7 @@ pointed to by @iter." - + @@ -21416,15 +18737,15 @@ pointed to by @iter." - + - + - + @@ -21437,9 +18758,9 @@ pointed to by @iter." - + - + @@ -21454,15 +18775,15 @@ pointed to by @iter." - - + + - - + + @@ -21472,7 +18793,7 @@ pointed to by @iter." - + @@ -21485,11 +18806,13 @@ pointed to by @iter." - + - + + - - + + + + Returns whether the event box window is above or below the +windows of its child. See gtk_event_box_set_above_child() for +details. +of its child. + + %TRUE if the event box window is above the window + + + + Returns whether the event box has a visible window. +See gtk_event_box_set_visible_window() for details. - + %TRUE if the event box window is visible + + + Set whether the event box window is positioned above the windows of its child, +as opposed to below it. If the window is above, all events inside the +event box will go to the event box. If the window is below, events +in windows of child widgets will first got to that widget, and then +to its parents. +The default is to keep the window below the child. + + + + + + %TRUE if the event box window is above the windows of its child + + + + + Set whether the event box uses a visible or invisible child window. The default is to use visible windows. In an invisible window event box, the window that the -event box creates is a %GDK_INPUT_ONLY window, which +event box creates is a %GDK_INPUT_ONLY window, which means that it is invisible and only serves to receive events. A visible window event box creates a visible (%GDK_INPUT_OUTPUT) -window that acts as the parent window for all the widgets +window that acts as the parent window for all the widgets contained in the event box. You should generally make your event box invisible if you just want to trap events. Creating a visible window @@ -21548,60 +18906,31 @@ draw on it. There is one unexpected issue for an invisible event box that has its window below the child. (See gtk_event_box_set_above_child().) Since the input-only window is not an ancestor window of any windows -that descendent widgets of the event box create, events on these -windows aren't propagated up by the windowing system, but only by GTK+. -The practical effect of this is if an event isn't in the event -mask for the descendant window (see gtk_widget_add_events()), -it won't be received by the event box. +that descendent widgets of the event box create, events on these +windows aren't propagated up by the windowing system, but only by GTK+. +The practical effect of this is if an event isn't in the event +mask for the descendant window (see gtk_widget_add_events()), +it won't be received by the event box. </para><para> -This problem doesn't occur for visible event boxes, because in +This problem doesn't occur for visible event boxes, because in that case, the event box window is actually the ancestor of the descendant windows, not just at the same place on the screen. -</para></note>" - version="2.4"> +</para></note> - + boolean value + - - - - - - - - - - - - - - - - - + + - - + + @@ -21615,6 +18944,7 @@ The default is to keep the window below the child." - - - + + + Creates a new expander using @label as the text of the label. + + a new #GtkExpander widget. + + the text of the label - - + Creates a new expander using @label as the text of the label. +If characters in @label are preceded by an underscore, they are underlined. +If you need a literal underscore character in a label, use '__' (two +underscores). The first underlined character represents a keyboard +accelerator called a mnemonic. +Pressing Alt and that key activates the button. + + a new #GtkExpander widget. + - + + the text of the label with an underscore in front of the mnemonic character - - - - - - - - - - + Queries a #GtkExpander and returns its current state. Returns %TRUE if the child widget is revealed. -See gtk_expander_set_expanded()." - version="2.4"> +See gtk_expander_set_expanded(). - + the current state of the expander. + - - - - - - - - - - - - - - - - - - - - - - - - - + Fetches the text from a label widget including any embedded underlines indicating mnemonics and Pango markup, as set by gtk_expander_set_label(). If the label text has not been set the return value will be %NULL. This will be the case if you create an @@ -21733,104 +19010,209 @@ Note that this function behaved differently in versions prior to underlines indicating mnemonics and Pango markup. This problem can be avoided by fetching the label text directly from the label widget. -by the widget and must not be modified or freed." - version="2.4"> +by the widget and must not be modified or freed. + The text of the label widget. This string is owned - + + Returns whether the label widget will fill all available horizontal +space allocated to @expander. +space - - - - - - - - - - - + %TRUE if the label widget will fill all available horizontal + - + Retrieves the label widget for the frame. See +gtk_expander_set_label_widget(). +or %NULL if there is none. - + the label widget, + + + + + Gets the value set by gtk_expander_set_spacing(). + + spacing between the expander and child. + - - - - - + Returns whether the label's text is interpreted as marked up with +the <link linkend="PangoMarkupFormat">Pango text markup +language</link>. See gtk_expander_set_use_markup (). - + %TRUE if the label's text will be parsed for markup + + + Returns whether an embedded underline in the expander label indicates a +mnemonic. See gtk_expander_set_use_underline(). +indicates the mnemonic accelerator keys. + + %TRUE if an embedded underline in the expander label + + + + + Sets the state of the expander. Set to %TRUE, if you want +the child widget to be revealed, and %FALSE if you want the +child widget to be hidden. + + + + + + whether the child widget is revealed + + + + + + Sets the text of the label of the expander to @label. +This will also clear any previously set labels. + + + + + + a string + + + + + + Sets whether the label widget should fill all available horizontal space +allocated to @expander. + + + + + + %TRUE if the label should should fill all available horizontal space + + + + + Set the label widget for the expander. This is the widget +that will appear embedded alongside the expander arrow. + allow-none="1"> + the new label widget - - - + Sets the spacing field of @expander, which is the number of pixels to +place between expander and the child. + + + + + distance between the expander and child in pixels. + + + - - + + Sets whether the text of the label contains markup in <link +linkend="PangoMarkupFormat">Pango's text markup +language</link>. See gtk_label_set_markup(). + + + + + + %TRUE if the label's text should be parsed for markup + + + + + + If true, an underline in the text of the expander label indicates +the next character should be used for the mnemonic accelerator key. + + + + + + %TRUE if underlines in the text indicate mnemonics + + + + + + - - + + - - + + - - + + - - + + - - + + + + + @@ -21839,8 +19221,8 @@ gtk_expander_set_label_widget()." - - + + @@ -21851,7 +19233,7 @@ gtk_expander_set_label_widget()." - + @@ -21863,7 +19245,7 @@ gtk_expander_set_label_widget()." - + - + Adds @filter to the list of filters that the user can select between. +When a filter is selected, only files that are passed by that +filter are displayed. +Note that the @chooser takes ownership of the filter, so you have to +ref and sink it if you want to keep a reference. - - + + a #GtkFileFilter + + + + + + Adds a folder to be displayed with the shortcut folders in a file chooser. +Note that shortcut folders do not get saved, as they are provided by the +application. For example, you can use this to add a +"/usr/share/mydrawprogram/Clipart" folder to the volume list. +otherwise. In the latter case, the @error will be set as appropriate. + + %TRUE if the folder could be added successfully, %FALSE + + + + + filename of the folder to add + + + + + + Adds a folder URI to be displayed with the shortcut folders in a file +chooser. Note that shortcut folders do not get saved, as they are provided +by the application. For example, you can use this to add a +"file:///usr/share/mydrawprogram/Clipart" folder to the volume list. +otherwise. In the latter case, the @error will be set as appropriate. + + %TRUE if the folder could be added successfully, %FALSE + + + + + URI of the folder to add + - + Gets the type of operation that the file chooser is performing; see +gtk_file_chooser_set_action(). + + the action that the file selector is performing - + + Gets whether file choser will offer to create new folders. +See gtk_file_chooser_set_create_folders(). - + %TRUE if the New Folder button should be displayed. + + + + + Gets the current folder of @chooser as a local filename. +See gtk_file_chooser_set_current_folder(). +Note that this is the folder that the file chooser is currently displaying +(e.g. "/home/username/Documents"), which is <emphasis>not the same</emphasis> +as the currently-selected folder if the chooser is in +%GTK_FILE_CHOOSER_SELECT_FOLDER mode +(e.g. "/home/username/Documents/selected-folder/". To get the +currently-selected folder in that mode, use gtk_file_chooser_get_uri() as the +usual way to get the selection. +path cannot be represented as a local filename. Free with g_free(). This +function will also return %NULL if the file chooser was unable to load the +last folder that was requested from it; for example, as would be for calling +gtk_file_chooser_set_current_folder() on a nonexistent folder. + + the full path of the current folder, or %NULL if the current + + + + + Gets the current folder of @chooser as #GFile. +See gtk_file_chooser_get_current_folder_uri(). + + the #GFile for the current folder. + + + + + Gets the current folder of @chooser as an URI. +See gtk_file_chooser_set_current_folder_uri(). +Note that this is the folder that the file chooser is currently displaying +(e.g. "file:///home/username/Documents"), which is <emphasis>not the same</emphasis> +as the currently-selected folder if the chooser is in +%GTK_FILE_CHOOSER_SELECT_FOLDER mode +(e.g. "file:///home/username/Documents/selected-folder/". To get the +currently-selected folder in that mode, use gtk_file_chooser_get_uri() as the +usual way to get the selection. +function will also return %NULL if the file chooser was unable to load the +last folder that was requested from it; for example, as would be for calling +gtk_file_chooser_set_current_folder_uri() on a nonexistent folder. + + the URI for the current folder. Free with g_free(). This + + + + + Queries whether a file chooser is set to confirm for overwriting when the user +types a file name that already exists. +%FALSE otherwise. + + %TRUE if the file chooser will present a confirmation dialog; + + + + + Gets the current preview widget; see +gtk_file_chooser_set_extra_widget(). + + the current extra widget, or %NULL + + + + + Gets the #GFile for the currently selected file in +the file selector. If multiple files are selected, +one of the files will be returned at random. +If the file chooser is in folder mode, this function returns the selected +folder. +use g_object_unref() to release it. + + a selected #GFile. You own the returned file; + + + + + Gets the filename for the currently selected file in +the file selector. If multiple files are selected, +one of the filenames will be returned at random. +If the file chooser is in folder mode, this function returns the selected +folder. +if no file is selected, or the selected file can't +be represented with a local filename. Free with g_free(). + + The currently selected filename, or %NULL + + + + + Lists all the selected files and subfolders in the current folder of +folder cannot be represented as local filenames they will be ignored. (See +gtk_file_chooser_get_uris()) +files and subfolders in the current folder. Free the returned list +with g_slist_free(), and the filenames with g_free(). + + a #GSList containing the filenames of all selected + + + + + + + Lists all the selected files and subfolders in the current folder of @chooser +as #GFile. An internal function, see gtk_file_chooser_get_uris(). +file and subfolder in the current folder. Free the returned list +with g_slist_free(), and the files with g_object_unref(). + + a #GSList containing a #GFile for each selected + + + + + + + Gets the current filter; see gtk_file_chooser_set_filter(). + + the current filter, or %NULL + - - - - - + Gets whether only local files can be selected in the +file selector. See gtk_file_chooser_set_local_only() - + %TRUE if only local files can be selected. + - + + Gets the #GFile that should be previewed in a custom preview +Internal function, see gtk_file_chooser_get_preview_uri(). +or %NULL if no file is selected. Free with g_object_unref(). - + the #GFile for the file to preview, + + + + + Gets the filename that should be previewed in a custom preview +widget. See gtk_file_chooser_set_preview_widget(). +is selected, or if the selected file cannot be represented +as a local filename. Free with g_free() + + the filename to preview, or %NULL if no file + + + + + Gets the URI that should be previewed in a custom preview +widget. See gtk_file_chooser_set_preview_widget(). +selected. Free with g_free(). + + the URI for the file to preview, or %NULL if no file is + + + + + Gets the current preview widget; see +gtk_file_chooser_set_preview_widget(). + + the current preview widget, or %NULL + + + + + Gets whether the preview widget set by gtk_file_chooser_set_preview_widget() +should be shown for the current filename. See +gtk_file_chooser_set_preview_widget_active(). + + %TRUE if the preview widget is active for the current filename. + - - - - - + Gets whether multiple files can be selected in the file +selector. See gtk_file_chooser_set_select_multiple(). - + %TRUE if multiple files can be selected. + - + Gets whether hidden files and folders are displayed in the file selector. +See gtk_file_chooser_set_show_hidden(). + + %TRUE if hidden files and folders are displayed. + + + + + Gets the URI for the currently selected file in +the file selector. If multiple files are selected, +one of the filenames will be returned at random. +If the file chooser is in folder mode, this function returns the selected +folder. +if no file is selected. Free with g_free() + + The currently selected URI, or %NULL + + + + + Lists all the selected files and subfolders in the current folder of +files and subfolders in the current folder. Free the returned list +with g_slist_free(), and the filenames with g_free(). + + a #GSList containing the URIs of all selected + + + + + + + Gets whether a stock label should be drawn with the name of the previewed +file. See gtk_file_chooser_set_use_preview_label(). +name of the previewed file, %FALSE otherwise. + + %TRUE if the file chooser is set to display a label with the + + + + + Lists the current set of user-selectable filters; see +gtk_file_chooser_add_filter(), gtk_file_chooser_remove_filter(). +user selectable filters. The contents of the list are +owned by GTK+, but you must free the list itself with +g_slist_free() when you are done with it. + + a #GSList containing the current set of + + + + + + + Queries the list of shortcut folders in the file chooser, as set by +gtk_file_chooser_add_shortcut_folder_uri(). +folders. Free the returned list with g_slist_free(), and the URIs with +g_free(). + + A list of folder URIs, or %NULL if there are no shortcut + + + + + + + Queries the list of shortcut folders in the file chooser, as set by +gtk_file_chooser_add_shortcut_folder(). +folders. Free the returned list with g_slist_free(), and the filenames with +g_free(). + + A list of folder filenames, or %NULL if there are no shortcut + + + + + + + Removes @filter from the list of filters that the user can select between. - - + + a #GtkFileFilter + - + + Removes a folder from a file chooser's list of shortcut folders. +In the latter case, the @error will be set as appropriate. - + %TRUE if the operation succeeds, %FALSE otherwise. + + + + filename of the folder to remove + + + + + + Removes a folder URI from a file chooser's list of shortcut folders. +In the latter case, the @error will be set as appropriate. + + %TRUE if the operation succeeds, %FALSE otherwise. + + + + + URI of the folder to remove + + + + + + Selects all the files in the current folder of a file chooser. + + + + + + Selects the file referred to by @file. An internal function. See +_gtk_file_chooser_select_uri(). +selected successfully, %FALSE otherwise. + + %TRUE if both the folder could be changed and the path was + + + + + the file to select + + + + + + Selects a filename. If the file name isn't in the current +folder of @chooser, then the current folder of @chooser will +be changed to the folder containing @filename. +selected successfully, %FALSE otherwise. + + %TRUE if both the folder could be changed and the file was + + + + + the filename to select + + + + + + Selects the file to by @uri. If the URI doesn't refer to a +file in the current folder of @chooser, then the current folder of +selected successfully, %FALSE otherwise. + + %TRUE if both the folder could be changed and the URI was + + + + + the URI to select + + + + + + Sets the type of operation that the chooser is performing; the +user interface is adapted to suit the selected action. For example, +an option to create a new folder might be shown if the action is +%GTK_FILE_CHOOSER_ACTION_SAVE but not if the action is +%GTK_FILE_CHOOSER_ACTION_OPEN. + + + + + + the action that the file selector is performing + + + + + + Sets whether file choser will offer to create new folders. +This is only relevant if the action is not set to be +%GTK_FILE_CHOOSER_ACTION_OPEN. + + + + + + %TRUE if the New Folder button should be displayed + + + + + + Sets the current folder for @chooser from a local filename. +The user will be shown the full contents of the current folder, +plus user interface elements for navigating to other folders. +otherwise. + + %TRUE if the folder could be changed successfully, %FALSE + + + + + the full path of the new current folder + + + + + + Sets the current folder for @chooser from a #GFile. +Internal function, see gtk_file_chooser_set_current_folder_uri(). +otherwise. + + %TRUE if the folder could be changed successfully, %FALSE + + + + + the #GFile for the new folder + + + + + + Sets the current folder for @chooser from an URI. +The user will be shown the full contents of the current folder, +plus user interface elements for navigating to other folders. +otherwise. + + %TRUE if the folder could be changed successfully, %FALSE + + + + + the URI for the new current folder + + + + + + Sets the current name in the file selector, as if entered +by the user. Note that the name passed in here is a UTF-8 +string rather than a filename. This function is meant for +such uses as a suggested name in a "Save As..." dialog. +If you want to preselect a particular existing file, you should use +gtk_file_chooser_set_filename() or gtk_file_chooser_set_uri() instead. +Please see the documentation for those functions for an example of using +gtk_file_chooser_set_current_name() as well. + + + + + + the filename to use, as a UTF-8 string + + + + Sets whether a file chooser in %GTK_FILE_CHOOSER_ACTION_SAVE mode will present a confirmation dialog if the user types a file name that already exists. This is %FALSE by default. Regardless of this setting, the @chooser will emit the @@ -22003,381 +19885,41 @@ Regardless of this setting, the @chooser will emit the If all you need is the stock confirmation dialog, set this property to %TRUE. You can override the way confirmation is done by actually handling the #GtkFileChooser::confirm-overwrite signal; please refer to its documentation -for the details." - version="2.8"> +for the details. - + whether to confirm overwriting in save mode + - - - - - - + + Sets an application-supplied widget to provide extra options to the user. - - + + widget for extra options + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets @file as the current filename for the file chooser, by changing +to the file's parent folder and actually selecting the file in list. If +the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name +will also appear in the dialog's file name entry. +If the file name isn't in the current folder of @chooser, then the current folder of @chooser will be changed to the folder containing @filename. This is equivalent to a sequence of gtk_file_chooser_unselect_all() followed by gtk_file_chooser_select_filename(). @@ -22386,7 +19928,7 @@ for the directory change. If you are implementing a <guimenuitem>File/Save As...</guimenuitem> dialog, you should use this function if you already have a file name to which the user may save; for example, when the user opens an existing file and then -does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have +does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have a file name already &mdash; for example, if the user just created a new file and is saving it for the first time, do not call this function. Instead, use something similar to this: @@ -22395,7 +19937,7 @@ if (document_is_new) { /&ast; the user just created a new document &ast;/ gtk_file_chooser_set_current_folder_file (chooser, default_file_for_saving); -gtk_file_chooser_set_current_name (chooser, "Untitled document"); +gtk_file_chooser_set_current_name (chooser, "Untitled document"); } else { @@ -22403,90 +19945,108 @@ else gtk_file_chooser_set_file (chooser, existing_file); } ]| -selected successfully, %FALSE otherwise." - version="2.14" - throws="1"> +selected successfully, %FALSE otherwise. - + %TRUE if both the folder could be changed and the file was + + the #GFile to set as current - + + Sets @filename as the current filename for the file chooser, by changing +to the file's parent folder and actually selecting the file in list. If +the @chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode, the file's base name +will also appear in the dialog's file name entry. +If the file name isn't in the current folder of @chooser, then the current +folder of @chooser will be changed to the folder containing @filename. This +is equivalent to a sequence of gtk_file_chooser_unselect_all() followed by +gtk_file_chooser_select_filename(). +Note that the file must exist, or nothing will be done except +for the directory change. +If you are implementing a <guimenuitem>File/Save As...</guimenuitem> dialog, +you should use this function if you already have a file name to which the +user may save; for example, when the user opens an existing file and then +does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have +a file name already &mdash; for example, if the user just created a new +file and is saving it for the first time, do not call this function. +Instead, use something similar to this: +|[ +if (document_is_new) +{ +/&ast; the user just created a new document &ast;/ +gtk_file_chooser_set_current_folder (chooser, default_folder_for_saving); +gtk_file_chooser_set_current_name (chooser, "Untitled document"); +} +else +{ +/&ast; the user edited an existing document &ast;/ +gtk_file_chooser_set_filename (chooser, existing_filename); +} +]| +selected successfully, %FALSE otherwise. - + %TRUE if both the folder could be changed and the file was + - - + + the filename to set as current + - + + Sets the current filter; only the files that pass the +filter will be displayed. If the user-selectable list of filters +is non-empty, then the filter should be one of the filters +in that list. Setting the current filter when the list of +filters is empty is useful if you want to restrict the displayed +set of files without letting the user change it. - - + + a #GtkFileFilter + - - - - - - - - + + Sets whether only local files can be selected in the +file selector. If @local_only is %TRUE (the default), +then the selected file are files are guaranteed to be +accessible through the operating systems native file +file system and therefore the application only +needs to worry about the filename functions in +#GtkFileChooser, like gtk_file_chooser_get_filename(), +rather than the URI functions like +gtk_file_chooser_get_uri(), - + - - + + %TRUE if only local files can be selected + - - - - - + Sets an application-supplied widget to use to display a custom preview of the currently selected file. To implement a preview, after setting the preview widget, you connect to the #GtkFileChooser::update-preview signal, and call gtk_file_chooser_get_preview_filename() or @@ -22497,347 +20057,233 @@ Otherwise, set the preview inactive. When there is no application-supplied preview widget, or the application-supplied preview widget is not active, the file chooser may display an internally generated preview of the current file or -it may display no preview at all." - version="2.4"> +it may display no preview at all. + widget for displaying preview. - - - - - + Sets whether the preview widget set by gtk_file_chooser_set_preview_widget() should be shown for the current filename. When @active is set to false, the file chooser may display an internally generated preview of the current file or it may display no preview at all. See -gtk_file_chooser_set_preview_widget() for more details." - version="2.4"> +gtk_file_chooser_set_preview_widget() for more details. - + whether to display the user-specified preview widget + - + Sets whether multiple files can be selected in the file selector. This is +only relevant if the action is set to be %GTK_FILE_CHOOSER_ACTION_OPEN or +%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER. - + + + + %TRUE if multiple files can be selected. + + + + + + Sets whether hidden files and folders are displayed in the file selector. + + + + + + %TRUE if hidden files and folders should be displayed. + + + + + + Sets the file referred to by @uri as the current file for the file chooser, +by changing to the URI's parent folder and actually selecting the URI in the +list. If the @chooser is %GTK_FILE_CHOOSER_ACTION_SAVE mode, the URI's base +name will also appear in the dialog's file name entry. +If the URI isn't in the current folder of @chooser, then the current folder +of @chooser will be changed to the folder containing @uri. This is equivalent +to a sequence of gtk_file_chooser_unselect_all() followed by +gtk_file_chooser_select_uri(). +Note that the URI must exist, or nothing will be done except for the +directory change. +If you are implementing a <guimenuitem>File/Save As...</guimenuitem> dialog, +you should use this function if you already have a file name to which the +user may save; for example, when the user opens an existing file and then +does <guimenuitem>File/Save As...</guimenuitem> on it. If you don't have +a file name already &mdash; for example, if the user just created a new +file and is saving it for the first time, do not call this function. +Instead, use something similar to this: +|[ +if (document_is_new) +{ +/&ast; the user just created a new document &ast;/ +gtk_file_chooser_set_current_folder_uri (chooser, default_folder_for_saving); +gtk_file_chooser_set_current_name (chooser, "Untitled document"); +} +else +{ +/&ast; the user edited an existing document &ast;/ +gtk_file_chooser_set_uri (chooser, existing_uri); +} +]| +selected successfully, %FALSE otherwise. + + %TRUE if both the folder could be changed and the URI was + + + + + the URI to set as current + + + + Sets whether the file chooser should display a stock label with the name of the file that is being previewed; the default is %TRUE. Applications that want to draw the whole preview area themselves should set this to %FALSE and -display the name themselves in their preview widget." - version="2.4"> +display the name themselves in their preview widget. - + whether to display a stock label with the name of the previewed file + - + + Unselects all the files in the current folder of a file chooser. - + - - - - - - - - - - - - - - - - + Unselects the file referred to by @file. If the file is not in the current +directory, does not exist, or is otherwise not currently selected, does nothing. - - + + a #GFile + - - - - - - + Unselects a currently selected filename. If the filename +is not in the current directory, does not exist, or +is otherwise not currently selected, does nothing. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the filename to unselect - - - - - - - - - - - - - - - - - - + Unselects the file referred to by @uri. If the file +is not in the current directory, does not exist, or +is otherwise not currently selected, does nothing. - + + the URI to unselect - - - - - - - - - - - - - - - - - - - + + - + transfer-ownership="none"> + Whether a file chooser not in %GTK_FILE_CHOOSER_ACTION_OPEN mode +will offer the user to create new folders. + + Whether a file chooser in %GTK_FILE_CHOOSER_ACTION_SAVE mode will present an overwrite confirmation dialog if the user -selects a file name that already exists."> - +selects a file name that already exists. + - - + + - + + + + + + + + + - + transfer-ownership="none"> + - - + + - - + + - - + + - - - - - - - - - - - - - + This signal gets emitted whenever it is appropriate to present a confirmation dialog when the user has selected a file name that already exists. The signal only gets emitted when the file chooser is in %GTK_FILE_CHOOSER_ACTION_SAVE mode. @@ -22859,7 +20305,7 @@ On the other hand, if it determines that the stock confirmation dialog should be used, it should return %GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM. The following example illustrates this. -<example id="gtkfilechooser-confirmation"> +<example id="gtkfilechooser-confirmation"> <title>Custom confirmation</title> <programlisting> static GtkFileChooserConfirmation @@ -22879,54 +20325,46 @@ return GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM; // fall back to the default dialog ... chooser = gtk_file_chooser_dialog_new (...); gtk_file_chooser_set_do_overwrite_confirmation (GTK_FILE_CHOOSER (dialog), TRUE); -g_signal_connect (chooser, "confirm-overwrite", +g_signal_connect (chooser, "confirm-overwrite", G_CALLBACK (confirm_overwrite_callback), NULL); if (gtk_dialog_run (chooser) == GTK_RESPONSE_ACCEPT) save_to_file (gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (chooser)); gtk_widget_destroy (chooser); </programlisting> </example> -action to take after emitting the signal." - version="2.8"> - - +action to take after emitting the signal. + + a #GtkFileChooserConfirmation value that indicates which + - - + + - - + + - - + + - - + + + Describes whether a #GtkFileChooser is being used to open existing files +or to save to a possibly new file. + - - + Creates a new file-selecting button widget. + + a new button widget. + + the title of the browse dialog. + the open mode for the widget. - - - - - - - - - - - - - - - - + Creates a #GtkFileChooserButton widget which uses @dialog as its file-picking window. Note that @dialog must be a #GtkDialog (or subclass) which implements the #GtkFileChooser interface and must not have %GTK_DIALOG_DESTROY_WITH_PARENT set. Also note that the dialog needs to have its confirmative button added with response %GTK_RESPONSE_ACCEPT or %GTK_RESPONSE_OK in -order for the button to take over the file selected in the dialog." - version="2.6"> - - +order for the button to take over the file selected in the dialog. + + a new button widget. + + the widget to use as dialog + + Returns whether the button grabs focus when it is clicked with the mouse. +See gtk_file_chooser_button_set_focus_on_click(). +the mouse. + + %TRUE if the button grabs focus when it is clicked with + + + + Retrieves the title of the browse dialog used by @button. The returned value +should not be modified or freed. + a pointer to the browse dialog's title. - - - - - - - - - - - - - - - + Retrieves the width in characters of the @button widget's entry and/or label. - - - - - - - - - - - + an integer width (in characters) that the button will use to size itself. + + Sets whether the button will grab focus when it is clicked with the mouse. +Making mouse clicks not grab focus is useful in places like toolbars where +you don't want the keyboard focus removed from the main area of the +application. - + whether the button grabs focus when clicked with the mouse + + + + + + Modifies the @title of the browse dialog used by @button. + + + + + + the new browse dialog title. + + + + + + Sets the width (in characters) that @button will use to @n_chars. + + + + + + the new width, in characters. + @@ -23086,27 +20515,31 @@ application." readable="0" writable="1" construct-only="1" - doc="Instance of the #GtkFileChooserDialog associated with the button."> - + transfer-ownership="none"> + Instance of the #GtkFileChooserDialog associated with the button. + - + transfer-ownership="none"> + Whether the #GtkFileChooserButton button grabs focus when it is clicked +with the mouse. + - + transfer-ownership="none"> + Title to put on the #GtkFileChooserDialog associated with the button. + - + transfer-ownership="none"> + The width of the entry and label inside the button, in characters. + @@ -23115,13 +20548,12 @@ with the mouse."> - + The ::file-set signal is emitted when the user selects a file. Note that this signal is only emitted when the <emphasis>user</emphasis> -changes the file." - version="2.12"> - - +changes the file. + + @@ -23132,7 +20564,7 @@ changes the file." - + @@ -23144,43 +20576,41 @@ changes the file." - + - + - + - + - + - + - + + c:type="GtkFileChooserButtonPrivate" + disguised="1"> + Used as a return value of handlers for the +#GtkFileChooser::confirm-overwrite signal of a #GtkFileChooser. This +value determines whether the file chooser will present the stock +confirmation dialog, accept the user's choice of a filename, or +let the user choose another filename. + - - - - - - - - - - - - - - - - - - - - - - - - - + introspectable="0"> + Creates a new #GtkFileChooserDialog. This function is analogous to +gtk_dialog_new_with_buttons(). + + a new #GtkFileChooserDialog + - + + Title of the dialog, or %NULL - + + Transient parent of the dialog, or %NULL + Open or save mode for the dialog - - - + allow-none="1"> + stock ID or text to go in the first button, or %NULL @@ -23298,16 +20686,16 @@ to load files." + c:type="GtkFileChooserDialogPrivate" + disguised="1"> + These identify the various errors that can occur while calling +#GtkFileChooser functions. + - - + Creates a new #GtkFileChooserWidget. This is a file chooser widget that can +be embedded in custom windows, and it is the same widget that is used by +#GtkFileChooserDialog. + + a new #GtkFileChooserWidget + + Open or save mode for the widget - - - - - - - - - - - - - @@ -23388,158 +20758,163 @@ custom windows and it is the same widget that is used by + c:type="GtkFileChooserWidgetPrivate" + disguised="1"> - + Creates a new #GtkFileFilter with no rules added to it. +Such a filter doesn't accept any files, so is not particularly useful until you add rules with gtk_file_filter_add_mime_type(), gtk_file_filter_add_pattern(), or gtk_file_filter_add_custom(). To create a filter that accepts any file, use: |[ GtkFileFilter *filter = gtk_file_filter_new (); -gtk_file_filter_add_pattern (filter, "*"); -]|" - version="2.4"> - +gtk_file_filter_add_pattern (filter, "*"); +]| + + a new #GtkFileFilter - + Adds rule to a filter that allows files based on a custom callback +function. The bitfield @needed which is passed in provides information +about what sorts of information that the filter function needs; +this allows GTK+ to avoid retrieving expensive information when +it isn't needed by the filter. - + bitfield of flags indicating the information that the custom filter function needs. + + + - + scope="notified" + closure="2" + destroy="3"> + callback function; if the function returns %TRUE, then the file will be displayed. + + + + data to pass to @func + + + + function to call to free @data when it is no longer needed. + - - - - - + Adds a rule allowing a given mime type to @filter. + name of a MIME type + Adds a rule allowing a shell style glob to a filter. + a shell style glob + Adds a rule allowing image files in the formats supported +by GdkPixbuf. - - - - - - - - - - - - - - - - - - - - - - - - + Tests whether a file should be displayed according to @filter. The #GtkFileFilterInfo structure @filter_info should include the fields returned from gtk_file_filter_get_needed(). This function will not typically be used by applications; it is intended principally for use in the implementation of -#GtkFileChooser." - version="2.4"> +#GtkFileChooser. - + %TRUE if the file should be displayed + + a #GtkFileFilterInfo structure containing information about a file. + + Gets the human-readable name for the filter. See gtk_file_filter_set_name(). +or %NULL. This value is owned by GTK+ and must not +be modified or freed. + + The human-readable name of the filter, + + + + + Gets the fields that need to be filled in for the structure +passed to gtk_file_filter_filter() +This function will not typically be used by applications; it +is intended principally for use in the implementation of +#GtkFileChooser. +calling gtk_file_filter_filter() + + bitfield of flags indicating needed fields when + + + + + Sets the human-readable name of the filter; this is the string +that will be displayed in the file selector user interface if +there is a selectable list of filters. + + + + + + the human-readable-name for the filter, or %NULL to remove any existing name. + + + + - + - + @@ -23592,228 +20967,8 @@ is intended principally for use in the implementation of - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - glib:type-struct="FixedClass"> + - - + + - - - - - - - - - - - - - - - - @@ -23851,48 +20991,34 @@ file list"> - + - + - + - - + + + + + + + + - - - - - - - + + @@ -23900,10 +21026,10 @@ See gtk_fixed_set_has_window()." - + - + + + - + - - - + + + Creates a new font picker widget. + + a new font picker widget. + - - + Creates a new font picker widget. + + a new font picker widget. + + Name of font to display in font selection dialog - + Retrieves the name of the currently selected font. This name includes +style and size information as well. If you want to render something +with the font, use this string with pango_font_description_from_string() . +If you're interested in peeking certain values (family name, +style, size, weight) just query these properties from the +#PangoFontDescription object. + an internal copy of the font name which must not be freed. - + Returns whether the font size will be shown in the label. - + whether the font size will be shown in the label. + + + + + Returns whether the name of the font style will be shown in the label. + + whether the font style will be shown in the label. + + + + + Retrieves the title of the font selection dialog. + + an internal copy of the title string which must not be freed. + - - - - - + Returns whether the selected font is used in the label. - + whether the selected font is used in the label. + - - - - - - - - - - + Returns whether the selected size is used in the label. - - - - - - - - - - - - - - - - + whether the selected size is used in the label. + - - + Sets or updates the currently-displayed font in font picker dialog. +font selection dialog exists, otherwise %FALSE. + + Return value of gtk_font_selection_dialog_set_font_name() if the + + Name of font to display in font selection dialog - - - - - - - - - - - - - - - - - - - - + If @show_size is %TRUE, the font size will be displayed along with the name of the selected font. - + %TRUE if font size should be displayed in dialog. + + + + + + If @show_style is %TRUE, the font style will be displayed along with name of the selected font. + + + + + + %TRUE if font style should be displayed in label. + + + + + + Sets the title for the font selection dialog. + + + + + + a string containing the font selection dialog title + + + + + + If @use_font is %TRUE, the font name will be written using the selected font. + + + + + + If %TRUE, font name will be written using font chosen. + + + + + + If @use_size is %TRUE, the font name will be written using the selected size. + + + + + + If %TRUE, font name will be written using the selected size. + - + transfer-ownership="none"> + The name of the currently selected font. + - + transfer-ownership="none"> + If this property is set to %TRUE, the selected font size will be shown +in the label. For a more WYSIWYG way to show the selected size, see the +::use-size property. + - + transfer-ownership="none"> + If this property is set to %TRUE, the name of the selected font style +will be shown in the label. For a more WYSIWYG way to show the selected +style, see the ::use-font property. + - + transfer-ownership="none"> + The title of the font selection dialog. + - + transfer-ownership="none"> + If this property is set to %TRUE, the label will be drawn +in the selected font. + - + transfer-ownership="none"> + If this property is set to %TRUE, the label will be drawn +with the selected font size. + @@ -24123,16 +21273,15 @@ with the selected font size."> - + The ::font-set signal is emitted when the user selects a font. +When handling this signal, use gtk_font_button_get_font_name() to find out which font was just selected. Note that this signal is only emitted when the <emphasis>user</emphasis> changes the font. If you need to react to programmatic font changes -as well, use the notify::font-name signal." - version="2.4"> - - +as well, use the notify::font-name signal. + + @@ -24143,7 +21292,7 @@ as well, use the notify::font-name signal." - + @@ -24154,38 +21303,41 @@ as well, use the notify::font-name signal." - - + + - - + + - - + + - - + + - + - - - + + + Creates a new #GtkFontSelection. + + a n ew #GtkFontSelection + - - - + Gets the #PangoFontFace representing the selected font group +details (i.e. family, slant, weight, width, etc). +selected font group details. The returned object is owned by + + A #PangoFontFace representing the + - - - - - - - - - - - - - - - - + This returns the #GtkTreeView which lists all styles available for +the selected font. For example, 'Regular', 'Bold', etc. + + A #GtkWidget that is part of @fontsel - + Gets the #PangoFontFamily representing the selected font family. +selected font family. Font families are a collection of font +faces. The returned object is owned by @fontsel and must not +be modified or freed. + + A #PangoFontFamily representing the - + This returns the #GtkTreeView that lists font families, for +example, 'Sans', 'Serif', etc. + + A #GtkWidget that is part of @fontsel + + + + + Gets the currently-selected font name. +Note that this can be a different string than what you set with +gtk_font_selection_set_font_name(), as the font selection widget may +normalize font names and thus return a string with a different structure. +For example, "Helvetica Italic Bold 12" could be normalized to +"Helvetica Bold Italic 12". Use pango_font_description_equal() +if you want to compare two font descriptions. +no font is selected. You must free this string with g_free(). - + A string with the name of the current font, or %NULL if + + + + + This returns the #GtkEntry used to display the font as a preview. + + A #GtkWidget that is part of @fontsel + + + + + Gets the text displayed in the preview area. +This string is owned by the widget and should not be +modified or freed + + the text displayed in the preview area. + + The selected font size. +or -1 if no font size is selected. - + A n integer representing the selected font size, + - - - + + This returns the #GtkEntry used to allow the user to edit the font +number manually instead of selecting it from the list of font sizes. + + A #GtkWidget that is part of @fontsel + - - - + + This returns the #GtkTreeeView used to list font sizes. + + A #GtkWidget that is part of @fontsel + + c:identifier="gtk_font_selection_set_font_name"> + Sets the currently-selected font. +Note that the @fontsel needs to know the screen in which it will appear +for this to work; this can be guaranteed by simply making sure that the +such font exists or if the @fontsel doesn't belong to a particular +screen yet. - + %TRUE if the font could be set successfully; %FALSE if no + + a font name like "Helvetica 12" or "Times Bold 18" - - - - - + c:identifier="gtk_font_selection_set_preview_text"> + Sets the text displayed in the preview area. +The @text is used to show how the selected font looks. + the text to display in the preview area - - + + - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + @@ -24427,6 +21541,7 @@ The @text is used to show how the selected font looks."> glib:type-struct="FontSelectionDialogClass"> - - - + + + Creates a new #GtkFontSelectionDialog. + + a new #GtkFontSelectionDialog + + the title of the dialog window - - - - - - - - - - - + Gets the 'Cancel' button. +for the 'Cancel' button. + + the #GtkWidget used in the dialog + Gets the currently-selected font name. +Note that this can be a different string than what you set with gtk_font_selection_dialog_set_font_name(), as the font selection widget -may normalize font names and thus return a string with a different -structure. For example, "Helvetica Italic Bold 12" could be normalized -to "Helvetica Bold Italic 12". Use pango_font_description_equal() +may normalize font names and thus return a string with a different +structure. For example, "Helvetica Italic Bold 12" could be normalized +to "Helvetica Bold Italic 12". Use pango_font_description_equal() if you want to compare two font descriptions. -font is selected. You must free this string with g_free()."> +font is selected. You must free this string with g_free(). + A string with the name of the current font, or %NULL if no - - - + + Retrieves the #GtkFontSelection widget embedded in the dialog. + + the embedded #GtkFontSelection + + + + + Gets the 'OK' button. +for the 'OK' button. + + the #GtkWidget used in the dialog + + + + + Gets the text displayed in the preview area. +This string is owned by the widget and should not be +modified or freed + + the text displayed in the preview area. + + c:identifier="gtk_font_selection_dialog_set_font_name"> + Sets the currently selected font. - + %TRUE if the font selected in @fsd is now the + + a font name like "Helvetica 12" or "Times Bold 18" - - - - - + c:identifier="gtk_font_selection_dialog_set_preview_text"> + Sets the text displayed in the preview area. + the text to display in the preview area @@ -24532,29 +21647,9 @@ modified or freed"> - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + + + + + glib:type-struct="FrameClass"> - - - + + + Creates a new #GtkFrame, with optional label @label. +If @label is %NULL, the label is omitted. + + a new #GtkFrame widget + + the text to use as the label of the frame @@ -24623,157 +21729,130 @@ If @label is %NULL, the label is omitted."> - - - - - - - - - - - + If the frame's label widget is a #GtkLabel, returns the text in the label widget. (The frame will have a #GtkLabel for the label widget if a non-%NULL argument was passed to gtk_frame_new().) was no label widget or the lable widget was not a #GtkLabel. This string is owned by GTK+ and -must not be modified or freed."> +must not be modified or freed. + the text in the label, or %NULL if there - + + Retrieves the X and Y alignment of the frame's label. See +gtk_frame_set_label_align(). - - + + location to store X alignment of frame's label, or %NULL + + + + location to store X alignment of frame's label, or %NULL + - + c:identifier="gtk_frame_get_label_widget"> + Retrieves the label widget for the frame. See +gtk_frame_set_label_widget(). + + the label widget, or %NULL if there is none. - + + Retrieves the shadow type of the frame. See +gtk_frame_set_shadow_type(). + + the current shadow type of the frame. + + + + + Sets the text of the label. If @label is %NULL, +the current label is removed. + + + + + + the text to use as the label of the frame + + + + + + Sets the alignment of the frame widget's label. The +default values for a newly created frame are 0.0 and 0.5. - + The position of the label along the top edge of the widget. A value of 0.0 represents left alignment; 1.0 represents right alignment. + - + The y alignment of the label. A value of 0.0 aligns under the frame; 1.0 aligns above the frame. If the values are exactly 0.0 or 1.0 the gap in the frame won't be painted because the label will be completely above or below the frame. + - + + Sets the label widget for the frame. This is the widget that +will appear embedded in the top edge of the frame as a +title. - - - - - + + the new label widget + - + + Sets the shadow type for @frame. + the new #GtkShadowType - - - - - - - + + - - + + - - + + - - + + - - - - - + + - - - - - - - - - - - - - - + + - + @@ -24799,90 +21877,23 @@ gtk_frame_set_shadow_type()."> + + + Defines a function pointer. - + #gint + - + #gpointer + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - + Creates a new #GtkHBox. + + a new #GtkHBox. + - + %TRUE if all children are to be given equal space allotments. + - + the number of pixels to place by default between children. + @@ -24916,6 +21932,7 @@ gtk_frame_set_shadow_type()."> + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -24975,6 +21959,7 @@ gtk_frame_set_shadow_type()."> + - - + + @@ -25000,6 +21986,7 @@ gtk_frame_set_shadow_type()."> + - - + + @@ -25025,6 +22013,7 @@ gtk_frame_set_shadow_type()."> glib:type-struct="HSVClass"> - - - + + + Creates a new HSV color selector. + + A newly-created HSV color selector. + - + + Converts a color from HSV space to RGB. +Input values must be in the [0.0, 1.0] range; +output values will be in the same range. - + Hue + - + Saturation + - + Value + - - + + Return value for the red component + - - + + Return value for the green component + - - + + Return value for the blue component + - + + Queries the current color in an HSV color selector. +Returned values will be in the [0.0, 1.0] range. - + Return value for the hue + - + Return value for the saturation + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Return value for the value + + Queries the size and ring width of an HSV color selector. - - + + Return value for the diameter of the hue ring + - - + + Return value for the width of the hue ring + + An HSV color selector can be said to be adjusting if multiple rapid +changes are being made to its value, for example, when the user is +adjusting the value with the mouse. This function queries whether the HSV color selector is being adjusted or not. since they may be transitory, or %FALSE if they should consider -the color value status to be final." - version="2.14"> +the color value status to be final. - + %TRUE if clients can ignore changes to the color value, + + + Sets the current color in an HSV color selector. +Color component values must be in the [0.0, 1.0] range. + + + + + + Hue + + + + Saturation + + + + Value + + + + + + Sets the size and ring width of an HSV color selector. + + + + + + Diameter for the hue ring + + + + Width of the hue ring + + + + - - + + - - + + - - + + - + @@ -25186,7 +22184,7 @@ the color value status to be final." - + @@ -25198,7 +22196,7 @@ the color value status to be final." - + @@ -25212,36 +22210,39 @@ the color value status to be final." - - + + - - + + - - + + - - + + + + + - - + + @@ -25261,28 +22263,30 @@ the color value status to be final." + Creates a new horizontal scale widget that lets the user input a number between @min and @max (including @min and @max) with the -increment @step. @step must be nonzero; it's the distance the +increment @step. @step must be nonzero; it's the distance the slider moves when using the arrow keys to adjust the scale value. Note that the way in which the precision is derived works best if @step is a power of ten. If the resulting precision is not suitable for your -needs, use gtk_scale_set_digits() to correct it."> - - +needs, use gtk_scale_set_digits() to correct it. + + a new #GtkHScale + - + minimum value + - + maximum value + - - + + step increment (tick size) used with keyboard shortcuts + @@ -25298,6 +22302,7 @@ needs, use gtk_scale_set_digits() to correct it."> - - - + + + Creates a new horizontal scrollbar. + + the new #GtkHScrollbar + + allow-none="1"> + the #GtkAdjustment to use, or %NULL to create a new adjustment @@ -25333,6 +22339,7 @@ needs, use gtk_scale_set_digits() to correct it."> + - - + + @@ -25358,6 +22366,7 @@ needs, use gtk_scale_set_digits() to correct it."> glib:type-struct="HandleBoxClass"> + - - + + - + + Whether the handlebox's child is currently detached. - + %TRUE if the child is currently detached, otherwise %FALSE + + + + + Gets the handle position of the handle box. See +gtk_handle_box_set_handle_position(). + + the current handle position. + - - - - - - + c:identifier="gtk_handle_box_get_shadow_type"> + Gets the type of shadow drawn around the handle box. See +gtk_handle_box_set_shadow_type(). + + the type of shadow currently drawn around the handle box. + + Gets the edge used for determining reattachment of the handle box. See +gtk_handle_box_set_snap_edge(). +is determined (as per default) from the handle position. + + the edge used for determining reattachment, or (GtkPositionType)-1 if this + + + @@ -25400,13 +22427,16 @@ gtk_handle_box_set_shadow_type()."> - - - + + + + + + + + @@ -25418,100 +22448,44 @@ gtk_handle_box_set_handle_position()."> - - - - - - - - - - - - + + - - + + - - + + - - + + - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - - + + - + @@ -25523,7 +22497,7 @@ is determined (as per default) from the handle position."> - + @@ -25538,7 +22512,7 @@ is determined (as per default) from the handle position."> - + @@ -25552,297 +22526,103 @@ is determined (as per default) from the handle position."> - - + + - - + + - - + + - - + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Allow an input method to internally handle key press and release +events. If this function returns %TRUE, then no further processing +should be done for this key event. - + %TRUE if the input method handled the key event. + + the key event + Notify the input method that the widget to which this +input context corresponds has gained focus. The input method +may, for example, change the displayed feedback to reflect +this change. + Notify the input method that the widget to which this +input context corresponds has lost focus. The input method +may, for example, change the displayed feedback or reset the contexts +state to reflect this change. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieve the current preedit string for the input context, and a list of attributes to apply to the string. This string should be displayed inserted at the insertion -point."> +point. - - - + location to store the retrieved string. The string retrieved must be freed with g_free (). + + location to store the retrieved attribute list. When you are done with this list, you must unreference it with pango_attr_list_unref(). - + location to store position of cursor (in characters) within the preedit string. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves context around the insertion point. Input methods typically want context in order to constrain input text based on existing text; this is important for languages such as Thai where only some sequences of characters are allowed. @@ -25853,27 +22633,100 @@ is available, up to an entire paragraph, by calling gtk_im_context_set_surrounding(). Note that there is no obligation for a widget to respond to the ::retrieve_surrounding signal, so input methods must be prepared to function without context. -you must free the result stored in *text."> +you must free the result stored in *text. - + %TRUE if surrounding text was provided; in this case + - - - + location to store a UTF-8 encoded string of text holding context around the insertion point. If the function returns %TRUE, then you must free the result stored in this location with g_free(). + - - + + location to store byte index of the insertion cursor within @text. + - + + + Notify the input method that a change such as a change in cursor +position has been made. This will typically cause the input +method to clear the preedit state. + + + + + + Set the client window for the input context; this is the +#GdkWindow in which the input appears. This window is +used in order to correctly position status windows, and may +also be used for purposes internal to the input method. + + + + + + the client window. This may be %NULL to indicate that the previous client window no longer exists. + + + + + + Notify the input method that a change in cursor +position has been made. The location is relative to the client +window. + + + + + + new location + + + + + + Sets surrounding context around the insertion point and preedit +string. This function is expected to be called in response to the +GtkIMContext::retrieve_surrounding signal, and will likely have no +effect if called at other times. + + + + + + text surrounding the insertion point, as UTF-8. the preedit string should not be included within + + + + the length of @text, or -1 if @text is nul-terminated + + + + the byte index of the insertion cursor within @text. + + + + + + Sets whether the IM context should use the preedit string +to display feedback. If @use_preedit is FALSE (default +is TRUE), then the IM context may use some other method to display +feedback, such as displaying it in a child of the root window. + + + + + + whether the IM context should use the preedit string. + + + + + Asks the widget that the input context is attached to to delete characters around the cursor position by emitting the GtkIMContext::delete_surrounding signal. Note that @offset and @n_chars are in characters not in bytes which differs from the usage other @@ -25886,133 +22739,265 @@ that even if the signal was handled, the input context might not have deleted all the characters that were requested to be deleted. This function is used by an input method that wants to make subsitutions in the existing text in response to new input. It is -not useful for applications."> +not useful for applications. - + %TRUE if the signal was handled. + - + offset from cursor position in chars; a negative value means start before the cursor. + - + number of characters to delete. + + + + + + Allow an input method to internally handle key press and release +events. If this function returns %TRUE, then no further processing +should be done for this key event. + + %TRUE if the input method handled the key event. + + + + + the key event + + + + + + Notify the input method that the widget to which this +input context corresponds has gained focus. The input method +may, for example, change the displayed feedback to reflect +this change. + + + + + + Notify the input method that the widget to which this +input context corresponds has lost focus. The input method +may, for example, change the displayed feedback or reset the contexts +state to reflect this change. + + + + + + Retrieve the current preedit string for the input context, +and a list of attributes to apply to the string. +This string should be displayed inserted at the insertion +point. + + + + + + location to store the retrieved string. The string retrieved must be freed with g_free (). + + + + location to store the retrieved attribute list. When you are done with this list, you must unreference it with pango_attr_list_unref(). + + + + location to store position of cursor (in characters) within the preedit string. + + + + + + Retrieves context around the insertion point. Input methods +typically want context in order to constrain input text based on +existing text; this is important for languages such as Thai where +only some sequences of characters are allowed. +This function is implemented by emitting the +GtkIMContext::retrieve_surrounding signal on the input method; in +response to this signal, a widget should provide as much context as +is available, up to an entire paragraph, by calling +gtk_im_context_set_surrounding(). Note that there is no obligation +for a widget to respond to the ::retrieve_surrounding signal, so input +methods must be prepared to function without context. +you must free the result stored in *text. + + %TRUE if surrounding text was provided; in this case + + + + + location to store a UTF-8 encoded string of text holding context around the insertion point. If the function returns %TRUE, then you must free the result stored in this location with g_free(). + + + + location to store byte index of the insertion cursor within @text. + + + + + + Notify the input method that a change such as a change in cursor +position has been made. This will typically cause the input +method to clear the preedit state. + + + + + + Set the client window for the input context; this is the +#GdkWindow in which the input appears. This window is +used in order to correctly position status windows, and may +also be used for purposes internal to the input method. + + + + + + the client window. This may be %NULL to indicate that the previous client window no longer exists. + + + + + + Notify the input method that a change in cursor +position has been made. The location is relative to the client +window. + + + + + + new location + + + + + + Sets surrounding context around the insertion point and preedit +string. This function is expected to be called in response to the +GtkIMContext::retrieve_surrounding signal, and will likely have no +effect if called at other times. + + + + + + text surrounding the insertion point, as UTF-8. the preedit string should not be included within + + + + the length of @text, or -1 if @text is nul-terminated + + + + the byte index of the insertion cursor within @text. + + + + + + Sets whether the IM context should use the preedit string +to display feedback. If @use_preedit is FALSE (default +is TRUE), then the IM context may use some other method to display +feedback, such as displaying it in a child of the root window. + + + + + + whether the IM context should use the preedit string. + - + The ::commit signal is emitted when a complete input sequence has been entered by the user. This can be a single character -immediately after a key press or the final result of preediting."> - - +immediately after a key press or the final result of preediting. + + - - + + the completed character(s) entered by the user + - - - + + The ::delete-surrounding signal is emitted when the input method +needs to delete all or part of the context surrounding the cursor. + + %TRUE if the signal was handled. + - - + + the character offset from the cursor position of the text to be deleted. A negative value indicates a position before the cursor. + - - + + the number of characters to be deleted + - + The ::preedit-changed signal is emitted whenever the preedit sequence currently being entered has changed. It is also emitted at the end of a preedit sequence, in which case -gtk_im_context_get_preedit_string() returns the empty string."> - - +gtk_im_context_get_preedit_string() returns the empty string. + + - - - + + The ::preedit-end signal is emitted when a preediting sequence +has been completed or canceled. + + - - - + + The ::preedit-start signal is emitted when a new preediting sequence +starts. + + - + The ::retrieve-surrounding signal is emitted when the input method requires the context surrounding the cursor. The callback should set the input method surrounding context by calling the -gtk_im_context_set_surrounding() method."> - - +gtk_im_context_set_surrounding() method. + + %TRUE if the signal was handled. + + glib:is-gtype-struct-for="IMContext"> - + - + @@ -26024,7 +23009,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26036,7 +23021,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26048,7 +23033,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26063,9 +23048,9 @@ by the subsequent invocation of @get_surrounding."> - + - + @@ -26075,25 +23060,25 @@ by the subsequent invocation of @get_surrounding."> - + - + - + - + - + @@ -26101,14 +23086,15 @@ by the subsequent invocation of @get_surrounding."> - + + the client window. This may be %NULL to indicate that the previous client window no longer exists. - + @@ -26117,38 +23103,39 @@ by the subsequent invocation of @get_surrounding."> - - - + location to store the retrieved string. The string retrieved must be freed with g_free (). + + location to store the retrieved attribute list. When you are done with this list, you must unreference it with pango_attr_list_unref(). - - + + location to store position of cursor (in characters) within the preedit string. + - + - + %TRUE if the input method handled the key event. + + the key event - + @@ -26160,7 +23147,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26172,7 +23159,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26184,7 +23171,7 @@ by the subsequent invocation of @get_surrounding."> - + @@ -26193,13 +23180,14 @@ by the subsequent invocation of @get_surrounding."> + new location - + @@ -26208,13 +23196,14 @@ by the subsequent invocation of @get_surrounding."> - + whether the IM context should use the preedit string. + - + @@ -26223,86 +23212,86 @@ by the subsequent invocation of @get_surrounding."> + text surrounding the insertion point, as UTF-8. the preedit string should not be included within - + the length of @text, or -1 if @text is nul-terminated + - + the byte index of the insertion cursor within @text. + - + - + %TRUE if surrounding text was provided; in this case + - - - + location to store a UTF-8 encoded string of text holding context around the insertion point. If the function returns %TRUE, then you must free the result stored in this location with g_free(). + - - + + location to store byte index of the insertion cursor within @text. + - - + + - - + + - - + + - - + + - - + + - - + + - + + Bookkeeping information about a loadable input method. @@ -26320,6 +23309,7 @@ Bookkeeping information about a loadable input method."> glib:type-struct="IMContextSimpleClass"> - + - + Adds an additional table to search to the input context. Each row of the table consists of @max_seq_len key symbols followed by two #guint16 interpreted as the high and low words of a #gunicode value. Tables are searched starting from the last added. The table must be sorted in dictionary order on the numeric value of the key symbol fields. (Values beyond -the length of the sequence should be zero.)"> +the length of the sequence should be zero.) - - + + the table + - + Maximum length of a sequence in the table (cannot be greater than #GTK_MAX_COMPOSE_LEN) + - + number of sequences in the table + - - - - - - - - - - - - - - - - - - - + + + + - + + Creates a new #GtkIMMulticontext. - + a new #GtkIMMulticontext. + + Add menuitems for various available input methods to a menu; the menuitems, when selected, will switch the input method -for the context and the global default input method."> +for the context and the global default input method. + a #GtkMenuShell + Gets the id of the currently active slave of the @context. + the id of the currently active slave + Sets the context id for @context. +This causes the currently active slave of @context to be +replaced by the slave corresponding to the new context id. + the id to use @@ -26440,15 +23423,9 @@ replaced by the slave corresponding to the new context id." - - - - + - - - - - + + - - + + - - + + - - + + - + - + - - + + - + Creates a new #GtkIconFactory. An icon factory manages a collection of #GtkIconSet<!-- -->s; a #GtkIconSet manages a set of variants of a particular icon (i.e. a #GtkIconSet contains variants for different sizes and widget states). Icons in an icon factory are named by a stock ID, which is a simple string identifying the icon. Each #GtkStyle has a list of #GtkIconFactory<!-- -->s derived from the current theme; those icon factories are consulted first when searching for -an icon. If the theme doesn't set a particular icon, GTK+ looks for +an icon. If the theme doesn't set a particular icon, GTK+ looks for the icon in a list of default icon factories, maintained by gtk_icon_factory_add_default() and gtk_icon_factory_remove_default(). Applications with icons should add a default icon factory with their icons, which will allow -themes to override the icons for the application."> +themes to override the icons for the application. + a new #GtkIconFactory + Looks for an icon in the list of default icon factories. For display to the user, you should use gtk_style_lookup_icon_set() on the #GtkStyle for the widget that will display the icon, instead of using this function directly, so that themes are taken into -account."> +account. + a #GtkIconSet, or %NULL + an icon name - + Adds the given @icon_set to the icon factory, under the name +e.g. "myapp-whatever-icon". Normally applications create a #GtkIconFactory, then add it to the list of default factories with gtk_icon_factory_add_default(). Then they pass the @stock_id to widgets such as #GtkImage to display the icon. Themes can provide -an icon with the same name (such as "myapp-whatever-icon") to -override your application's default icons. If an icon already +an icon with the same name (such as "myapp-whatever-icon") to +override your application's default icons. If an icon already existed in @factory for @stock_id, it is unreferenced and replaced -with the new @icon_set."> +with the new @icon_set. + icon name + icon set - - - - - - - - - - - + Adds an icon factory to the list of icon factories searched by gtk_style_lookup_icon_set(). This means that, for example, gtk_image_new_from_stock() will be able to find icons in @factory. There will normally be an icon factory added for each library or application that comes with icons. The default icon factories -can be overridden by themes."> +can be overridden by themes. + + Looks up @stock_id in the icon factory, returning an icon set +if found, otherwise %NULL. For display to the user, you should +use gtk_style_lookup_icon_set() on the #GtkStyle for the +widget that will display the icon, instead of using this +function directly, so that themes are taken into account. + + icon set of @stock_id. + + + + + an icon name + + + + + Removes an icon factory from the list of default icon factories. Not normally used; you might use it for a library that -can be unloaded or shut down."> +can be unloaded or shut down. @@ -26632,8 +23615,8 @@ can be unloaded or shut down."> - - + + - - + + - - + + - - + + - - + + + + + glib:get-type="gtk_icon_info_get_type" + c:symbol-prefix="icon_info"> + Creates a #GtkIconInfo for a #GdkPixbuf. + a #GtkIconInfo + a #GtkIconTheme + the pixbuf to wrap in a #GtkIconInfo - + + Make a copy of a #GtkIconInfo. + the new GtkIconInfo - + + Free a #GtkIconInfo and associated information + + Fetches the set of attach points for an icon. An attach point +is a location in the icon that can be used as anchor points for attaching +emblems or overlays to the icon. + + %TRUE if there are any attach points for the icon. + + + + + location to store pointer to an array of points, or %NULL free the array of points with g_free(). + + + + + + location to store the number of points in @points, or %NULL + + + + + Gets the base size for the icon. The base size is a size for the icon that was specified by the icon theme creator. This may be different than the actual size of image; an example of @@ -26717,45 +23737,80 @@ this is small emblem icons that can be attached to a larger icon. These icons will be given the same base size as the larger icons to which they are attached. -size is known for the icon." - version="2.4"> +size is known for the icon. - + the base size, or 0, if no base + + + Gets the built-in image for this icon, if any. To allow +GTK+ to use built in icon images, you must pass the +%GTK_ICON_LOOKUP_USE_BUILTIN to +gtk_icon_theme_lookup_icon(). +extra reference is added to the returned pixbuf, so if +you want to keep it around, you must use g_object_ref(). +The returned image must not be modified. + + the built-in image pixbuf, or %NULL. No + + + + + Gets the display name for an icon. A display name is a +string to be used in place of the icon name in a user +visible context like a list of icons. +the icon doesn't have a specified display name. This value +is owned @icon_info and must not be modified or free. + + the display name for the icon or %NULL, if + + + + + Gets the coordinates of a rectangle within the icon +that can be used for display of information such +as a preview of the contents of a text file. +See gtk_icon_info_set_raw_coordinates() for further +information about the coordinate system. + + %TRUE if the icon has an embedded rectangle + + + + + #GdkRectangle in which to store embedded rectangle coordinates; coordinates are only stored when this function returns %TRUE. + + + + + Gets the filename for the icon. If the %GTK_ICON_LOOKUP_USE_BUILTIN flag was passed to gtk_icon_theme_lookup_icon(), there may be no filename if a builtin icon is returned; in this case, you should use gtk_icon_info_get_builtin_pixbuf(). if gtk_icon_info_get_builtin_pixbuf() should be used instead. The return value is owned by -GTK+ and should not be modified or freed." - version="2.4"> +GTK+ and should not be modified or freed. + the filename for the icon, or %NULL - - - - - + Renders an icon previously looked up in an icon theme using gtk_icon_theme_lookup_icon(); the size will be based on the size passed to gtk_icon_theme_lookup_icon(). Note that the resulting pixbuf may not be exactly this size; an icon theme may have icons @@ -26766,20 +23821,99 @@ up too far. (This maintains sharpness.). This behaviour can be changed by passing the %GTK_ICON_LOOKUP_FORCE_SIZE flag when obtaining the #GtkIconInfo. If this flag has been specified, the pixbuf returned by this function will be scaled to the exact size. -or a new reference to an internal icon, so you must not modify -the icon. Use g_object_unref() to release your reference to the -icon." - version="2.4" - throws="1"> +created icon or a new reference to an internal icon, so you must +not modify the icon. Use g_object_unref() to release your reference +to the icon. + the rendered icon; this may be a newly + + Loads an icon, modifying it to match the system colours for the foreground, +success, warning and error colors provided. If the icon is not a symbolic +one, the function will return the result from gtk_icon_info_load_icon(). +This allows loading symbolic icons that will match the system theme. +Unless you are implementing a widget, you will want to use +g_themed_icon_new_with_default_fallbacks() to load the icon. +As implementation details, the icon loaded needs to be of SVG type, +contain the "symbolic" term as the last component of the icon name, +and use the 'fg', 'success', 'warning' and 'error' CSS styles in the +SVG file itself. +See the <ulink url="http://www.freedesktop.org/wiki/SymbolicIcons">Symbolic Icons spec</ulink> +for more information about symbolic icons. + + a #GdkPixbuf representing the loaded icon + + + + + a #GdkColor representing the foreground color of the icon + + + + a #GdkColor representing the warning color of the icon or %NULL to use the default color + + + + a #GdkColor representing the warning color of the icon or %NULL to use the default color + + + + a #GdkColor representing the error color of the icon or %NULL to use the default color (allow-none) + + + + a #gboolean, returns whether the loaded icon was a symbolic one and whether the @fg color was applied to it. + + + + + + Loads an icon, modifying it to match the system colours for the foreground, +success, warning and error colors provided. If the icon is not a symbolic +one, the function will return the result from gtk_icon_info_load_icon(). +This allows loading symbolic icons that will match the system theme. +See gtk_icon_info_load_symbolic() for more details. + + a #GdkPixbuf representing the loaded icon + + + + + a #GtkStyle to take the colors from + + + + the widget state to use for colors + + + + a #gboolean, returns whether the loaded icon was a symbolic one and whether the @fg color was applied to it. + + + + + Sets whether the coordinates returned by gtk_icon_info_get_embedded_rect() and gtk_icon_info_get_attach_points() should be returned in their original form as specified in the icon theme, instead of scaled appropriately for the pixbuf returned by gtk_icon_info_load_icon(). @@ -26788,94 +23922,25 @@ respect to the unscaled pixmap for PNG and XPM icons, but for SVG icons, they are in a 1000x1000 coordinate space that is scaled to the final size of the icon. You can determine if the icon is an SVG icon by using gtk_icon_info_get_filename(), and seeing if it is non-%NULL -and ends in '.svg'. +and ends in '.svg'. This function is provided primarily to allow compatibility wrappers -for older API's, and is not expected to be useful for applications." - version="2.4"> +for older API's, and is not expected to be useful for applications. - + whether the coordinates of embedded rectangles and attached points should be returned in their original (unscaled) form. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Used to specify options for gtk_icon_theme_lookup_icon() - + + Creates a new #GtkIconSet. A #GtkIconSet represents a single icon in various sizes and widget states. It can provide a #GdkPixbuf for a given size and state on request, and automatically caches some of the rendered #GdkPixbuf objects. Normally you would use gtk_widget_render_icon() instead of -using #GtkIconSet directly. The one case where you'd use +using #GtkIconSet directly. The one case where you'd use #GtkIconSet is to create application-specific icon sets to place in -a #GtkIconFactory."> +a #GtkIconFactory. + a new #GtkIconSet + Creates a new #GtkIconSet with @pixbuf as the default/fallback +source image. If you don't add any additional #GtkIconSource to the icon set, all variants of the icon will be created from @pixbuf, using scaling, pixelation, etc. as required to adjust the icon size -or make the icon look insensitive/prelighted."> +or make the icon look insensitive/prelighted. + a new #GtkIconSet + a #GdkPixbuf - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Icon sets have a list of #GtkIconSource, which they use as base icons for rendering icons in different states and sizes. Icons are scaled, made to look insensitive, etc. in gtk_icon_set_render_icon(), but #GtkIconSet needs base images to @@ -27009,49 +24008,112 @@ work with. The base images and when to use them are described by a #GtkIconSource. This function copies @source, so you can reuse the same source immediately without affecting the icon set. -to Previous Page" icon might point in a different direction in +to Previous Page" icon might point in a different direction in Hebrew and in English; it might look different when insensitive; and it might change size depending on toolbar mode (small/large icons). So a single icon set would contain all those variants of the icon, and you might add a separate source for each one. -You should nearly always add a "default" icon source with all +You should nearly always add a "default" icon source with all fields wildcarded, which will be used as a fallback if no more specific source matches. #GtkIconSet always prefers more specific icon sources to more generic icon sources. The order in which you add the sources to the icon set does not matter. gtk_icon_set_new_from_pixbuf() creates a new icon set with a -default icon source based on the given pixbuf."> +default icon source based on the given pixbuf. + a #GtkIconSource - + + Copies @icon_set by value. + + a new #GtkIconSet identical to the first. + + + + + Obtains a list of icon sizes this icon set can render. The returned +array must be freed with g_free(). - - + caller-allocates="0" + transfer-ownership="full"> + return location for array of sizes + + - - + + location to store number of elements in returned array + + + Increments the reference count on @icon_set. + + @icon_set. + + + + + Renders an icon using gtk_style_render_icon(). In most cases, +gtk_widget_render_icon() is better, since it automatically provides +most of the arguments from the current widget settings. This +function never returns %NULL; if the icon can't be rendered +(perhaps because an image file fails to load), a default "missing +image" icon will be returned instead. + + a #GdkPixbuf to be displayed + + + + + a #GtkStyle associated with @widget, or %NULL + + + + text direction + + + + widget state + + + + icon size. A size of (GtkIconSize)-1 means render at the size of the source and don't scale. + + + + widget that will display the icon, or %NULL. The only use that is typically made of this is to determine the appropriate #GdkScreen. + + + + detail to pass to the theme engine, or %NULL. Note that passing a detail of anything but %NULL will disable caching. + + + + + + Decrements the reference count on @icon_set, and frees memory +if the reference count reaches 0. + + + + - + + Creates a new #GtkIconSource. A #GtkIconSource contains a #GdkPixbuf (or image filename) that serves as the base image for one or more of the icons in a #GtkIconSet, along with a specification for which icons in the icon set will be based on that pixbuf or image file. An icon set contains -a set of icons that represent "the same" logical concept in different states, +a set of icons that represent "the same" logical concept in different states, different global text directions, and different sizes. -So for example a web browser's "Back to Previous Page" icon might +So for example a web browser's "Back to Previous Page" icon might point in a different direction in Hebrew and in English; it might look different when insensitive; and it might change size depending on toolbar mode (small/large icons). So a single icon set would @@ -27111,39 +24173,161 @@ gtk_icon_set_new_from_pixbuf() handles this case; if you only have one source pixbuf, just use that function. If you want to use a different base pixbuf for different icon variants, you create multiple icon sources, mark which variants -they'll be used to create, and add them to the icon set with +they'll be used to create, and add them to the icon set with gtk_icon_set_add_source(). By default, the icon source has all parameters wildcarded. That is, the icon source will be used as the base icon for any desired text -direction, widget state, or icon size."> +direction, widget state, or icon size. + a new #GtkIconSource - + + Creates a copy of @source; mostly useful for language bindings. + a new #GtkIconSource - + + Frees a dynamically-allocated icon source, along with its +filename, size, and pixbuf fields if those are not %NULL. - + + Obtains the text direction this icon source applies to. The return +value is only useful/meaningful if the text direction is <emphasis>not</emphasis> +wildcarded. + + text direction this source matches + + + + + Gets the value set by gtk_icon_source_set_direction_wildcarded(). + + %TRUE if this icon source is a base for any text direction variant + + + + + Retrieves the source filename, or %NULL if none is set. The +filename is not a copy, and should not be modified or expected to +persist beyond the lifetime of the icon source. +or freed. + + image filename. This string must not be modified + + + + + Retrieves the source icon name, or %NULL if none is set. The +icon_name is not a copy, and should not be modified or expected to +persist beyond the lifetime of the icon source. + + icon name. This string must not be modified or freed. + + + + + Retrieves the source pixbuf, or %NULL if none is set. +In addition, if a filename source is in use, this +function in some cases will return the pixbuf from +loaded from the filename. This is, for example, true +for the GtkIconSource passed to the GtkStyle::render_icon() +virtual function. The reference count on the pixbuf is +not incremented. + + source pixbuf + + + + + Obtains the icon size this source applies to. The return value +is only useful/meaningful if the icon size is <emphasis>not</emphasis> wildcarded. + + icon size this source matches. + + + + + Gets the value set by gtk_icon_source_set_size_wildcarded(). + + %TRUE if this icon source is a base for any icon size variant + + + + + Obtains the widget state this icon source applies to. The return +value is only useful/meaningful if the widget state is <emphasis>not</emphasis> +wildcarded. + + widget state this source matches + + + + + Gets the value set by gtk_icon_source_set_state_wildcarded(). + + %TRUE if this icon source is a base for any widget state variant + + + + + Sets the text direction this icon source is intended to be used +with. +Setting the text direction on an icon source makes no difference +if the text direction is wildcarded. Therefore, you should usually +call gtk_icon_source_set_direction_wildcarded() to un-wildcard it +in addition to calling this function. + + + + + + text direction this source applies to + + + + + + If the text direction is wildcarded, this source can be used +as the base image for an icon in any #GtkTextDirection. +If the text direction is not wildcarded, then the +text direction the icon source applies to should be set +with gtk_icon_source_set_direction(), and the icon source +will only be used with that text direction. +#GtkIconSet prefers non-wildcarded sources (exact matches) over +wildcarded sources, and will use an exact match when possible. + + + + + + %TRUE to wildcard the text direction + + + + + + Sets the name of an image file to use as a base image when creating +icon variants for #GtkIconSet. The filename must be absolute. + image file to use @@ -27159,73 +24343,78 @@ icon variants for #GtkIconSet. The filename must be absolute."> - + + Sets a pixbuf to use as a base image when creating icon variants +for #GtkIconSet. + pixbuf to use as a source - + + Sets the icon size this icon source is intended to be used +with. +Setting the icon size on an icon source makes no difference +if the size is wildcarded. Therefore, you should usually +call gtk_icon_source_set_size_wildcarded() to un-wildcard it +in addition to calling this function. - + + + + icon size this source applies to + + + - - - - - - - - - - - + If the icon size is wildcarded, this source can be used as the base +image for an icon of any size. If the size is not wildcarded, then +the size the source applies to should be set with +gtk_icon_source_set_size() and the icon source will only be used +with that specific size. #GtkIconSet prefers non-wildcarded sources (exact matches) over -wildcarded sources, and will use an exact match when possible."> +wildcarded sources, and will use an exact match when possible. +#GtkIconSet will normally scale wildcarded source images to produce +an appropriate icon at a given size, but will not change the size +of source images that match exactly. - + %TRUE to wildcard the widget state + + + + + + Sets the widget state this icon source is intended to be used +with. +Setting the widget state on an icon source makes no difference +if the state is wildcarded. Therefore, you should usually +call gtk_icon_source_set_state_wildcarded() to un-wildcard it +in addition to calling this function. + + + + + + widget state this source applies to + + If the widget state is wildcarded, this source can be used as the base image for an icon in any #GtkStateType. If the widget state is not wildcarded, then the state the source applies to should be set with gtk_icon_source_set_state() and the icon source will @@ -27235,173 +24424,85 @@ wildcarded sources, and will use an exact match when possible. #GtkIconSet will normally transform wildcarded source images to produce an appropriate icon for a given state, for example lightening an image on prelight, but will not modify source images -that match exactly."> +that match exactly. - + %TRUE to wildcard the widget state + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a new icon theme object. Icon theme objects are used to lookup up an icon by name in a particular icon theme. -Usually, you'll want to use gtk_icon_theme_get_default() +Usually, you'll want to use gtk_icon_theme_get_default() or gtk_icon_theme_get_for_screen() rather than creating -a new icon theme object for scratch." - version="2.4"> +a new icon theme object for scratch. + the newly created #GtkIconTheme object. + + Registers a built-in icon for icon theme lookups. The idea +of built-in icons is to allow an application or library +that uses themed icons to function requiring files to +be present in the file system. For instance, the default +images for all of GTK+'s stock icons are registered +as built-icons. +In general, if you use gtk_icon_theme_add_builtin_icon() +you should also install the icon in the icon theme, so +that the icon is generally available. +This function will generally be used with pixbufs loaded +via gdk_pixbuf_new_from_inline(). + + + + + + the name of the icon to register + + + + the size at which to register the icon (different images can be registered for the same icon name at different sizes.) + + + + #GdkPixbuf that contains the image to use for @icon_name. + + + + + Gets the icon theme for the default screen. See gtk_icon_theme_get_for_screen(). the default screen. This icon theme is associated with the screen and can be used as long as the screen -is open. Do not ref or unref it." - version="2.4"> - +is open. Do not ref or unref it. + + A unique #GtkIconTheme associated with + Gets the icon theme object associated with @screen; if this function has not previously been called for the given screen, a new icon theme object will be created and associated with the screen. Icon theme objects are @@ -27411,253 +24512,185 @@ and setting the screen yourself; by using this function a single icon theme object will be shared between users. the given screen. This icon theme is associated with the screen and can be used as long as the screen -is open. Do not ref or unref it." - version="2.4"> - +is open. Do not ref or unref it. + + A unique #GtkIconTheme associated with + a #GdkScreen - - - - - - - - - - - - - - - - - + Appends a directory to the search path. +See gtk_icon_theme_set_search_path(). - - + + directory name to append to the icon path + - - - + + Looks up a named icon and returns a structure containing +information such as the filename of the icon. The icon +can then be rendered into a pixbuf using +gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() +combines these two steps if all you need is the pixbuf.) +If @icon_names contains more than one name, this function +tries them all in the given order before falling back to +inherited icon themes. +about the icon, or %NULL if the icon wasn't found. Free with +gtk_icon_info_free() + + a #GtkIconInfo structure containing information + - + + %NULL-terminated array of icon names to lookup - - + + desired icon size + + + + flags modifying the behavior of the icon lookup + + + + + + Gets the name of an icon that is representative of the +current theme (for instance, to use when presenting +a list of themes to the user.) +Free with g_free(). + + the name of an example icon or %NULL. + + + + + Returns an array of integers describing the sizes at which +the icon is available without scaling. A size of -1 means +that the icon is available in a scalable format. The array +is zero-terminated. +which the icon is available. The array should be freed with g_free() +when it is no longer needed. + + An newly allocated array describing the sizes at + + + + + the name of an icon + + Gets the current search path. See gtk_icon_theme_set_search_path(). - + allow-none="1"> + location to store a list of icon theme path directories or %NULL The stored value should be freed with g_strfreev(). + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + location to store number of elements in @path, or %NULL + + Checks whether an icon theme includes an icon for a particular name. -icon for @icon_name." - version="2.4"> +icon for @icon_name. - + %TRUE if @icon_theme includes an + + the name of an icon - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the list of contexts available within the current +hierarchy of icon themes +contexts in the theme. You must first free each element +in the list with g_free(), then free the list itself +with g_list_free(). - + a #GList list holding the names of all the + + + + + + + Lists the icons in the current icon theme. Only a subset +of the icons can be listed by providing a context string. +The set of values for the context string is system dependent, +but will typically include such values as "Applications" and +"MimeTypes". +icons in the theme. You must first free each element +in the list with g_free(), then free the list itself +with g_list_free(). + + a #GList list holding the names of all the + + + - + + a string identifying a particular type of icon, or %NULL to list all icons. - - - - - - + Looks up an icon in an icon theme, scales it to the given size and renders it into a pixbuf. This is a convenience function; if more details about the icon are needed, use gtk_icon_theme_lookup_icon() followed by gtk_icon_info_load_icon(). @@ -27668,111 +24701,174 @@ update the icon when the icon theme changes, you should consider using gdk_pixbuf_copy() to make a private copy of the pixbuf returned by this function. Otherwise GTK+ may need to keep the old icon theme loaded, which would be a waste of memory. -or a new reference to an internal icon, so you must not modify -the icon. Use g_object_unref() to release your reference to the -icon. %NULL if the icon isn't found." - version="2.4" - throws="1"> +newly created icon or a new reference to an internal icon, so +you must not modify the icon. Use g_object_unref() to release +your reference to the icon. %NULL if the icon isn't found. + the rendered icon; this may be a + the name of the icon to lookup - + the desired icon size. The resulting icon may not be exactly this size; see gtk_icon_info_load_icon(). + + flags modifying the behavior of the icon lookup + Looks up an icon and returns a structure containing +information such as the filename of the icon. The icon can then be rendered into a pixbuf using gtk_icon_info_load_icon(). -information about the icon, or %NULL if the icon -wasn't found. Free with gtk_icon_info_free()" - version="2.14"> +information about the icon, or %NULL if the icon +wasn't found. Free with gtk_icon_info_free() + a #GtkIconInfo structure containing + the #GIcon to look up - + desired icon size + + flags modifying the behavior of the icon lookup - - - - - + Looks up a named icon and returns a structure containing +information such as the filename of the icon. The icon +can then be rendered into a pixbuf using +gtk_icon_info_load_icon(). (gtk_icon_theme_load_icon() +combines these two steps if all you need is the pixbuf.) +about the icon, or %NULL if the icon wasn't found. Free with +gtk_icon_info_free() + + a #GtkIconInfo structure containing information + - + + the name of the icon to lookup + + + + desired icon size + + + + flags modifying the behavior of the icon lookup + + + + + + Prepends a directory to the search path. +See gtk_icon_theme_set_search_path(). + + + + + + directory name to prepend to the icon path - - - - - - - - - - - - + Checks to see if the icon theme has changed; if it has, any currently cached information is discarded and will be reloaded next time @icon_theme is accessed. -to be reloaded." - version="2.4"> +to be reloaded. - + %TRUE if the icon theme has changed and needed + + + Sets the name of the icon theme that the #GtkIconTheme object uses +overriding system configuration. This function cannot be called +on the icon theme objects returned from gtk_icon_theme_get_default() +and gtk_icon_theme_get_for_screen(). + + + + + + name of icon theme to use instead of configured theme, or %NULL to unset a previously set custom theme + + + + + + Sets the screen for an icon theme; the screen is used +to track the user's currently configured icon theme, +which might be different for different screens. + + + + + + a #GdkScreen + + + + + + Sets the search path for the icon theme object. When looking +for an icon theme, GTK+ will search for a subdirectory of +one or more of the directories in @path with the same name +as the icon theme. (Themes from multiple of the path elements +are combined to allow themes to be extended by adding icons +in the user's home directory.) +In addition if an icon found isn't found either in the current +icon theme or the default icon theme, and an image file with +the right name is found directly in one of the elements of +(This is legacy feature, and new icons should be put +into the default icon theme, which is called DEFAULT_THEME_NAME, +rather than directly on the icon path.) + + + + + + array of directories that are searched for icon themes + + + + number of elements in @path. + + + + @@ -27780,8 +24876,8 @@ to be reloaded." - - + + @@ -27792,7 +24888,7 @@ to be reloaded." - + @@ -27805,11 +24901,11 @@ to be reloaded." + Error codes for GtkIconTheme operations. - + - - - + + + Creates a new #GtkIconView widget + + A newly created #GtkIconView widget + - - + version="2.6 "> + Creates a new #GtkIconView widget with the model @model. + + A newly created #GtkIconView widget. + + The model. - + + Converts widget coordinates to coordinates for the bin_window, +as expected by e.g. gtk_icon_view_get_path_at_pos(). - - + + X coordinate relative to the widget + + + + Y coordinate relative to the widget + + + + return location for bin_window X coordinate + + + + return location for bin_window Y coordinate + - + + Creates a #GdkPixmap representation of the item at @path. +This image is used for a drag icon. - - - - - - + a newly-allocated pixmap of the drag icon. + - - + + a #GtkTreePath in @icon_view + - - - - - - + + Turns @icon_view into a drop destination for automatic DND. Calling this +method sets #GtkIconView:reorderable to %FALSE. - - + + the table of targets that the drag will support + + + + the number of items in @targets + + + + the bitmask of possible actions for a drag to this widget + - - - - - - + + Turns @icon_view into a drag source for automatic DND. Calling this +method sets #GtkIconView:reorderable to %FALSE. - - + + Mask of allowed buttons to start drag + - - - - - - - - - - - - - - + + the table of targets that the drag will support + - - - - - - - - - - - - - - + + the number of items in @targets + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the bitmask of possible actions for a drag from this widget + + Returns the value of the ::column-spacing property. - + the space between columns + - + Returns the value of the ::columns property. + + the number of columns, or -1 + + + + + Fills in @path and @cell with the current cursor path and cell. +If the cursor isn't currently set, then *@path will be %NULL. +If no cell currently has focus, then *@cell will be %NULL. +The returned #GtkTreePath must be freed with gtk_tree_path_free(). + + %TRUE if the cursor is set. + + + + + Return location for the current cursor path, or %NULL + + + + Return location the current focus cell, or %NULL + + + + + + Determines the destination item for a given position. + + whether there is an item at the given position. + + + + + the position to determine the destination item for + + + + the position to determine the destination item for + + + + Return location for the path of the item, or %NULL. + + + + Return location for the drop position, or %NULL + + + + + + Gets information about the item that is highlighted for feedback. - - + + Return location for the path of the highlighted item, or %NULL. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Return location for the drop position, or %NULL + + Finds the path at the point (@x, @y), relative to bin_window coordinates. +In contrast to gtk_icon_view_get_path_at_pos(), this function also obtains the cell at the specified position. The returned path should be freed with gtk_tree_path_free(). See gtk_icon_view_convert_widget_to_bin_window_coords() for converting -widget coordinates to bin_window coordinates." - version="2.8"> +widget coordinates to bin_window coordinates. - + %TRUE if an item exists at the specified position + - + The x position to be identified + - + The y position to be identified + - + + Return location for the path, or %NULL + Return location for the renderer responsible for the cell at (@x, @y), or %NULL - + + Gets the column in which the item @path is currently +displayed. Column numbers start at 0. - + The column in which the item is displayed + - - - - - + + the #GtkTreePath of the item + - + Returns the value of the ::item-orientation property which determines +whether the labels are drawn beside the icons instead of below. - + the relative position of texts and icons + + + + + Returns the value of the ::item-padding property. + + the padding around items + + + + + Gets the row in which the item @path is currently +displayed. Row numbers start at 0. + + The row in which the item is displayed + - - - - - + + the #GtkTreePath of the item + - + Returns the value of the ::item-width property. - + the width of a single item, or -1 + - - - - - - + Returns the value of the ::margin property. + + the space at the borders + + + + + Returns the column with markup text for @icon_view. + + the markup column, or -1 if it's unset. + + + + + Returns the model the #GtkIconView is based on. Returns %NULL if the +model is unset. +currently being used. + + A #GtkTreeModel, or %NULL if none is + + + + + Finds the path at the point (@x, @y), relative to bin_window coordinates. +See gtk_icon_view_get_item_at_pos(), if you are also interested in +the cell at the specified position. +See gtk_icon_view_convert_widget_to_bin_window_coords() for converting +widget coordinates to bin_window coordinates. +if no icon exists at that position. - - - - - - + The #GtkTreePath corresponding to the icon or %NULL + - - + + The x position to be identified + + + + The y position to be identified + - + Returns the column with pixbufs for @icon_view. - + the pixbuf column, or -1 if it's unset. + - - - - - - + + Retrieves whether the user can reorder the list via drag-and-drop. +See gtk_icon_view_set_reorderable(). - + %TRUE if the list can be reordered. + + + + + Returns the value of the ::row-spacing property. + + the space between rows + - - - - - + Creates a list of paths of all selected items. Additionally, if you are planning on modifying the model after calling this function, you may want to convert the returned list into a list of #GtkTreeRowReference<!-- -->s. To do this, you can use gtk_tree_row_reference_new(). @@ -28295,380 +25314,51 @@ To free the return value, use: |[ g_list_foreach (list, (GFunc)gtk_tree_path_free, NULL); g_list_free (list); -]|" - version="2.6"> - +]| + + A #GList containing a #GtkTreePath for each selected row. - + Gets the selection mode of the @icon_view. + + the current selection mode + + + + + Returns the value of the ::spacing property. - + the space between cells + - + Returns the column with text for @icon_view. - + the text column, or -1 if it's unset. + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This function is supposed to be used in a #GtkWidget::query-tooltip signal handler for #GtkIconView. The @x, @y and @keyboard_tip values which are received in the signal handler, should be passed to this function without modification. @@ -28676,206 +25366,716 @@ The return value indicates whether there is an icon view item at the given coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard tooltips the item returned will be the cursor item. When %TRUE, then any of that row and the corresponding model. @x and @y will always be converted -to be relative to @icon_view's bin_window if @keyboard_tooltip is %FALSE." - version="2.12"> +to be relative to @icon_view's bin_window if @keyboard_tooltip is %FALSE. - + whether or not the given tooltip context points to a item + - - + + the x coordinate (relative to widget coordinates) + - - + + the y coordinate (relative to widget coordinates) + - + whether this is a keyboard tooltip or not + + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + a pointer to receive a #GtkTreeModel or %NULL + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + a pointer to receive a #GtkTreePath or %NULL + allow-none="1"> + a pointer to receive a #GtkTreeIter or %NULL - + + Sets @start_path and @end_path to be the first and last visible path. +Note that there may be invisible paths in between. +Both paths should be freed with gtk_tree_path_free() after use. + + %TRUE, if valid paths were placed in @start_path and @end_path + + + + + Return location for start of region, or %NULL + + + + Return location for end of region, or %NULL + + + + + + Activates the item determined by @path. + + + + + + The #GtkTreePath to be activated + + + + + + Returns %TRUE if the icon pointed to by @path is currently +selected. If @path does not point to a valid location, %FALSE is returned. + + %TRUE if @path is selected. + + + + + A #GtkTreePath to check selection on. + + + + + + Moves the alignments of @icon_view to the position specified by @path. +where @column is placed. Both are expected to be between 0.0 and 1.0. +0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means +center. +If @use_align is %FALSE, then the alignment arguments are ignored, and the +tree does the minimum amount of work to scroll the item onto the screen. +This means that the item will be scrolled to the edge closest to its current +position. If the item is currently visible on the screen, nothing is done. +This function only works if the model is set, and @path is a valid row on +the model. If the model changes before the @icon_view is realized, the +centered path will be modified to reflect this change. + + + + + + The path of the item to move to. + + + + whether to use alignment arguments, or %FALSE. + + + + The vertical alignment of the item specified by @path. + + + + The horizontal alignment of the item specified by @path. + + + + + + Selects all the icons. @icon_view must has its selection mode set +to #GTK_SELECTION_MULTIPLE. + + + + + + Selects the row at @path. + + + + + + The #GtkTreePath to be selected. + + + + + + Calls a function for each selected icon. Note that the model or +selection cannot be modified from within this function. + + + + + + The function to call for each selected icon. + + + + User data to pass to the function. + + + + + + Sets the ::column-spacing property which specifies the space +which is inserted between the columns of the icon view. + + + + + + the column spacing + + + + + + Sets the ::columns property which determines in how +many columns the icons are arranged. If @columns is +-1, the number of columns will be chosen automatically +to fill the available area. + + + + + + the number of columns + + + + + + Sets the current keyboard focus to be at @path, and selects it. This is +useful when you want to focus the user's attention on a particular item. +If @cell is not %NULL, then focus is given to the cell specified by +it. Additionally, if @start_editing is %TRUE, then editing should be +started in the specified cell. +This function is often followed by <literal>gtk_widget_grab_focus +(icon_view)</literal> in order to give keyboard focus to the widget. +Please note that editing can only happen when the widget is realized. + + + + + + A #GtkTreePath + + + + One of the cell renderers of @icon_view, or %NULL + + + + %TRUE if the specified cell should start being edited. + + + + + + Sets the item that is highlighted for feedback. + + + + + + The path of the item to highlight, or %NULL. + + + + Specifies where to drop, relative to the item + + + + + + Sets the ::item-orientation property which determines whether the labels +are drawn beside the icons instead of below. + + + + + + the relative position of texts and icons + + + + + + Sets the #GtkIconView:item-padding property which specifies the padding +around each of the icon view's items. + + + + + + the item padding + + + + + + Sets the ::item-width property which specifies the width +to use for each item. If it is set to -1, the icon view will +automatically determine a suitable item size. + + + + + + the width for each item + + + + + + Sets the ::margin property which specifies the space +which is inserted at the top, bottom, left and right +of the icon view. + + + + + + the margin + + + + + + Sets the column with markup information for @icon_view to be +If the markup column is set to something, it overrides +the text column set by gtk_icon_view_set_text_column(). - + A column in the currently used model, or -1 to display no text + - + + Sets the model for a #GtkIconView. +If the @icon_view already has a model set, it will remove +it before setting the new model. If @model is %NULL, then +it will unset the old model. - + + + + + The model. + + + + + + Sets the column with pixbufs for @icon_view to be @column. The pixbuf +column must be of type #GDK_TYPE_PIXBUF + + + + + + A column in the currently used model, or -1 to disable + + + + + + This function is a convenience function to allow you to reorder models that +support the #GtkTreeDragSourceIface and the #GtkTreeDragDestIface. Both +#GtkTreeStore and #GtkListStore support these. If @reorderable is %TRUE, then +the user can reorder the model by dragging and dropping rows. The +developer can listen to these changes by connecting to the model's +row_inserted and row_deleted signals. The reordering is implemented by setting up +the icon view as a drag source and destination. Therefore, drag and +drop can not be used in a reorderable view for any other purpose. +This function does not give you any degree of control over the order -- any +reordering is allowed. If more control is needed, you should probably +handle drag and drop manually. + + + + + + %TRUE, if the list of items can be reordered. + + + + + + Sets the ::row-spacing property which specifies the space +which is inserted between the rows of the icon view. + + + + + + the row spacing + + + + + + Sets the selection mode of the @icon_view. + + + + + + The selection mode + + + + + + Sets the ::spacing property which specifies the space +which is inserted between the cells (i.e. the icon and +the text) of an item. + + + + + + the spacing + + + + + + Sets the column with text for @icon_view to be @column. The text +column must be of type #G_TYPE_STRING. + + + + + + A column in the currently used model, or -1 to display no text + + + + + + Sets the tip area of @tooltip to the area which @cell occupies in +the item pointed to by @path. See also gtk_tooltip_set_tip_area(). +See also gtk_icon_view_set_tooltip_column() for a simpler alternative. + + + + + + a #GtkTooltip + + + + a #GtkTreePath + + + + a #GtkCellRenderer or %NULL + + + + + + If you only plan to have simple (text-only) tooltips on full items, you +can use this function to have #GtkIconView handle these automatically +for you. @column should be set to the column in @icon_view's model +containing the tooltip texts, or -1 to disable this feature. +When enabled, #GtkWidget::has-tooltip will be set to %TRUE and + + + + + + an integer, which is a valid column number for @icon_view's model + + + + + + Sets the tip area of @tooltip to be the area covered by the item at @path. +See also gtk_icon_view_set_tooltip_column() for a simpler alternative. +See also gtk_tooltip_set_tip_area(). + + + + + + a #GtkTooltip + + + + a #GtkTreePath + + + + + + Unselects all the icons. + + + + + + Unselects the row at @path. + + + + + + The #GtkTreePath to be unselected. + + + + + + Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this +method sets #GtkIconView:reorderable to %FALSE. + + + + + + Undoes the effect of gtk_icon_view_enable_model_drag_source(). Calling this +method sets #GtkIconView:reorderable to %FALSE. + + - + transfer-ownership="none"> + The column-spacing property specifies the space which is inserted between +the columns of the icon view. + + The columns property contains the number of the columns in which the items should be displayed. If it is -1, the number of columns will -be chosen automatically to fill the available area."> - +be chosen automatically to fill the available area. + + + + The item-orientation property specifies how the cells (i.e. the icon and +the text) of the item are positioned relative to each other. + - + transfer-ownership="none"> + The item-padding property specifies the padding around each +of the icon view's item. + - + transfer-ownership="none"> + The item-width property specifies the width to use for each item. +If it is set to -1, the icon view will automatically determine a +suitable item size. + - + transfer-ownership="none"> + The margin property specifies the space which is inserted +at the edges of the icon view. + + The ::markup-column property contains the number of the model column +containing markup information to be displayed. The markup column must be +of type #G_TYPE_STRING. If this property and the :text-column property are both set to column numbers, it overrides the text column. -If both are set to -1, no texts are displayed."> - +If both are set to -1, no texts are displayed. + - - - - - + + + The ::pixbuf-column property contains the number of the model column +containing the pixbufs which are displayed. The pixbuf column must be of type #GDK_TYPE_PIXBUF. Setting this property to -1 turns off the -display of pixbufs."> - +display of pixbufs. + - + transfer-ownership="none"> + The reorderable property specifies if the items can be reordered +by DND. + - + transfer-ownership="none"> + The row-spacing property specifies the space which is inserted between +the rows of the icon view. + + The ::selection-mode property specifies the selection mode of icon view. If the mode is #GTK_SELECTION_MULTIPLE, rubberband selection -is enabled, for the other modes, only keyboard selection is possible."> - +is enabled, for the other modes, only keyboard selection is possible. + - + transfer-ownership="none"> + The spacing property specifies the space which is inserted between +the cells (i.e. the icon and the text) of an item. + - + transfer-ownership="none"> + The ::text-column property contains the number of the model column +containing the texts which are displayed. The text column must be +of type #G_TYPE_STRING. If this property and the :markup-column +property are both set to -1, no texts are displayed. + - - + + - + - + A <link linkend="keybinding-signals">keybinding signal</link> +which gets emitted when the user activates the currently +focused item. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control activation programmatically. -The default bindings for this signal are Space, Return and Enter."> - - +The default bindings for this signal are Space, Return and Enter. + + - + The ::item-activated signal is emitted when the method +gtk_icon_view_item_activated() is called or the user double clicks an item. It is also emitted when a non-editable item -pressed."> - - +pressed. + + - - + + the #GtkTreePath for the activated item + - + The ::move-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates a cursor movement. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control the cursor @@ -28884,87 +26084,89 @@ The default bindings for this signal include <itemizedlist> <listitem>Arrow keys which move by individual steps</listitem> <listitem>Home/End keys which move to the first/last item</listitem> -<listitem>PageUp/PageDown which move by "pages"</listitem> +<listitem>PageUp/PageDown which move by "pages"</listitem> </itemizedlist> All of these will extend the selection when combined with -the Shift modifier."> - - +the Shift modifier. + + - - + + the granularity of the move, as a #GtkMovementStep + - - + + the number of @step units to move + - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user selects all items. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control selection programmatically. -The default binding for this signal is Ctrl-a."> - - +The default binding for this signal is Ctrl-a. + + - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user selects the item that is currently focused. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control selection programmatically. -There is no default binding for this signal."> - - +There is no default binding for this signal. + + - - - + + The ::selection-changed signal is emitted when the selection +(i.e. the set of selected items) changes. + + - - + + - + - + - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user toggles whether the currently -focused item is selected or not. The exact effect of this +focused item is selected or not. The exact effect of this depend on the selection mode. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control selection programmatically. -There is no default binding for this signal is Ctrl-Space."> - - +There is no default binding for this signal is Ctrl-Space. + + - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user unselects all items. Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control selection programmatically. -The default binding for this signal is Ctrl-Shift-a."> - - +The default binding for this signal is Ctrl-Shift-a. + + @@ -28975,8 +26177,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -28994,7 +26195,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29009,7 +26210,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29021,7 +26222,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29033,7 +26234,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29045,7 +26246,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29057,7 +26258,7 @@ The default binding for this signal is Ctrl-Shift-a."> - + @@ -29069,9 +26270,9 @@ The default binding for this signal is Ctrl-Shift-a."> - + - + @@ -29081,15 +26282,15 @@ The default binding for this signal is Ctrl-Shift-a."> - + - + - + @@ -29103,6 +26304,7 @@ The default binding for this signal is Ctrl-Shift-a."> glib:type-name="GtkIconViewDropPosition" glib:get-type="gtk_icon_view_drop_position_get_type" c:type="GtkIconViewDropPosition"> + An enum for determining where a dropped item goes. glib:nick="drop-below"/> + A function used by gtk_icon_view_selected_foreach() to map all +selected rows. It will be called on every selected row in the view. + a #GtkIconView + The #GtkTreePath of a selected row - + user data + - + + This struct contain private data only and should be accessed by the functions +below. - - - + + + Creates a new empty #GtkImage widget. + + a newly created #GtkImage widget. + - - - + + Creates a #GtkImage displaying the given animation. +The #GtkImage does not assume a reference to the +animation; you still need to unref it if you own references. +#GtkImage will add its own reference rather than adopting yours. +Note that the animation frames are shown using a timeout with +#G_PRIORITY_DEFAULT. When using animations to indicate busyness, +keep in mind that the animation will only be shown if the main loop +is not busy with something that has a higher priority. + + a new #GtkImage widget + - - - - - + + an animation + - - - - - - - - - - - - - - + Creates a new #GtkImage displaying the file @filename. If the file +isn't found or can't be loaded, the resulting #GtkImage will +display a "broken image" icon. This function never returns %NULL, it always returns a valid #GtkImage widget. If the file contains an animation, the image will contain an animation. @@ -29227,663 +26407,543 @@ the #GtkImage from the pixbuf. (Or for animations, use gdk_pixbuf_animation_new_from_file()). The storage type (gtk_image_get_storage_type()) of the returned image is not defined, it will be whatever is appropriate for -displaying the file."> - - +displaying the file. + + a new #GtkImage + + a filename - - - + + Creates a #GtkImage displaying an icon from the current icon theme. +If the icon name isn't known, a "broken image" icon will be +displayed instead. If the current icon theme is changed, the icon +will be updated appropriately. + + a new #GtkImage displaying the themed icon + - - + + an icon + + + + a stock icon size + - - - + + Creates a #GtkImage displaying an icon from the current icon theme. +If the icon name isn't known, a "broken image" icon will be +displayed instead. If the current icon theme is changed, the icon +will be updated appropriately. + + a new #GtkImage displaying the themed icon + - + + an icon name - - + + a stock icon size + + Creates a #GtkImage displaying an icon set. Sample stock sizes are #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_SMALL_TOOLBAR. Instead of using -this function, usually it's better to create a #GtkIconFactory, put +this function, usually it's better to create a #GtkIconFactory, put your icon sets in the icon factory, add the icon factory to the list of default factories with gtk_icon_factory_add_default(), and then use gtk_image_new_from_stock(). This will allow themes to override the icon you ship with your application. The #GtkImage does not assume a reference to the icon set; you still need to unref it if you own references. -#GtkImage will add its own reference rather than adopting yours."> - - +#GtkImage will add its own reference rather than adopting yours. + + a new #GtkImage + + a #GtkIconSet - - + + a stock icon size + - + Creates a new #GtkImage displaying @pixbuf. The #GtkImage does not assume a reference to the -animation; you still need to unref it if you own references. +pixbuf; you still need to unref it if you own references. #GtkImage will add its own reference rather than adopting yours. -Note that the animation frames are shown using a timeout with -#G_PRIORITY_DEFAULT. When using animations to indicate busyness, -keep in mind that the animation will only be shown if the main loop -is not busy with something that has a higher priority."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +Note that this function just creates an #GtkImage from the pixbuf. The +#GtkImage created will not react to state changes. Should you want that, +you should use gtk_image_new_from_icon_set(). - - - - - - + a new #GtkImage + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GdkPixbuf, or %NULL - - + + + Creates a #GtkImage widget displaying @pixmap with a @mask. +A #GdkPixmap is a server-side image buffer in the pixel format of the +current display. The #GtkImage does not assume a reference to the +pixmap or mask; you still need to unref them if you own references. +#GtkImage will add its own reference rather than adopting yours. - + a new #GtkImage + + + + + a #GdkPixmap, or %NULL + + + + a #GdkBitmap, or %NULL + + + + + + Creates a #GtkImage displaying a stock icon. Sample stock icon +names are #GTK_STOCK_OPEN, #GTK_STOCK_QUIT. Sample stock sizes +are #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_SMALL_TOOLBAR. If the stock +icon name isn't known, the image will be empty. +You can register your own stock icon names, see +gtk_icon_factory_add_default() and gtk_icon_factory_add(). + + a new #GtkImage displaying the stock icon + + a stock icon name - - + + a stock icon size + - - + + + Resets the image to be empty. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the #GdkPixbufAnimation being displayed by the #GtkImage. The storage type of the image must be %GTK_IMAGE_EMPTY or %GTK_IMAGE_ANIMATION (see gtk_image_get_storage_type()). The caller of this function does not own a reference to the returned animation. -the image is empty"> - +the image is empty + + the displayed animation, or %NULL if - - - - - - - - - - - - - + Gets the #GIcon and size being displayed by the #GtkImage. The storage type of the image must be %GTK_IMAGE_EMPTY or %GTK_IMAGE_GICON (see gtk_image_get_storage_type()). The caller of this function does not own a reference to the -returned #GIcon." - version="2.14"> +returned #GIcon. + allow-none="1"> + place to store a #GIcon, or %NULL - + allow-none="1"> + place to store an icon size, or %NULL + + + Gets the icon name and size being displayed by the #GtkImage. +The storage type of the image must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_ICON_NAME (see gtk_image_get_storage_type()). +The returned string is owned by the #GtkImage and should not +be freed. + + + + + + place to store an icon name, or %NULL + + + + place to store an icon size, or %NULL + + + + + + Gets the icon set and size being displayed by the #GtkImage. +The storage type of the image must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_ICON_SET (see gtk_image_get_storage_type()). + + + + + + location to store a #GtkIconSet, or %NULL + + + + location to store a stock icon size, or %NULL + + + + + + Gets the #GdkPixbuf being displayed by the #GtkImage. +The storage type of the image must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_PIXBUF (see gtk_image_get_storage_type()). +The caller of this function does not own a reference to the +returned pixbuf. +the image is empty + + the displayed pixbuf, or %NULL if + + + + Gets the pixel size used for named icons. - + the pixel size used for named icons. + - + + Gets the pixmap and mask being displayed by the #GtkImage. +The storage type of the image must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_PIXMAP (see gtk_image_get_storage_type()). +The caller of this function does not own a reference to the +returned pixmap and mask. - - + + location to store the pixmap, or %NULL + - - - - - - - - - - - - - - + + location to store the mask, or %NULL - - + + Gets the stock icon name and size being displayed by the #GtkImage. +The storage type of the image must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_STOCK (see gtk_image_get_storage_type()). +The returned string is owned by the #GtkImage and should not +be freed. + + + + + + place to store a stock icon name, or %NULL + + + + place to store a stock icon size, or %NULL + + + + + + Gets the type of representation being used by the #GtkImage +to store image data. If the #GtkImage has no image data, +the return value will be %GTK_IMAGE_EMPTY. + + image representation being used + + + + + Causes the #GtkImage to display the given animation (or display +nothing, if you set the animation to %NULL). + + + + + + the #GdkPixbufAnimation + + + + + + See gtk_image_new_from_file() for details. + + + + + + a filename or %NULL + + + + + + See gtk_image_new_from_gicon() for details. + + + + + + an icon + + + + an icon size + + + + + + See gtk_image_new_from_icon_name() for details. + + + + + + an icon name + + + + an icon size + + + + + + See gtk_image_new_from_icon_set() for details. + + + + + + a #GtkIconSet + + + + a stock icon size + + + + + + See gtk_image_new_from_pixbuf() for details. + + + + + + a #GdkPixbuf or %NULL + + + + + + See gtk_image_new_from_pixmap() for details. + + + + + + a #GdkPixmap or %NULL + + + + a #GdkBitmap or %NULL + + + + + + See gtk_image_new_from_stock() for details. + + + + + + a stock icon name + + + + a stock icon size + + + + + + Sets the pixel size to use for named icons. If the pixel size is set +to a value != -1, it is used instead of the icon size set by +gtk_image_set_from_icon_name(). + + + + + + the new pixel size + + + + + + + The GIcon displayed in the GtkImage. For themed icons, If the icon theme is changed, the image will be updated -automatically."> - +automatically. + - + transfer-ownership="none"> + The name of the icon in the icon theme. If the icon theme is +changed, the image will be updated automatically. + - - + + - - + + - - + + - - + + - - - - - + + - + transfer-ownership="none"> + The "pixel-size" property can be used to specify a fixed size +overriding the #GtkImage:icon-size property for images of type +%GTK_IMAGE_ICON_NAME. + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -29895,7 +26955,7 @@ overriding the #GtkImage:icon-size property for images of type c:type="GdkPixbufAnimationIter*"/> - + - - + + - - + + - - + + - - + + @@ -29941,7 +27001,7 @@ overriding the #GtkImage:icon-size property for images of type - + @@ -29952,7 +27012,7 @@ overriding the #GtkImage:icon-size property for images of type - + @@ -29960,102 +27020,148 @@ overriding the #GtkImage:icon-size property for images of type - - - - + - + - - - + + + Creates a new #GtkImageMenuItem with an empty label. + + a new #GtkImageMenuItem. + - - - - - - - - - - - - - - - - - - - - + Creates a new #GtkImageMenuItem containing the image and text from a +stock item. Some stock ids have preprocessor macros like #GTK_STOCK_OK and #GTK_STOCK_APPLY. If you want this menu item to have changeable accelerators, then pass in %NULL for accel_group. Next call gtk_menu_item_set_accel_path() with an appropriate path for the menu item, use gtk_stock_lookup() to look up the standard accelerator for the stock item, and if one is found, call -gtk_accel_map_add_entry() to register it."> - - +gtk_accel_map_add_entry() to register it. + + a new #GtkImageMenuItem. + + the name of the stock item. - + + the #GtkAccelGroup to add the menu items accelerator to, or %NULL. + + Creates a new #GtkImageMenuItem containing a label. + + a new #GtkImageMenuItem. + + + + + the text of the menu item. + + + + + + Creates a new #GtkImageMenuItem containing a label. The label +will be created using gtk_label_new_with_mnemonic(), so underscores +in @label indicate the mnemonic for the menu item. + + a new #GtkImageMenuItem + + + + + the text of the menu item, with an underscore in front of the mnemonic character + + + + + + Returns whether the menu item will ignore the #GtkSettings:gtk-menu-images +setting and always show the image, if available. + + %TRUE if the menu item will always show the image + + + + + Gets the widget that is currently set as the image of @image_menu_item. +See gtk_image_menu_item_set_image(). + + the widget set as image of @image_menu_item + + + + + Checks whether the label set in the menuitem is used as a +stock id to select the stock item for the item. +stock id to select the stock item for the item + + %TRUE if the label set in the menuitem is used as a + + + + + Specifies an @accel_group to add the menu items accelerator to +(this only applies to stock items so a stock item must already +be set, make sure to call gtk_image_menu_item_set_use_stock() +and gtk_menu_item_set_label() with a valid stock item first). +If you want this menu item to have changeable accelerators then +you shouldnt need this (see gtk_image_menu_item_new_from_stock()). + + + + + + the #GtkAccelGroup + + + + + If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images setting and always show the image, if available. Use this property if the menuitem would be useless or hard to use -without the image." - version="2.16"> +without the image. - + %TRUE if the menuitem should always show the image + - - - - - @@ -30066,53 +27172,18 @@ setting and always show the image, if available." - - - - - + If %TRUE, the label set in the menuitem is used as a +stock id to select the stock item for the item. - - - - - - - - - - - - - - - - + %TRUE if the menuitem should use a stock item + @@ -30120,35 +27191,38 @@ you shouldnt need this (see gtk_image_menu_item_new_from_stock())." version="2.16" readable="0" writable="1" - doc="The Accel Group to use for stock accelerator keys"> - + transfer-ownership="none"> + The Accel Group to use for stock accelerator keys + + If %TRUE, the menu item will ignore the #GtkSettings:gtk-menu-images setting and always show the image, if available. Use this property if the menuitem would be useless or hard to use -without the image."> - +without the image. + - - + + - + transfer-ownership="none"> + If %TRUE, the label set in the menuitem is used as a +stock id to select the stock item for the item. + - - + + + + @@ -30168,24 +27246,24 @@ stock id to select the stock item for the item."> + + + Describes the image data representation used by a #GtkImage. If you want to get the image from the widget, you can only get the currently-stored representation. e.g. if the gtk_image_get_storage_type() returns #GTK_IMAGE_PIXBUF, then you can call gtk_image_get_pixbuf() but not gtk_image_get_stock(). For empty -images, you can request any storage type (call any of the "get" -functions), but they will all return %NULL values." - glib:type-name="GtkImageType" - glib:get-type="gtk_image_type_get_type" - c:type="GtkImageType"> +images, you can request any storage type (call any of the "get" +functions), but they will all return %NULL values. - - - - + + + Creates a new #GtkInfoBar object. + + a new #GtkInfoBar object + + Creates a new #GtkInfoBar with buttons. Button text/response ID pairs should be listed, with a %NULL pointer ending the list. Button text can be either a stock ID such as %GTK_STOCK_OK, or some arbitrary text. A response ID can be any positive number, or one of the values in the #GtkResponseType enumeration. If the user clicks one of these dialog buttons, GtkInfoBar will emit -the "response" signal with the corresponding response ID."> - - +the "response" signal with the corresponding response ID. + + a new #GtkInfoBar + + allow-none="1"> + stock ID or text to go in first button, or %NULL @@ -30266,74 +27342,64 @@ the "response" signal with the corresponding response ID."> - - - - - - - - - - + Add an activatable widget to the action area of a #GtkInfoBar, connecting a signal handler that will emit the #GtkInfoBar::response signal on the message area when the widget is activated. The widget -is appended to the end of the message areas action area." - version="2.18"> +is appended to the end of the message areas action area. + an activatable widget - + response ID for @child + - + Adds a button with the given text (or a stock button, if button_text +is a stock ID) and sets things up so that clicking the button will emit +the "response" signal with the given response_id. The button is appended +to the end of the info bars's action area. The button widget is +returned, but usually you don't need it. + + the button widget that was added + text of button, or stock ID - + response ID for the button + + Adds more buttons, same as calling gtk_info_bar_add_button() repeatedly. The variable argument list should be %NULL-terminated as with gtk_info_bar_new_with_buttons(). Each button must have both -text and response ID." - version="2.18"> +text and response ID. + button text or stock ID @@ -30342,122 +27408,146 @@ text and response ID." - + Returns the action area of @info_bar. + + the action area + + + + + Returns the content area of @info_bar. + + the content area + + + + + Returns the message type of the message area. + + the message type of the message area. + + + + + Emits the 'response' signal with the given @response_id. - - - - + a response ID + + Sets the last widget in the info bar's action area with the given response_id as the default widget for the dialog. -Pressing "Enter" normally activates the default widget. +Pressing "Enter" normally activates the default widget. Note that this function currently requires @info_bar to -be added to a widget hierarchy." - version="2.18"> +be added to a widget hierarchy. - - - - - - - - - - - + a response ID + + Sets the message type of the message area. +GTK+ uses this type to determine what color to use +when drawing the message area. + a #GtkMessageType - - - + Calls gtk_widget_set_sensitive (widget, setting) for each +widget in the info bars's action area with the given response_id. +A convenient way to sensitize/desensitize dialog buttons. + + + + + a response ID + + + + TRUE for sensitive + + + + The type of the message. The type is used to determine the colors to use in the info bar. The following symbolic color names can by used to customize these colors: -"info_fg_color", "info_bg_color", -"warning_fg_color", "warning_bg_color", -"question_fg_color", "question_bg_color", -"error_fg_color", "error_bg_color". -"other_fg_color", "other_bg_color". +"info_fg_color", "info_bg_color", +"warning_fg_color", "warning_bg_color", +"question_fg_color", "question_bg_color", +"error_fg_color", "error_bg_color". +"other_fg_color", "other_bg_color". If the type is #GTK_MESSAGE_OTHER, no info bar is painted but the -colors are still set."> - +colors are still set. + - + - + The ::close signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user uses a keybinding to dismiss the info bar. -The default binding for this signal is the Escape key." - version="2.18"> - - +The default binding for this signal is the Escape key. + + - + Emitted when an action widget is clicked or the application programmer calls gtk_dialog_response(). The @response_id depends on which action -widget was clicked." - version="2.18"> - - +widget was clicked. + + - - + + the response ID + @@ -30469,7 +27559,7 @@ widget was clicked." - + @@ -30478,13 +27568,13 @@ widget was clicked." - + - + @@ -30495,183 +27585,53 @@ widget was clicked." - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - + + + Creates a new #GtkInvisible. + + a new #GtkInvisible. + - - + Creates a new #GtkInvisible object for a specified screen + + a newly created #GtkInvisible object + + a #GdkScreen which identifies on which the new #GtkInvisible will be created. + + Returns the #GdkScreen object associated with @invisible + + the associated #GdkScreen. + + + + Sets the #GdkScreen where the #GtkInvisible object will be displayed. + a #GdkScreen. - - - - - - - + + - - - - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -31528,11 +27765,12 @@ Creates the menu items from the @entries." - + - - - + + + Creates a new label with the given text inside it. You can +pass %NULL to get an empty label widget. + + the new #GtkLabel + + The text of the label + Creates a new #GtkLabel, containing the text in @str. If characters in @str are preceded by an underscore, they are underlined. If you need a literal underscore character in a label, use -'__' (two underscores). The first underlined character represents a -keyboard accelerator called a mnemonic. The mnemonic key can be used +'__' (two underscores). The first underlined character represents a +keyboard accelerator called a mnemonic. The mnemonic key can be used to activate another widget, chosen automatically, or explicitly using gtk_label_set_mnemonic_widget(). -If gtk_label_set_mnemonic_widget() is not called, then the first -activatable ancestor of the #GtkLabel will be chosen as the mnemonic -widget. For instance, if the label is inside a button or menu item, -the button or menu item will automatically become the mnemonic widget -and be activated by the mnemonic."> - - +If gtk_label_set_mnemonic_widget() is not called, then the first +activatable ancestor of the #GtkLabel will be chosen as the mnemonic +widget. For instance, if the label is inside a button or menu item, +the button or menu item will automatically become the mnemonic widget +and be activated by the mnemonic. + + the new #GtkLabel + + The text of the label, with an underscore in front of the mnemonic character - + + Gets the angle of rotation for the label. See +gtk_label_set_angle(). + + the angle of rotation for the label + + + + + Gets the attribute list that was set on the label using +gtk_label_set_attributes(), if any. This function does +not reflect attributes that come from the labels markup +(see gtk_label_set_markup()). If you want to get the +effective attributes for the label, use +pango_layout_get_attribute (gtk_label_get_layout (label)). + + the attribute list, or %NULL if none was set. + + + + + Returns the URI for the currently active link in the label. +The active link is the one under the mouse pointer or, in a +selectable label, the link in which the text cursor is currently +positioned. +This function is intended for use in a #GtkLabel::activate-link handler +or for use in a #GtkWidget::query-tooltip handler. +not be freed or modified. + + the currently active URI. The string is owned by GTK+ and must + + + + + Returns the ellipsizing position of the label. See gtk_label_set_ellipsize(). + + #PangoEllipsizeMode + + + + + Returns the justification of the label. See gtk_label_set_justify(). + + #GtkJustification + + + + + Fetches the text from a label widget including any embedded +underlines indicating mnemonics and Pango markup. (See +gtk_label_get_text()). +owned by the widget and must not be modified or freed. + + the text of the label widget. This string is + + + + + Gets the #PangoLayout used to display the label. +The layout is useful to e.g. convert text positions to +pixel positions, in combination with gtk_label_get_layout_offsets(). +The returned layout is owned by the label so need not be +freed by the caller. + + the #PangoLayout for this label + + + + + Obtains the coordinates where the label will draw the #PangoLayout +representing the text in the label; useful to convert mouse events +into coordinates inside the #PangoLayout, e.g. to take some action +if some part of the label is clicked. Of course you will need to +create a #GtkEventBox to receive the events, and pack the label +inside it, since labels are a #GTK_NO_WINDOW widget. Remember +when using the #PangoLayout functions you need to convert to +and from pixels using PANGO_PIXELS() or #PANGO_SCALE. - - + + location to store X offset of layout, or %NULL + + + + location to store Y offset of layout, or %NULL + - + Returns whether lines in the label are automatically wrapped. +See gtk_label_set_line_wrap(). + + %TRUE if the lines of the label are automatically wrapped. + + + + + Returns line wrap mode used by the label. See gtk_label_set_line_wrap_mode(). + + %TRUE if the lines of the label are automatically wrapped. + + + + + Retrieves the desired maximum width of @label, in characters. See +gtk_label_set_width_chars(). + + the maximum width of the label in characters. + + + + + If the label has been set so that it has an mnemonic key this function +returns the keyval used for the mnemonic accelerator. If there is no +mnemonic set up it returns #GDK_VoidSymbol. + + GDK keyval usable for accelerators, or #GDK_VoidSymbol + + + + + Retrieves the target of the mnemonic (keyboard shortcut) of this +label. See gtk_label_set_mnemonic_widget(). +or %NULL if none has been set and the default algorithm will be used. + + the target of the label's mnemonic, + + + + + Gets the value set by gtk_label_set_selectable(). + + %TRUE if the user can copy text from the label + + + + + Gets the selected range of characters in the label, returning %TRUE +if there's a selection. + + %TRUE if selection is non-empty + + + + + return location for start of selection, as a character offset + + + + return location for end of selection, as a character offset + + + + + + Returns whether the label is in single line mode. + + %TRUE when the label is in single line mode. + + + + + Fetches the text from a label widget, as displayed on the screen. This does not include any embedded underlines indicating mnemonics or Pango markup. (See gtk_label_get_label()) -string used by the label, and must not be modified."> +string used by the label, and must not be modified. + the text in the label widget. This is the internal - + Returns whether the label is currently keeping track +of clicked links. + + %TRUE if clicked links are remembered + + + + + Returns whether the label's text is interpreted as marked up with +the <link linkend="PangoMarkupFormat">Pango text markup +language</link>. See gtk_label_set_use_markup (). + + %TRUE if the label's text will be parsed for markup. + + + + + Returns whether an embedded underline in the label indicates a +mnemonic. See gtk_label_set_use_underline(). +the mnemonic accelerator keys. + + %TRUE whether an embedded underline in the label indicates + + + + + Retrieves the desired width of @label, in characters. See +gtk_label_set_width_chars(). + + the width of the label in characters. + + + + + Selects a range of characters in the label, if the label is selectable. +See gtk_label_set_selectable(). If the label is not selectable, +this function has no effect. If @start_offset or + + + + + + start offset (in characters not bytes) + + + + end offset (in characters not bytes) + + + + + + Sets the angle of rotation for the label. An angle of 90 reads from +from bottom to top, an angle of 270, from top to bottom. The angle +setting for the label is ignored if the label is selectable, +wrapped, or ellipsized. + + + + + + the angle that the baseline of the label makes with the horizontal, in degrees, measured counterclockwise + + + + + + Sets a #PangoAttrList; the attributes in the list are applied to the +label text. <note><para>The attributes set with this function will be applied and merged with any other attributes previously effected by way of the #GtkLabel:use-underline or #GtkLabel:use-markup properties. While it is not recommended to mix markup strings with manually set attributes, if you must; know that the attributes will be applied -to the label after the markup string is parsed.</para></note>"> +to the label after the markup string is parsed.</para></note> + a #PangoAttrList - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + if there is not enough space to render the entire string. + a #PangoEllipsizeMode - - - - - - + + Sets the alignment of the lines in the text of the label relative to +each other. %GTK_JUSTIFY_LEFT is the default value when the +widget is first created with gtk_label_new(). If you instead want +to set the alignment of the label as a whole, use +gtk_misc_set_alignment() instead. gtk_label_set_justify() has no +effect on labels containing only a single line. - - + + a #GtkJustification + - + + Sets the text of the label. The label is interpreted as +including embedded underlines and/or Pango markup depending +on the values of the #GtkLabel:use-underline" and +#GtkLabel:use-markup properties. - + + + + the new text to set for the label + + + + + + Toggles line wrapping within the #GtkLabel widget. %TRUE makes it break +lines if text exceeds the widget's size. %FALSE lets the text get cut off +by the edge of the widget if it exceeds the widget size. +Note that setting line wrapping to %TRUE does not make the label +wrap at its parent container's width, because GTK+ widgets +conceptually can't make their requisition depend on the parent +container's size. For a label that wraps at a specific position, +set the label's width using gtk_widget_set_size_request(). + + + + + + the setting + + + + + + If line wrapping is on (see gtk_label_set_line_wrap()) this controls how +the line wrapping is done. The default is %PANGO_WRAP_WORD which means +wrap on word boundaries. + + + + + + the line wrapping mode + + + + + + Parses @str which is marked up with the <link +linkend="PangoMarkupFormat">Pango text markup language</link>, setting the +label's text and attribute list based on the parse results. If the @str is +external data, you may need to escape it with g_markup_escape_text() or +g_markup_printf_escaped()<!-- -->: +|[ +char *markup; +markup = g_markup_printf_escaped ("&lt;span style=\"italic\"&gt;&percnt;s&lt;/span&gt;", str); +gtk_label_set_markup (GTK_LABEL (label), markup); +g_free (markup); +]| + + + + + + a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) + + + + + + Parses @str which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>, +setting the label's text and attribute list based on the parse results. +If characters in @str are preceded by an underscore, they are underlined +indicating that they represent a keyboard accelerator called a mnemonic. +The mnemonic key can be used to activate another widget, chosen +automatically, or explicitly using gtk_label_set_mnemonic_widget(). + + + + + + a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) + + + + Sets the desired maximum width in characters of @label to @n_chars. - + the new desired maximum width, in characters. + - + + If the label has been set so that it has an mnemonic key (using +i.e. gtk_label_set_markup_with_mnemonic(), +gtk_label_set_text_with_mnemonic(), gtk_label_new_with_mnemonic() +or the "use_underline" property) the label can be associated with a +widget that is the target of the mnemonic. When the label is inside +a widget (like a #GtkButton or a #GtkNotebook tab) it is +automatically associated with the correct widget, but sometimes +(i.e. when the target is a #GtkEntry next to the label) you need to +set it explicitly using this function. +The target widget will be accelerated by emitting the +GtkWidget::mnemonic-activate signal on it. The default handler for +this signal will activate the widget if there are no mnemonic collisions +and toggle focus between the colliding widgets otherwise. - + + + + the target #GtkWidget + + + @@ -31901,463 +28271,280 @@ gtk_label_set_width_chars()." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Selectable labels allow the user to select text from the label, for +copy-and-paste. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE to allow selecting text in the label + + Sets whether the label is in single line mode. - + %TRUE if the label should be in single line mode + - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the text within the #GtkLabel widget. It overwrites any text that +was there before. +This will also clear any previously set mnemonic accelerators. - - - + The text you want to set + - + + Sets the label's text from the string @str. +If characters in @str are preceded by an underscore, they are underlined +indicating that they represent a keyboard accelerator called a mnemonic. +The mnemonic key can be used to activate another widget, chosen +automatically, or explicitly using gtk_label_set_mnemonic_widget(). - + - + + a string + + Sets whether the label should keep track of clicked +links (and use a different color for them). + + + + + + %TRUE to track visited links + + + + + + Sets whether the text of the label contains markup in <link +linkend="PangoMarkupFormat">Pango's text markup +language</link>. See gtk_label_set_markup(). + + + + + + %TRUE if the label's text should be parsed for markup. + + + + + + If true, an underline in the text indicates the next character should be +used for the mnemonic accelerator key. + + + + + + %TRUE if underlines in the text indicate mnemonics + + + + + + Sets the desired width in characters of @label to @n_chars. + + + + + + the new desired width, in characters. + + + + + The angle that the baseline of the label makes with the horizontal, in degrees, measured counterclockwise. An angle of 90 reads from from bottom to top, an angle of 270, from top to bottom. Ignored -if the label is selectable, wrapped, or ellipsized."> - +if the label is selectable, wrapped, or ellipsized. + - - + + - - + + - + transfer-ownership="none"> + The preferred place to ellipsize the string, if the label does +not have enough room to display the entire string, specified as a +#PangoEllisizeMode. +Note that setting this property to a value other than +%PANGO_ELLIPSIZE_NONE has the side-effect that the label requests +only enough space to display the ellipsis "...". In particular, this +means that ellipsizing labels do not work well in notebook tabs, unless +the tab's #GtkNotebook:tab-expand property is set to %TRUE. Other ways +to set a label's width are gtk_widget_set_size_request() and +gtk_label_set_width_chars(). + - - + + - - + + - + transfer-ownership="none"> + The desired maximum width of the label, in characters. If this property +is set to -1, the width will be calculated automatically. +See the section on <link linkend="label-text-layout">text layout</link> +for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars +determine the width of ellipsized and wrapped labels. + - - + + - - + + - - + + - - + + - - + + + Whether the label is in single line mode. In single line mode, the height of the label does not depend on the actual text, it is always set to ascent + descent of the font. This can be an -advantage in situations where resizing the label because of text -changes would be distracting, e.g. in a statusbar."> - +advantage in situations where resizing the label because of text +changes would be distracting, e.g. in a statusbar. + + Set this property to %TRUE to make the label track which links have been clicked. It will then apply the ::visited-link-color -color, instead of ::link-color."> - +color, instead of ::link-color. + - - + + - - + + - + transfer-ownership="none"> + The desired width of the label, in characters. If this property is set to +-1, the width will be calculated automatically. +See the section on <link linkend="label-text-layout">text layout</link> +for details of how #GtkLabel:width-chars and #GtkLabel:max-width-chars +determine the width of ellipsized and wrapped labels. + - - + + - + transfer-ownership="none"> + If line wrapping is on (see the #GtkLabel:wrap property) this controls +how the line wrapping is done. The default is %PANGO_WRAP_WORD, which +means wrap on word boundaries. + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + A <link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user activates a link in the label. Applications may also emit the signal with g_signal_emit_by_name() if they need to control activation of URIs programmatically. -The default bindings for this signal are all forms of the Enter key." - version="2.18"> - - +The default bindings for this signal are all forms of the Enter key. + + - + The signal which gets emitted to activate a URI. Applications may connect to it to override the default behaviour, -which is to call gtk_show_uri()." - version="2.18"> - - +which is to call gtk_show_uri(). + + %TRUE if the link has been activated + - - + + the URI that is activated + - + The ::copy-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to copy the selection to the clipboard. -The default binding for this signal is Ctrl-c."> - - +The default binding for this signal is Ctrl-c. + + - + The ::move-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates a cursor movement. If the cursor is not visible in @entry, this signal causes the viewport to be moved instead. @@ -32372,34 +28559,38 @@ There are too many key combinations to list them all here. <listitem>Arrow keys move by individual characters/lines</listitem> <listitem>Ctrl-arrow key combinations move by words/paragraphs</listitem> <listitem>Home/End keys move to the ends of the buffer</listitem> -</itemizedlist>"> - - +</itemizedlist> + + - - + + the granularity of the move, as a #GtkMovementStep + - - + + the number of @step units to move + - - + + %TRUE if the move should extend the selection + - + The ::populate-popup signal gets emitted before showing the context menu of the label. Note that only selectable labels have context menus. If you need to add items to the context menu, connect -to this signal and append your menuitems to the @menu."> - - +to this signal and append your menuitems to the @menu. + + - - + + the menu that is being populated + @@ -32411,7 +28602,7 @@ to this signal and append your menuitems to the @menu."> - + @@ -32423,16 +28614,16 @@ to this signal and append your menuitems to the @menu."> - + - + - + @@ -32444,7 +28635,7 @@ to this signal and append your menuitems to the @menu."> - + @@ -32459,9 +28650,9 @@ to this signal and append your menuitems to the @menu."> - + - + @@ -32473,31 +28664,36 @@ to this signal and append your menuitems to the @menu."> - - + + - - + + - - + + - + + + glib:type-struct="LayoutClass"> - - - + + + Creates a new #GtkLayout. Unless you have a specific adjustment +you'd like the layout to use for scrolling, pass %NULL for + + a new #GtkLayout + + allow-none="1"> + horizontal scroll adjustment, or %NULL + allow-none="1"> + vertical scroll adjustment, or %NULL - + Retrieve the bin window of the layout used for drawing operations. + + a #GdkWindow - + + This function should only be called after the layout has been +placed in a #GtkScrolledWindow or otherwise configured for +scrolling. It returns the #GtkAdjustment used for communication +between the horizontal scrollbar and @layout. +See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details. + + horizontal scroll adjustment + + + + + Gets the size that has been set on the layout, and that determines +the total extents of the layout's scrollbar area. See +gtk_layout_set_size (). + + + + + + location to store the width set on @layout, or %NULL + + + + location to store the height set on @layout, or %NULL + + + + + + This function should only be called after the layout has been +placed in a #GtkScrolledWindow or otherwise configured for +scrolling. It returns the #GtkAdjustment used for communication +between the vertical scrollbar and @layout. +See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details. + + vertical scroll adjustment + + + + + Moves a current child of @layout to a new position. + a current child of @layout - + X position to move to + - + Y position to move to + - + + Adds @child_widget to @layout, at position (@x,@y). + child widget - + X position of child widget + - + Y position of child widget + - + + Sets the horizontal scroll adjustment for the layout. +See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details. + + + + + + new scroll adjustment + + + + + + Sets the size of the scrollable area of the layout. - + width of entire scrollable area + - + height of entire scrollable area + - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the vertical scroll adjustment for the layout. +See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details. + allow-none="1"> + new scroll adjustment - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - + @@ -32745,8 +28898,7 @@ See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details."> - + @@ -32763,165 +28915,183 @@ See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details."> - - + + - - + + - - + + - - + + + + + + The type of license for an application. +This enumeration can be expanded at later date. + + + + + + + + + + - + + - - + Creates a new #GtkLinkButton with the URI as its text. + + a new link button widget. + + a valid URI - - + Creates a new #GtkLinkButton containing a label. + + a new link button widget. + + a valid URI - + + the text of the button - - - - - - - - - - - - - - - - + Retrieves the URI set using gtk_link_button_set_uri(). +and should not be modified or freed. + a valid URI. The returned string is owned by the link button + + Retrieves the 'visited' state of the URI where the #GtkLinkButton +points. The button becomes visited when it is clicked. If the URI +is changed on the button, the 'visited' state is unset again. +The state may also be changed using gtk_link_button_set_visited(). + + %TRUE if the link has been visited, %FALSE otherwise + + + + Sets @uri as the URI where the #GtkLinkButton points. As a side-effect +this unsets the 'visited' state of the button. + a valid URI - - - - - + Sets the 'visited' state of the URI where the #GtkLinkButton +points. See gtk_link_button_get_visited() for more details. - + the new 'visited' state + - - + + - - + + @@ -32936,675 +29106,41 @@ points. See gtk_link_button_get_visited() for more details." - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Creates a new list store as with @n_columns columns each of the types passed +in. Note that only types derived from standard GObject fundamental types +are supported. As an example, <literal>gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING, GDK_TYPE_PIXBUF);</literal> will create a new #GtkListStore with three columns, of type -int, string and #GdkPixbuf respectively."> +int, string and #GdkPixbuf respectively. + a new #GtkListStore - + number of columns in the list store + @@ -33636,206 +29175,126 @@ int, string and #GdkPixbuf respectively."> - - + + Non-vararg creation function. Used primarily by language bindings. + + a new #GtkListStore - + number of columns in the list store + - + + an array of #GType types for the columns, from first to last - - + + + Appends a new row to @list_store. @iter will be changed to point to this new +row. The row will be empty after this function is called. To fill in +values, you need to call gtk_list_store_set() or gtk_list_store_set_value(). - - - - - - - + + An unset #GtkTreeIter to set to the appended row + - + + Removes all rows from the list store. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a new row at @position. @iter will be changed to point to this new row. If @position is larger than the number of rows on the list, then the new row will be appended to the list. The row will be empty after this -function is called. To fill in values, you need to call -gtk_list_store_set() or gtk_list_store_set_value()."> +function is called. To fill in values, you need to call +gtk_list_store_set() or gtk_list_store_set_value(). - + + An unset #GtkTreeIter to set to the new row - + position to insert the new row + - - - - - - - - - - - - - - + Inserts a new row after @sibling. If @sibling is %NULL, then the row will be prepended to the beginning of the list. @iter will be changed to point to this new row. The row will be empty after this function is called. To fill -in values, you need to call gtk_list_store_set() or gtk_list_store_set_value()."> +in values, you need to call gtk_list_store_set() or gtk_list_store_set_value(). - + + An unset #GtkTreeIter to set to the new row - + + A valid #GtkTreeIter, or %NULL + + + + + + Inserts a new row before @sibling. If @sibling is %NULL, then the row will +be appended to the end of the list. @iter will be changed to point to this +new row. The row will be empty after this function is called. To fill in +values, you need to call gtk_list_store_set() or gtk_list_store_set_value(). + + + + + + An unset #GtkTreeIter to set to the new row + + + + A valid #GtkTreeIter, or %NULL + Creates a new row at @position. @iter will be changed to point to this new row. If @position is larger than the number of rows on the list, then the -new row will be appended to the list. The row will be filled with the -values given to this function. +new row will be appended to the list. The row will be filled with the +values given to this function. Calling -<literal>gtk_list_store_insert_with_values(list_store, iter, position...)</literal> -has the same effect as calling +<literal>gtk_list_store_insert_with_values(list_store, iter, position...)</literal> +has the same effect as calling |[ gtk_list_store_insert (list_store, iter, position); gtk_list_store_set (list_store, iter, ...); @@ -33843,22 +29302,24 @@ gtk_list_store_set (list_store, iter, ...); with the difference that the former will only emit a row_inserted signal, while the latter will emit row_inserted, row_changed and, if the list store is sorted, rows_reordered. Since emitting the rows_reordered signal -repeatedly can affect the performance of the program, +repeatedly can affect the performance of the program, gtk_list_store_insert_with_values() should generally be preferred when -inserting rows in a sorted list store." - version="2.6"> +inserting rows in a sorted list store. + allow-none="1"> + An unset #GtkTreeIter to set to the new row, or %NULL. - + position to insert the new row + @@ -33868,158 +29329,277 @@ inserting rows in a sorted list store." + A variant of gtk_list_store_insert_with_values() which +takes the columns and values as two arrays, instead of +varargs. This function is mainly intended for +language-bindings. + allow-none="1"> + An unset #GtkTreeIter to set to the new row, or %NULL. - + position to insert the new row + - - + + an array of column numbers + + an array of GValues - + the length of the @columns and @values arrays + - - - - - - - - - - - - - - - - - - - - - - - - - + <warning>This function is slow. Only use it for debugging and/or testing +purposes.</warning> +Checks if the given iter is a valid iter for this #GtkListStore. - + %TRUE if the iter is valid, %FALSE if the iter is invalid. + - - - - - - - - - - - - - - - - - - - - - - - + A #GtkTreeIter. + Moves @iter in @store to the position after @position. Note that this +function only works with unsorted stores. If @position is %NULL, @iter +will be moved to the start of the list. + A #GtkTreeIter. - + + A #GtkTreeIter or %NULL. + Moves @iter in @store to the position before @position. Note that this +function only works with unsorted stores. If @position is %NULL, @iter +will be moved to the end of the list. + A #GtkTreeIter. - + + A #GtkTreeIter, or %NULL. + + + + + + Prepends a new row to @list_store. @iter will be changed to point to this new +row. The row will be empty after this function is called. To fill in +values, you need to call gtk_list_store_set() or gtk_list_store_set_value(). + + + + + + An unset #GtkTreeIter to set to the prepend row + + + + + + Removes the given row from the list store. After being removed, +to the last row in @list_store. + + %TRUE if @iter is valid, %FALSE if not. + + + + + A valid #GtkTreeIter + + + + + + Reorders @store to follow the order indicated by @new_order. Note that +this function only works with unsorted stores. + + + + + + an array of integers mapping the new position of each child to its old position before the re-ordering, i.e. @new_order<literal>[newpos] = oldpos</literal>. + + + + + + Sets the value of one or more cells in the row referenced by @iter. +The variable argument list should contain integer column numbers, +each column number followed by the value to be set. +The list is terminated by a -1. For example, to set column 0 with type +%G_TYPE_STRING to "Foo", you would write <literal>gtk_list_store_set (store, iter, +0, "Foo", -1)</literal>. +The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it +will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED. + + + + + + row iterator + + + + + + + + + + This function is meant primarily for #GObjects that inherit from #GtkListStore, +and should only be used when constructing a new #GtkListStore. It will not +function after a row has been added, or a method on the #GtkTreeModel +interface is called. + + + + + + Number of columns for the list store + + + + An array length n of #GTypes + + + + + + + + See gtk_list_store_set(); this version takes a va_list for use by language +bindings. + + + + + + A valid #GtkTreeIter for the row being modified + + + + va_list of column/value pairs + + + + + + Sets the data in the cell specified by @iter and @column. +The type of @value must be convertible to the type of the +column. + + + + + + A valid #GtkTreeIter for the row being modified + + + + column number to modify + + + + new value for the cell + + + + + + A variant of gtk_list_store_set_valist() which +takes the columns and values as two arrays, instead of +varargs. This function is mainly intended for +language-bindings and in case the number of columns to +change is not known until run-time. + + + + + + A valid #GtkTreeIter for the row being modified + + + + an array of column numbers + + + + + + an array of GValues + + + + + + the length of the @columns and @values arrays + + + + + + Swaps @a and @b in @store. Note that this function only works with +unsorted stores. + + + + + + A #GtkTreeIter. + + + + Another #GtkTreeIter. @@ -34027,44 +29607,8 @@ will be moved to the end of the list." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + + + - + - + - - + + - - + + - - - - - - - - + - - + + - + Returns a list of the menus which are attached to this widget. +This list is owned by GTK+ and must not be modified. + + the list of menus attached to his widget. + a #GtkWidget - + Adds a new #GtkMenuItem to a (table) menu. The number of 'cells' that +an item will occupy is specified by @left_attach, @right_attach, +rightmost, uppermost and lower column and row numbers of the table. +(Columns and rows are indexed from zero). +Note that this function is not related to gtk_menu_detach(). + + + + + + a #GtkMenuItem. + + + + The column number to attach the left side of the item to. + + + + The column number to attach the right side of the item to. + + + + The row number to attach the top of the item to. + + + + The row number to attach the bottom of the item to. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Retrieves the number of the monitor on which to show the menu. +be popped up or -1, if no monitor has been set + + the number of the monitor on which the menu should + + + + + Returns whether the menu reserves space for toggles and +icons, regardless of their actual presence. + + Whether the menu reserves toggle space + + + + + Returns whether the menu is torn off. See +gtk_menu_set_tearoff_state (). + + %TRUE if the menu is currently torn off. + + + + + Returns the title of the menu. See gtk_menu_set_title(). +title set on it. This string is owned by the widget and should +not be modified or freed. + + the title of the menu, or %NULL if the menu has no + + + + + + + + + + Displays a menu and makes it available for selection. Applications can use this function to display context-sensitive menus, and will typically supply -%NULL for the @parent_menu_shell, @parent_menu_item, @func and @data +%NULL for the @parent_menu_shell, @parent_menu_item, @func and @data parameters. The default menu positioning function will position the menu at the current mouse cursor position. The @button parameter should be the mouse button pressed to initiate @@ -34188,42 +29828,121 @@ concurrent requests for mouse/keyboard grab requests. To function properly, this needs to be the time stamp of the user event (such as a mouse click or key press) that caused the initiation of the popup. Only if no such event is available, gtk_get_current_event_time() can -be used instead."> +be used instead. + allow-none="1"> + the menu shell containing the triggering menu item, or %NULL + allow-none="1"> + the menu item whose activation triggered the popup, or %NULL + closure="3"> + a user supplied function used to position the menu, or %NULL - - + + user supplied data to be passed to @func. + - + the mouse button which was pressed to initiate the event. + - + the time at which the activation event occurred. + + + + + + Displays a menu and makes it available for selection. +Applications can use this function to display context-sensitive menus, +and will typically supply %NULL for the @parent_menu_shell, +menu positioning function will position the menu at the current position +of @device (or its corresponding pointer). +The @button parameter should be the mouse button pressed to initiate +the menu popup. If the menu popup was initiated by something other than +a mouse button press, such as a mouse button release or a keypress, +The @activate_time parameter is used to conflict-resolve initiation of +concurrent requests for mouse/keyboard grab requests. To function +properly, this needs to be the time stamp of the user event (such as +a mouse click or key press) that caused the initiation of the popup. +Only if no such event is available, gtk_get_current_event_time() can +be used instead. + + + + + + a #GdkDevice + + + + the menu shell containing the triggering menu item, or %NULL + + + + the menu item whose activation triggered the popup, or %NULL + + + + a user supplied function used to position the menu, or %NULL + + + + user supplied data to be passed to @func + + + + destroy notify for @data + + + + the mouse button which was pressed to initiate the event + + + + the time at which the activation event occurred + + + + + + + + + + + + + + @@ -34232,26 +29951,6 @@ be used instead."> - - - - - - - - - - - - - - - - - - - - @@ -34264,11 +29963,6 @@ be used instead."> - - - - - @@ -34279,34 +29973,64 @@ be used instead."> - - - - - - + - - - - - + + - + + Informs GTK+ on which monitor a menu should be popped up. +See gdk_screen_get_monitor_geometry(). +This function should be called from a #GtkMenuPositionFunc if the +menu should not appear on the same monitor as the pointer. This +information can't be reliably inferred from the coordinates returned +by a #GtkMenuPositionFunc, since, for very long menus, these coordinates +may extend beyond the monitor boundaries or even the screen boundaries. + + + the number of the monitor on which the menu should be popped up + + + - - - + + Sets whether the menu should reserve space for drawing toggles +or icons, regardless of their actual presence. + + + + + whether to reserve size for toggles + + + + + + Sets the #GdkScreen on which the menu will be displayed. + + + + + + a #GdkScreen, or %NULL if the screen should be determined by the widget the menu is attached to. + + + @@ -34315,205 +30039,84 @@ be used instead."> - + - - - - - - + Sets the title string for the menu. The title is displayed when the menu is shown as a tearoff menu. If @title is %NULL, the menu will see if it is attached to a parent menu item, and if so it will try to use the same text as -that menu item's label."> +that menu item's label. + a string containing the title for the menu. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + transfer-ownership="none"> + The accel group holding accelerators for the menu. + - + transfer-ownership="none"> + An accel path used to conveniently construct accel paths of child items. + - + transfer-ownership="none"> + The index of the currently selected menu item, or -1 if no +menu item is selected. + + The widget the menu is attached to. Setting this property attaches the menu without a #GtkMenuDetachFunc. If you need to use a detacher, -use gtk_menu_attach_to_widget() directly."> - +use gtk_menu_attach_to_widget() directly. + - + transfer-ownership="none"> + The monitor the menu will be popped up on. + + A boolean that indicates whether the menu reserves space for toggles and icons, regardless of their actual presence. This property should only be changed from its default value for special-purposes such as tabular menus. Regular menus that are connected to a menu bar or context menus should reserve -toggle space for consistency."> - +toggle space for consistency. + - + transfer-ownership="none"> + A boolean that indicates whether the menu is torn-off. + - - + + @@ -34534,10 +30137,10 @@ toggle space for consistency."> - + - + @@ -34561,59 +30164,60 @@ toggle space for consistency."> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - + + - + glib:type-struct="MenuBarClass"> + - - + + - - + Retrieves the current child pack direction of the menubar. +See gtk_menu_bar_set_child_pack_direction(). + + the child pack direction - + Retrieves the current pack direction of the menubar. +See gtk_menu_bar_set_pack_direction(). - - - - - - - - - - + the pack direction + Sets how widgets should be packed inside the children of a menubar. + a new #GtkPackDirection + + + + + + Sets how items should be packed inside a menubar. + + + + + + a new #GtkPackDirection @@ -34673,20 +30282,25 @@ See gtk_menu_bar_set_child_pack_direction()." - + transfer-ownership="none"> + The child pack direction of the menubar. It determines how +the widgets contained in child menuitems are arranged. + - + transfer-ownership="none"> + The pack direction of the menubar. It determines how +menuitems are arranged in the menubar. + + + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + @@ -34805,41 +30408,26 @@ menuitems are arranged in the menubar."> c:identifier="GTK_MENU_DIR_PREV" glib:nick="prev"/> - - - - - - - - - - - - - - - - - - + + - - + + - - + + @@ -34848,60 +30436,42 @@ menuitems are arranged in the menubar."> + Creates a new #GtkMenuItem containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores -in @label indicate the mnemonic for the menu item."> - - +in @label indicate the mnemonic for the menu item. + + a new #GtkMenuItem + + The text of the button, with an underscore in front of the mnemonic character - + + Sets @text on the @menu_item label +string used by the label, and must not be modified. + + The text in the @menu_item label. This is the internal + + + + + Sets @text on the @menu_item label + the text you want to set - - - - - - - - - - - - - - - - - - - - - + @@ -34911,59 +30481,54 @@ gtk_menu_item_set_submenu()."> - + - + - + + Sets @text on the @menu_item label +string used by the label, and must not be modified. - + The text in the @menu_item label. This is the internal + - - - - - - - - - - - - - - - - - - - - - - - - - + Gets whether the menu item appears justified at the right side of the menu bar. -far right if added to a menu bar."> +far right if added to a menu bar. - + %TRUE if the menu item will appear at the + + + + + Gets the submenu underneath this menu item, if any. +See gtk_menu_item_set_submenu(). + + submenu for this menu item, or %NULL if none. + + + + + Checks if an underline in the text indicates the next character should be +used for the mnemonic accelerator key. +the mnemonic accelerator key. + + %TRUE if an embedded underline in the label indicates + + + + + + - - - - - + Sets @text on the @menu_item label + the text you want to set - + + Sets whether the menu item appears justified at the right +side of a menu bar. This was traditionally done for "Help" menu +items, but is now considered a bad idea. (If the widget +layout is reversed for a right-to-left language like Hebrew +or Arabic, right-justified-menu-items appear at the left.) - + + + + if %TRUE the menu item will appear at the far right if added to a menu bar. + + + + + + Sets or replaces the menu item's submenu, or removes it when a %NULL +submenu is passed. + + + + + + the submenu, or %NULL + + + + If true, an underline in the text indicates the next character should be +used for the mnemonic accelerator key. - + %TRUE if underlines in the text indicate mnemonics + - - - - - - + + + + + + + + + + + + + + + + - + transfer-ownership="none"> + Sets the accelerator path of the menu item, through which runtime +changes of the menu item's accelerator caused by the user can be +identified and saved to persistant storage. + - + transfer-ownership="none"> + The text for the child label. + - + transfer-ownership="none"> + Sets whether the menu item appears justified at the right side of a menu bar. + - + transfer-ownership="none"> + The submenu attached to the menu item, or NULL if it has none. + - + transfer-ownership="none"> + %TRUE if underlines in the text indicate mnemonics + - - + + @@ -35082,62 +30670,72 @@ identified and saved to persistant storage."> - + - + - + - + - + - + - + - + - + - - + + - - + + + + + + + + + + + + - - + + - + - - + + - + @@ -35146,13 +30744,13 @@ identified and saved to persistant storage."> c:type="GtkMenuItemClass" glib:is-gtype-struct-for="MenuItem"> - + - + - + @@ -35164,7 +30762,7 @@ identified and saved to persistant storage."> - + @@ -35176,7 +30774,7 @@ identified and saved to persistant storage."> - + @@ -35184,16 +30782,14 @@ identified and saved to persistant storage."> - - + + - + @@ -35202,13 +30798,13 @@ identified and saved to persistant storage."> - + - + @@ -35217,14 +30813,16 @@ identified and saved to persistant storage."> + the text you want to set - + + The text in the @menu_item label. This is the internal @@ -35234,15 +30832,53 @@ identified and saved to persistant storage."> - - + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + + + @@ -35257,21 +30893,22 @@ identified and saved to persistant storage."> - - + + - - + + - - + + - + glib:type-struct="MenuShellClass"> - + + - + - - - - - @@ -35299,15 +30932,33 @@ identified and saved to persistant storage."> - + - + - + + + + + + + + + + + + + + + + + + + @@ -35318,6 +30969,44 @@ identified and saved to persistant storage."> + + Cancels the selection within the menu shell. + + + + + + + + + + + + + + + + Returns %TRUE if the menu shell will take the keyboard focus on popup. + + %TRUE if the menu shell will take the keyboard focus on popup. + + + + + + + + + + + + + + + + @@ -35328,24 +31017,22 @@ identified and saved to persistant storage."> - + + Select the first visible or selectable child of the menu shell; +don't select tearoff items unless the only item is a tearoff +item. - - - - - + + if %TRUE, search for the first selectable menu item, otherwise select nothing if the first item isn't sensitive. This should be %FALSE if the menu is being popped up initially. + - - - - - @@ -35356,102 +31043,53 @@ identified and saved to persistant storage."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + If @take_focus is %TRUE (the default) the menu shell will take the keyboard focus so that it will receive all keyboard events which is needed to enable keyboard navigation in menus. Setting @take_focus to %FALSE is useful only for special applications like virtual keyboard implementations which should not take keyboard focus. The @take_focus state of a menu or menu bar is automatically propagated -to submenus whenever a submenu is popped up, so you don't have to worry +to submenus whenever a submenu is popped up, so you don't have to worry about recursively setting it for your entire menu hierarchy. Only when programmatically picking a submenu and popping it up manually, the Note that setting it to %FALSE has side-effects: If the focus is in some other app, it keeps the focus and keynav in -the menu doesn't work. Consequently, keynav on the menu will only +the menu doesn't work. Consequently, keynav on the menu will only work if the focus is on some toplevel owned by the onscreen keyboard. To avoid confusing the user, menus with @take_focus set to %FALSE should not display mnemonics or accelerators, since it cannot be guaranteed that they will work. -See also gdk_keyboard_grab()" - version="2.8"> +See also gdk_keyboard_grab() - + %TRUE if the menu shell should take the keyboard focus on popup. + + A boolean that determines whether the menu and its submenus grab the keyboard focus. See gtk_menu_shell_set_take_focus() and -gtk_menu_shell_get_take_focus()."> - +gtk_menu_shell_get_take_focus(). + - + + + @@ -35460,88 +31098,89 @@ gtk_menu_shell_get_take_focus()."> - + - + - + - + - + - + - + - + - + - - + + - + - - + + - - + + - + - - + + - - + + - + - - - + + The ::move-selected signal is emitted to move the selection to +another item. + + %TRUE to stop the signal emission, %FALSE to continue + - - + + +1 to move to the next item, -1 to move to the previous + - - + + @@ -35552,10 +31191,10 @@ another item." - + - + @@ -35567,7 +31206,7 @@ another item." - + @@ -35579,7 +31218,7 @@ another item." - + @@ -35594,7 +31233,7 @@ another item." - + @@ -35603,13 +31242,13 @@ another item." - + - + @@ -35621,7 +31260,7 @@ another item." - + @@ -35636,7 +31275,7 @@ another item." - + @@ -35648,15 +31287,15 @@ another item." - + - + - + @@ -35666,29 +31305,29 @@ another item." - + - + - + - - + + - - + + @@ -35696,135 +31335,113 @@ another item." - + + - - + Creates a new #GtkMenuToolButton using @icon_widget as icon and + + the new #GtkMenuToolButton + + allow-none="1"> + a widget that will be used as icon widget, or %NULL - + + a string that will be used as label, or %NULL - - + Creates a new #GtkMenuToolButton. +The new #GtkMenuToolButton will contain an icon and label from +the stock item indicated by @stock_id. + + the new #GtkMenuToolButton + + the name of a stock item - - - - - - - - - - - + Gets the #GtkMenu associated with #GtkMenuToolButton. +with #GtkMenuToolButton + + the #GtkMenu associated - + + Sets the tooltip markup text to be used as tooltip for the arrow button +which pops up the menu. See gtk_tool_item_set_tooltip_text() for setting a +tooltip on the whole #GtkMenuToolButton. - - - - - - - + + markup text to be used as tooltip text for button's arrow button + Sets the tooltip text to be used as tooltip for the arrow button which +pops up the menu. See gtk_tool_item_set_tooltip_text() for setting a tooltip +on the whole #GtkMenuToolButton. + text to be used as tooltip text for button's arrow button - + + Sets the #GtkMenu that is popped up when the user clicks on the arrow. +If @menu is NULL, the arrow button becomes insensitive. - - + + the #GtkMenu associated with #GtkMenuToolButton + - - + + @@ -35832,15 +31449,15 @@ tooltip on the whole #GtkMenuToolButton." - + The ::show-menu signal is emitted before the menu is shown. +It can be used to populate the menu on demand, using +gtk_menu_tool_button_get_menu(). +Note that even if you populate the menu dynamically in this way, you must set an empty menu on the #GtkMenuToolButton beforehand, -since the arrow is made insensitive if the menu is not set."> - - +since the arrow is made insensitive if the menu is not set. + + @@ -35851,7 +31468,7 @@ since the arrow is made insensitive if the menu is not set."> - + @@ -35862,38 +31479,41 @@ since the arrow is made insensitive if the menu is not set."> - - + + - - + + - - + + - - + + - + glib:type-struct="MessageDialogClass"> + + Creates a new message dialog, which is a simple dialog with an icon indicating the dialog type (error, warning, etc.) and some text the -user may want to see. When the user clicks a button a "response" +user may want to see. When the user clicks a button a "response" signal is emitted with response IDs from #GtkResponseType. See -#GtkDialog for more details."> - - +#GtkDialog for more details. + + a new #GtkMessageDialog + - + + transient parent, or %NULL for none + flags + type of message + set of buttons to use + allow-none="1"> + printf()-style format string, or %NULL @@ -35941,10 +31565,12 @@ signal is emitted with response IDs from #GtkResponseType. See + Creates a new message dialog, which is a simple dialog with an icon indicating the dialog type (error, warning, etc.) and some text which -is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. -When the user clicks a button a "response" signal is emitted with +is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. +When the user clicks a button a "response" signal is emitted with response IDs from #GtkResponseType. See #GtkDialog for more details. Special XML characters in the printf() arguments passed to this function will automatically be escaped as necessary. @@ -35952,8 +31578,8 @@ function will automatically be escaped as necessary. Usually this is what you want, but if you have an existing Pango markup string that you want to use literally as the label, then you need to use gtk_message_dialog_set_markup() -instead, since you can't pass the markup string either -as the format (it might contain '%' characters) or as a string +instead, since you can't pass the markup string either +as the format (it might contain '%' characters) or as a string argument. |[ GtkWidget *dialog; @@ -35964,31 +31590,32 @@ GTK_BUTTONS_CLOSE, NULL); gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (dialog), markup); -]|" - version="2.4"> - - +]| + + a new #GtkMessageDialog + - + + transient parent, or %NULL for none + flags + type of message + set of buttons to use + allow-none="1"> + printf()-style format string, or %NULL @@ -35997,91 +31624,31 @@ markup); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the secondary text of the message dialog to be @message_format (with +printf()-style), which is marked up with the +<link linkend="PangoMarkupFormat">Pango text markup language</link>. Note that setting a secondary text makes the primary text become bold, unless you have provided explicit markup. Due to an oversight, this function does not escape special XML characters -like gtk_message_dialog_new_with_markup() does. Thus, if the arguments +like gtk_message_dialog_new_with_markup() does. Thus, if the arguments may contain special XML characters, you should use g_markup_printf_escaped() to escape it. <informalexample><programlisting> gchar *msg; msg = g_markup_printf_escaped (message_format, ...); -gtk_message_dialog_format_secondary_markup (message_dialog, "&percnt;s", msg); +gtk_message_dialog_format_secondary_markup (message_dialog, "&percnt;s", msg); g_free (msg); -</programlisting></informalexample>" - version="2.6"> +</programlisting></informalexample> - + + printf()-style markup string (see @@ -36090,58 +31657,146 @@ g_free (msg); - - + + Sets the secondary text of the message dialog to be @message_format +(with printf()-style). +Note that setting a secondary text makes the primary text become +bold, unless you have provided explicit markup. + + + + + + printf()-style format string, or %NULL + + + + + + + + + + Gets the dialog's image. + + the dialog's image + + + + + Returns the message area of the dialog. This is the box where the +dialog's primary and secondary labels are packed. You can add your +own extra content to that box and it will appear below those labels, +on the right side of the dialog's image (or on the left for right-to-left +languages). See gtk_dialog_get_content_area() for the corresponding +function in the parent #GtkDialog. +"message area" in the @message_dialog. + + A #GtkVBox corresponding to the + + + + + Sets the dialog's image to @image. + + + + + + the image + + + + + + Sets the text of the message dialog to be @str, which is marked +up with the <link linkend="PangoMarkupFormat">Pango text markup +language</link>. + + + + + + markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) + + + + + + - + transfer-ownership="none"> + The image for this dialog. + + + + - + transfer-ownership="none"> + The type of the message. The type is used to determine +the image that is shown in the dialog, unless the image is +explicitly set by the ::image property. + - + transfer-ownership="none"> + The secondary text of the message dialog. + - + transfer-ownership="none"> + %TRUE if the secondary text of the dialog includes Pango markup. +See pango_parse_markup(). + - + transfer-ownership="none"> + The primary text of the message dialog. If the dialog has +a secondary text, this will appear as the title. + - + transfer-ownership="none"> + %TRUE if the primary text of the dialog includes Pango markup. +See pango_parse_markup(). + - - - - - + + - - + + - - + + - - + + - - + + + + + The type of message being displayed in the dialog. glib:nick="centimeters"/> glib:type-struct="MiscClass"> + + + Gets the X and Y alignment of the widget within its allocation. +See gtk_misc_set_alignment(). + + + + + + location to store X alignment of @misc, or %NULL + + + + location to store Y alignment of @misc, or %NULL + + + + + + Gets the padding in the X and Y directions of the widget. +See gtk_misc_set_padding(). + + + + + + location to store padding in the X direction, or %NULL + + + + location to store padding in the Y direction, or %NULL + + + + - + - - - - - - - - - - - - - - + @@ -36273,63 +31945,30 @@ See gtk_misc_set_alignment()."> - + - + - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - - - - - - - - - - + + + + @@ -36354,8 +31995,8 @@ See gtk_misc_set_padding()."> - - + + @@ -36363,92 +32004,94 @@ See gtk_misc_set_padding()."> + This should not be accessed directly. Use the accessor functions below. + Creates a new #GtkMountOperation - + a new #GtkMountOperation + - + + transient parent of the window, or %NULL + + Gets the transient parent used by the #GtkMountOperation + + the transient parent for windows shown by @op + + + + + Gets the screen on which windows of the #GtkMountOperation +will be shown. + + the screen on which windows of @op are shown + + + + Returns whether the #GtkMountOperation is currently displaying +a window. - + %TRUE if @op is currently displaying a window + + Sets the transient parent for windows shown by the +#GtkMountOperation. - + + transient parent of the window, or %NULL - - - - - + Sets the screen to show windows of the #GtkMountOperation on. + a #GdkScreen - - - - - - - + + - - + + - - + + @@ -36463,36 +32106,38 @@ will be shown." - - + + - - + + - - + + - - + + - + - - - + + + Creates a new #GtkNotebook widget with no pages. + + the newly created #GtkNotebook + - - - - - - - - - - - - - - - - - + @@ -36600,728 +32216,568 @@ when a detached tab is dropped in an empty area." - + - - - + + Appends a page to @notebook. +page in the notebook, or -1 if function fails + + the index (starting from 0) of the appended + + the #GtkWidget to use as the contents of the page. - + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + Appends a page to @notebook, specifying the widget to use as the label in the popup menu. -page in the notebook, or -1 if function fails"> - - +page in the notebook, or -1 if function fails + + the index (starting from 0) of the appended + + the #GtkWidget to use as the contents of the page. - + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + allow-none="1"> + the widget to use as a label for the page-switch menu, if that is enabled. If %NULL, and @tab_label is a #GtkLabel or %NULL, then the menu label will be a newly created label with the same text as @tab_label; If @tab_label is not a #GtkLabel, @menu_label must be specified if the page-switch menu is to be used. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets one of the action widgets. See gtk_notebook_set_action_widget(). +or %NULL when this action widget has not been set - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The action widget with the given @pack_type - - + + pack type of the action widget to receive + + + + + + Returns the page number of the current page. +page in the notebook. If the notebook has no pages, then +-1 will be returned. + + the index (starting from 0) of the current + + + + + Gets the current group name for @notebook. +or %NULL if none is set. + + the group name, + + + + + Retrieves the menu label widget of the page containing @child. +notebook page does not have a menu label other than the +default (the tab label). + + the menu label, or %NULL if the + + + + + a widget contained in a page of @notebook + + + + + + Retrieves the text of the menu label for the page containing +widget does not have a menu label other than +the default menu label, or the menu label widget +is not a #GtkLabel. The string is owned by +the widget and must not be freed. + + the text of the tab label, or %NULL if the + + + + + the child widget of a page of the notebook. + + Gets the number of pages in a notebook. - + the number of pages in the notebook. + - + + Returns the child widget contained in page number @page_num. +out of bounds. - + the child widget, or %NULL if @page_num is + + + + + the index of a page in the notebook, or -1 to get the last page. + + + + + + Returns whether the tab label area has arrows for scrolling. See +gtk_notebook_set_scrollable(). + + %TRUE if arrows for scrolling are present + + + + + Returns whether a bevel will be drawn around the notebook pages. See +gtk_notebook_set_show_border(). + + %TRUE if the bevel is drawn + + + + + Returns whether the tabs of the notebook are shown. See +gtk_notebook_set_show_tabs(). + + %TRUE if the tabs are shown + + + + + Returns whether the tab contents can be detached from @notebook. + + TRUE if the tab is detachable. + + a child #GtkWidget - + + Returns the horizontal width of a tab border. + + horizontal width of a tab border + + + + + Returns the tab label widget for the page @child. %NULL is returned +if @child is not in @notebook or if no tab label has specifically +been set for @child. + + the tab label + + + + + the page + + + + + + Retrieves the text of the tab label for the page containing +tab label widget is not a #GtkLabel. The +string is owned by the widget and must not +be freed. + + the text of the tab label, or %NULL if the + + + + + a widget contained in a page of @notebook + + + + + + Gets the edge at which the tabs for switching pages in the +notebook are drawn. + + the edge at which the tabs are drawn + + + + + Gets whether the tab can be reordered via drag and drop or not. + + %TRUE if the tab is reorderable. + + + + + a child #GtkWidget + + + + + + Returns the vertical width of a tab border. + + vertical width of a tab border + + + + + Insert a page into @notebook at the given position. +page in the notebook, or -1 if function fails + + the index (starting from 0) of the inserted + + + + + the #GtkWidget to use as the contents of the page. + + + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + + + + the index (starting at 0) at which to insert the page, or -1 to append the page after all other pages. + + + + + + Insert a page into @notebook at the given position, specifying +the widget to use as the label in the popup menu. +page in the notebook + + the index (starting from 0) of the inserted + + + + + the #GtkWidget to use as the contents of the page. + + + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + + + + the widget to use as a label for the page-switch menu, if that is enabled. If %NULL, and @tab_label is a #GtkLabel or %NULL, then the menu label will be a newly created label with the same text as @tab_label; If @tab_label is not a #GtkLabel, @menu_label must be specified if the page-switch menu is to be used. + + + + the index (starting at 0) at which to insert the page, or -1 to append the page after all other pages. + + + + + + Switches to the next page. Nothing happens if the current page is +the last page. + + + + + + Finds the index of the page which contains the given child +widget. +-1 if @child is not in the notebook. + + the index of the page containing @child, or + + + + + a #GtkWidget + + + + + + Disables the popup menu. + + + + + + the tab labels, a menu with all the pages will be popped up. + + + + + + Prepends a page to @notebook. +page in the notebook, or -1 if function fails + + the index (starting from 0) of the prepended + + + + + the #GtkWidget to use as the contents of the page. + + + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + + + + + + Prepends a page to @notebook, specifying the widget to use as the +label in the popup menu. +page in the notebook, or -1 if function fails + + the index (starting from 0) of the prepended + + + + + the #GtkWidget to use as the contents of the page. + + + + the #GtkWidget to be used as the label for the page, or %NULL to use the default label, 'page N'. + + + + the widget to use as a label for the page-switch menu, if that is enabled. If %NULL, and @tab_label is a #GtkLabel or %NULL, then the menu label will be a newly created label with the same text as @tab_label; If @tab_label is not a #GtkLabel, @menu_label must be specified if the page-switch menu is to be used. + + + + + + Switches to the previous page. Nothing happens if the current page +is the first page. + + + + + + Removes a page from the notebook given its index +in the notebook. - + the index of a notebook page, starting from 0. If -1, the last page will be removed. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Reorders the page containing @child, so that it appears in position +children in the list or negative, @child will be moved to the end +of the list. + the child to move - - + + the new position, or -1 to move to the end + - + + Sets @widget as one of the action widgets. Depending on the pack type +the widget will be placed before or after the tabs. You can use +a #GtkBox if you need to pack more than one widget on the same side. +Note that action widgets are "internal" children of the notebook and thus +not included in the list returned from gtk_container_foreach(). - + + a #GtkWidget - + + pack type of the action widget + + + + + + Switches to the page number @page_num. +Note that due to historical reasons, GtkNotebook refuses +to switch to a page unless the child widget is visible. +Therefore, it is recommended to show child widgets before +adding them to a notebook. + + + + + + index of the page to switch to, starting from 0. If negative, the last page will be used. If greater than the number of pages in the notebook, nothing will be done. + + + + + + Sets a group name for @notebook. +Notebooks with the same name will be able to exchange tabs +via drag and drop. A notebook with a %NULL group name will +not be able to exchange tabs with any other notebook. + + + + + - - - - - - - - - - - - - - - - - - - - - + + Changes the menu label for the page containing @child. + the child widget + allow-none="1"> + the menu label, or NULL for default + c:identifier="gtk_notebook_set_menu_label_text"> + Creates a new label and sets it as the menu label of @child. + the child widget + the label text - - - - - - - - - - - + + Sets whether the tab label area will have arrows for scrolling if +there are too many tabs to fit in the area. - - - - - - - - - - - + + %TRUE if scroll arrows should be added + - + + Sets whether a bevel will be drawn around the notebook pages. +This only has a visual effect when the tabs are not shown. +See gtk_notebook_set_show_tabs(). - - - - - - - - - - - + + %TRUE if a bevel should be drawn around the notebook. + - + + Sets whether to show the tabs for the notebook or not. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + %TRUE if the tabs should be shown. + + Sets whether the tab can be detached from @notebook to another notebook or widget. Note that 2 notebooks must share a common group identificator -(see gtk_notebook_set_group_id ()) to allow automatic tabs +(see gtk_notebook_set_group()) to allow automatic tabs interchange between them. If you want a widget to interact with a notebook through DnD -destination and accept the target "GTK_NOTEBOOK_TAB". The notebook +(i.e.: accept dragged tabs from it) it must be set as a drop +destination and accept the target "GTK_NOTEBOOK_TAB". The notebook will fill the selection with a GtkWidget** pointing to the child widget that corresponds to the dropped tab. |[ @@ -37344,308 +32800,260 @@ gtk_container_remove (GTK_CONTAINER (notebook), *child); } ]| If you want a notebook to accept drags from other widgets, -you will have to set your own DnD code to do it." - version="2.10"> +you will have to set your own DnD code to do it. + a child #GtkWidget - + whether the tab is detachable or not + - - - - - - - - - - - + + Changes the tab label for @child. If %NULL is specified +for @tab_label, then the page will have the label 'page N'. - + + the page - - + + the tab label widget to use, or %NULL for default tab label. + - - + + Creates a new label and sets it as the tab label for the page +containing @child. + + + + + + the page + + + + the label text + + + + + + Sets the edge at which the tabs for switching pages in the +notebook are drawn. + + + + + + the edge to draw the tabs at. + + + + + + Sets whether the notebook tab can be reordered +via drag and drop or not. + + + + + + a child #GtkWidget + + + + whether the tab is reorderable or not. + + + + + + - - + transfer-ownership="none"> + Group name for tab drag and drop. + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - - - + + The ::create-window signal is emitted when a detachable +tab is dropped on the root window. +A handler for this signal can create a window containing +a notebook where the tab will be attached. It is also +responsible for moving/resizing the window and adding the +necessary properties to the notebook (e.g. the +#GtkNotebook:group ). + + a #GtkNotebook that @page should be added to, or %NULL. + - - + + the tab of @notebook that is being detached + - - + + the X coordinate where the drop happens + - - + + the Y coordinate where the drop happens + - - + + - + - - + + - + - - - + + the ::page-added signal is emitted in the notebook +right after a page is added to the notebook. + + - - + + the child #GtkWidget affected + - - + + the new page number for @child + - - - + + the ::page-removed signal is emitted in the notebook +right after a page is removed from the notebook. + + - - + + the child #GtkWidget affected + - - + + the @child page number + - - - + + the ::page-reordered signal is emitted in the notebook +right after a page has been reordered. + + - - + + the child #GtkWidget affected + - - + + the new page number for @child + - - + + - + - + - - + + - + - - + + - + - + @@ -37657,7 +33065,7 @@ right after a page has been reordered." - + @@ -37666,33 +33074,33 @@ right after a page has been reordered." - + - + - + - + - + - + - + @@ -37705,22 +33113,22 @@ right after a page has been reordered." - + - + - + - + @@ -37735,9 +33143,9 @@ right after a page has been reordered." - + - + @@ -37747,15 +33155,15 @@ right after a page has been reordered." - + - + - + @@ -37771,14 +33179,14 @@ right after a page has been reordered." - + - - - + + + @@ -37789,23 +33197,23 @@ right after a page has been reordered." - + - + - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Emits the #GtkObject::destroy signal notifying all reference holders that they should +release the #GtkObject. See the overview documentation at the top of the +page for more details. +The memory for the object itself won't be deleted until +its reference count actually drops to 0; gtk_object_destroy() merely asks +reference holders to release their references, it does not free the object. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - + Signals that all holders of a reference to the #GtkObject should release +the reference that they hold. May result in finalization of the object +if all references are released. + + @@ -38188,44 +33306,8 @@ right after a page has been reordered." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -38238,17 +33320,17 @@ right after a page has been reordered." + Tells about the state of the object. +store flags. - + + Creates a toplevel container widget that is used to retrieve snapshots of widgets without showing them on the screen. For widgets that are on the screen and part of a normal widget -hierarchy, gtk_widget_get_snapshot() can be used instead." - version="2.20"> - - +hierarchy, gtk_widget_get_snapshot() can be used instead. + + A pointer to a #GtkWidget + - - - - - + Retrieves a snapshot of the contained widget in the form of a #GdkPixbuf. This is a new pixbuf with a reference count of 1, and the application should unreference it once it is no longer -needed." - version="2.20"> +needed. + A #GdkPixbuf pointer, or %NULL. + + Retrieves a snapshot of the contained widget in the form of +a #GdkPixmap. If you need to keep this around over window +resizes then you should add a reference to it. +or %NULL. + + A #GdkPixmap pointer to the offscreen pixmap, + + + @@ -38309,656 +33397,41 @@ needed." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Retrieves the orientation of the @orientable. + + the orientation of the @orientable. + + + + Sets the orientation of the @orientable. + the orientable's new orientation. - - - - - - + transfer-ownership="none"> + The orientation of the orientable. + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - - + - + - + - + - + + Creates a new #GtkPageSetup. + a new #GtkPageSetup. + Reads the page setup from the file @file_name. Returns a +new #GtkPageSetup object with the restored page setup, +or %NULL if an error occurred. See gtk_page_setup_to_file(). + the restored #GtkPageSetup + the filename to read the page setup from + Reads the page setup from the group @group_name in the key file +page setup, or %NULL if an error occurred. + the restored #GtkPageSetup + the #GKeyFile to retrieve the page_setup from + allow-none="1"> + the name of the group in the key_file to read, or %NULL to use the default name "Page Setup" - + + Copies a #GtkPageSetup. + a copy of @other - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the bottom margin in units of @unit. - + the bottom margin + - - - - - - - - - - - - - + the unit for the return value + Gets the left margin in units of @unit. - + the left margin + + the unit for the return value - + Gets the page orientation of the #GtkPageSetup. - + the page orientation + - - - - - - - - - + Returns the page height in units of @unit. +Note that this function takes orientation and +margins into consideration. +See gtk_page_setup_get_paper_height(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the page height. + + the unit for the return value + Returns the page width in units of @unit. +Note that this function takes orientation and +margins into consideration. +See gtk_page_setup_get_paper_width(). - + the page width. + + the unit for the return value - + Returns the paper height in units of @unit. +Note that this function takes orientation, but +not margins into consideration. +See gtk_page_setup_get_page_height(). - + the paper height. + + the unit for the return value + + + + + + Gets the paper size of the #GtkPageSetup. + + the paper size + + + + + Returns the paper width in units of @unit. +Note that this function takes orientation, but +not margins into consideration. +See gtk_page_setup_get_page_width(). + + the paper width. + + + + + the unit for the return value + + + + + + Gets the right margin in units of @unit. + + the right margin + + + + + the unit for the return value + + + + + + Gets the top margin in units of @unit. + + the top margin + + + + + the unit for the return value + Reads the page setup from the file @file_name. +See gtk_page_setup_to_file(). - - - - - - - - - - - + %TRUE on success + + the filename to read the page setup from + Reads the page setup from the group @group_name in the key file - + %TRUE on success + + the #GKeyFile to retrieve the page_setup from + allow-none="1"> + the name of the group in the key_file to read, or %NULL to use the default name "Page Setup" + + Sets the bottom margin of the #GtkPageSetup. + + + + + + the new bottom margin in units of @unit + + + + the units for @margin + + + + + + Sets the left margin of the #GtkPageSetup. + + + + + + the new left margin in units of @unit + + + + the units for @margin + + + + + + Sets the page orientation of the #GtkPageSetup. + + + + + + a #GtkPageOrientation value + + + + + + Sets the paper size of the #GtkPageSetup without +changing the margins. See +gtk_page_setup_set_paper_size_and_default_margins(). + + + + + + a #GtkPaperSize + + + + + + Sets the paper size of the #GtkPageSetup and modifies +the margins according to the new paper size. + + + + + + a #GtkPaperSize + + + + + + Sets the right margin of the #GtkPageSetup. + + + + + + the new right margin in units of @unit + + + + the units for @margin + + + + + + Sets the top margin of the #GtkPageSetup. + + + + + + the new top margin in units of @unit + + + + the units for @margin + + + + + + This function saves the information from @setup to @file_name. + + %TRUE on success + + + + + the file to save to + + + + + This function adds the page setup from @setup to @key_file. + the #GKeyFile to save the page setup to + the group to add the settings to in @key_file, or %NULL to use the default name "Page Setup" @@ -39567,20 +34074,34 @@ This function adds the page setup from @setup to @key_file." - + + + + Creates a new #GtkPaned widget. + + a new #GtkPaned. + + + + + the paned's orientation. + + + + @@ -39601,6 +34122,43 @@ This function adds the page setup from @setup to @key_file." + + Obtains the first child of the paned widget. + + first child, or %NULL if it is not set. + + + + + Obtains the second child of the paned widget. + + second child, or %NULL if it is not set. + + + + + Returns the #GdkWindow of the handle. This function is +useful when handling button or motion events because it +enables the callback to distinguish between the window +of the paned, a child and the handle. + + the paned's handle window. + + + + + Obtains the position of the divider between the two panes. + + position of the divider + + + @@ -39610,10 +34168,10 @@ This function adds the page setup from @setup to @key_file." - + - + @@ -39626,248 +34184,122 @@ This function adds the page setup from @setup to @key_file." - + - + - - - - - - + + Sets the position of the divider between the two panes. - + pixel position of divider, a negative value means that the position is unset. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + The largest possible value for the position property. This property is derived from the +size and shrinkability of the widget's children. + - - + + The smallest possible value for the position property. This property is derived from the +size and shrinkability of the widget's children. + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The ::accept-position signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to accept the current position of the handle when moving it using key bindings. -The default binding for this signal is Return or Space." - version="2.0"> - - +The default binding for this signal is Return or Space. + + - + The ::cancel-position signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to cancel moving the position of the handle using key +bindings. The position of the handle will be reset to the value prior to moving it. -The default binding for this signal is Escape." - version="2.0"> - - +The default binding for this signal is Escape. + + - + The ::cycle-child-focus signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to cycle the focus between the children of the paned. -The default binding is f6." - version="2.0"> - - +The default binding is f6. + + - - + + whether cycling backward or forward + - + The ::cycle-handle-focus signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to cycle whether the paned should grab focus to allow the user to change position of the handle by using key bindings. -The default binding for this signal is f8." - version="2.0"> - - +The default binding for this signal is f8. + + - - + + whether cycling backward or forward + - - - + + The ::move-handle signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to move the handle when the user is using key bindings +to move it. + + - - + + a #GtkScrollType + - + The ::toggle-handle-focus is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to accept the current position of the handle and then move focus to the next widget in the focus chain. -The default binding is Tab." - version="2.0"> - - +The default binding is Tab. + + @@ -39878,24 +34310,24 @@ The default binding is Tab." - + - + - + - + - + @@ -39905,9 +34337,9 @@ The default binding is Tab." - + - + @@ -39920,24 +34352,24 @@ The default binding is Tab." - + - + - + - + - + @@ -39947,9 +34379,9 @@ The default binding is Tab." - + - + @@ -39958,307 +34390,337 @@ The default binding is Tab." - - + + - - + + - - + + - - + + - + - + + Creates a new #GtkPaperSize object by parsing a +<ulink url="ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf">PWG 5101.1-2002</ulink> paper name. If @name is %NULL, the default paper size is returned, see gtk_paper_size_get_default(). -to free it" - version="2.10"> +to free it + a new #GtkPaperSize, use gtk_paper_size_free() - + + a paper size name, or %NULL - - - - - - - - - - - - - - - - - - - + Creates a new #GtkPaperSize object with the +given parameters. +to free it + a new #GtkPaperSize object, use gtk_paper_size_free() + the paper name + the human-readable name - + the paper width, in units of @unit + - + the paper height, in units of @unit + + the unit for @width and @height + Reads a paper size from the group @group_name in the key file +paper size, or %NULL if an error occurred. + a new #GtkPaperSize object with the restored + the #GKeyFile to retrieve the papersize from + the name ofthe group in the key file to read, or %NULL to read the first group - + + Creates a new #GtkPaperSize object by using +PPD information. +If @ppd_name is not a recognized PPD paper name, +construct a custom #GtkPaperSize object. +to free it + a new #GtkPaperSize, use gtk_paper_size_free() + + + + + a PPD paper name + + + + the corresponding human-readable name + + + + the paper width, in points + + + + the paper height in points + + + + + + Copies an existing #GtkPaperSize. + + a copy of @other - + + Free the given #GtkPaperSize object. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the default bottom margin for the #GtkPaperSize. - + the default bottom margin + + the unit for the return value + Gets the default left margin for the #GtkPaperSize. - + the default left margin + + the unit for the return value + Gets the default right margin for the #GtkPaperSize. - + the default right margin + + the unit for the return value + + + + + + Gets the default top margin for the #GtkPaperSize. + + the default top margin + + + + + the unit for the return value + + + + + + Gets the human-readable name of the #GtkPaperSize. + + the human-readable name of @size + + + + + Gets the paper height of the #GtkPaperSize, in +units of @unit. + + the paper height + + + + + the unit for the return value + + + + + + Gets the name of the #GtkPaperSize. + + the name of @size + + + + + Gets the PPD name of the #GtkPaperSize, which +may be %NULL. + + the PPD name of @size + + + + + Gets the paper width of the #GtkPaperSize, in +units of @unit. + + the paper width + + + + + the unit for the return value + + + + + + Returns %TRUE if @size is not a standard paper size. + + whether @size is a custom paper size. + + + + + Compares two #GtkPaperSize objects. +represent the same paper size + + %TRUE, if @size1 and @size2 + + + + + another #GtkPaperSize object + + + + + + Changes the dimensions of a @size to @width x @height. + + + + + + the new width in units of @unit + + + + the new height in units of @unit + + + + the unit for @width and @height + This function adds the paper size from @size to @key_file. + the #GKeyFile to save the paper size to + the group to add the settings to in @key_file @@ -40310,88 +34772,8 @@ units of @unit." c:identifier="GTK_PATH_CLASS" glib:nick="class"/> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Creates a new plug widget inside the #GtkSocket identified +by @socket_id. If @socket_id is 0, the plug is left "unplugged" and +can later be plugged into a #GtkSocket by gtk_socket_add_id(). + + the new #GtkPlug widget. + + the window ID of the socket, or 0. - - + Create a new plug widget inside the #GtkSocket identified by socket_id. + + the new #GtkPlug widget. + + the #GdkDisplay on which @socket_id is displayed + the XID of the socket's window. - + + Finish the initialization of @plug for a given #GtkSocket identified by + the XID of the socket's window. + Finish the initialization of @plug for a given #GtkSocket identified by +This function will generally only be used by classes deriving from #GtkPlug. + the #GdkDisplay associated with @socket_id's #GtkSocket. + the XID of the socket's window. - - - - - + Determines whether the plug is embedded in a socket. - + %TRUE if the plug is embedded in a socket + + + + + Gets the window ID of a #GtkPlug widget, which can then +be used to embed this window inside another window, for +instance with gtk_socket_add_id(). + + the window ID for the plug + - + Retrieves the socket the plug is embedded in. + + the window of the socket, or %NULL - - + + %TRUE if the plug is embedded in a socket. + - - + + The window of the socket the plug is embedded in. + - - + + - - - - - - - - - - - - - - - + + Gets emitted when the plug becomes embedded in a socket. + + @@ -40526,7 +34902,7 @@ instance with gtk_socket_add_id()."> - + @@ -40537,35 +34913,37 @@ instance with gtk_socket_add_id()."> - - + + - - + + - - + + - - + + + + c:identifier="GTK_POS_BOTTOM" glib:nick="bottom"/> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a new #PangoContext that can be used with the +#GtkPrintContext. + a new Pango context for @context + Creates a new #PangoLayout that is suitable for use +with the #GtkPrintContext. + a new Pango layout for @context + + Obtains the cairo context that is associated with the +#GtkPrintContext. + + the cairo context of @context + + + + + Obtains the horizontal resolution of the #GtkPrintContext, +in dots per inch. + + the horizontal resolution of @context + + + + + Obtains the vertical resolution of the #GtkPrintContext, +in dots per inch. + + the vertical resolution of @context + + + + + Obtains the hardware printer margins of the #GtkPrintContext, in units. + + %TRUE if the hard margins were retrieved + + + + + top hardware printer margin + + + + bottom hardware printer margin + + + + left hardware printer margin + + + + right hardware printer margin + + + + + + Obtains the height of the #GtkPrintContext, in pixels. + + the height of @context + + + + + Obtains the #GtkPageSetup that determines the page +dimensions of the #GtkPrintContext. + + the page setup of @context + + + + + Returns a #PangoFontMap that is suitable for use +with the #GtkPrintContext. + + the font map of @context + + + + + Obtains the width of the #GtkPrintContext, in pixels. + + the width of @context + + + + Sets a new cairo context on a print context. This function is intended to be used when implementing an internal print preview, it is not needed for printing, since GTK+ itself creates a suitable cairo context in that -case." - version="2.10"> +case. + the cairo context - + the horizontal resolution to use with @cr + - + the vertical resolution to use with @cr + @@ -41011,20 +35166,8 @@ case." c:identifier="GTK_PRINT_ERROR_INVALID_FILE" glib:nick="invalid-file"/> - - - - - - - - - - - - - + Creates a new #GtkPrintOperation. + a new #GtkPrintOperation - + Cancels a running print operation. This function may +be called from a #GtkPrintOperation::begin-print, +#GtkPrintOperation::paginate or #GtkPrintOperation::draw-page +signal handler to stop the currently running print +operation. + + + + + + Signalize that drawing of particular page is complete. +It is called after completion of page drawing (e.g. drawing in another +thread). +If gtk_print_operation_set_defer_drawing() was called before, then this function +has to be called by application. In another case it is called by the library +itself. - - - - - - + Returns the default page setup, see +gtk_print_operation_set_default_page_setup(). + + the default page setup - + + Gets the value of #GtkPrintOperation::embed-page-setup property. + + whether page setup selection combos are embedded + + + + + Call this when the result of a print operation is +%GTK_PRINT_OPERATION_RESULT_ERROR, either as returned by +gtk_print_operation_run(), or in the #GtkPrintOperation::done signal +handler. The returned #GError will contain more details on what went wrong. - - - - - + + + Gets the value of #GtkPrintOperation::has-selection property. + + whether there is a selection + + + + + Returns the number of pages that will be printed. +Note that this value is set during print preparation phase +(%GTK_PRINT_STATUS_PREPARING), so this function should never be +called before the data generation phase (%GTK_PRINT_STATUS_GENERATING_DATA). +You can connect to the #GtkPrintOperation::status-changed signal +and call gtk_print_operation_get_n_pages_to_print() when +print status is %GTK_PRINT_STATUS_GENERATING_DATA. +This is typically used to track the progress of print operation. + + the number of pages that will be printed + + + Returns the current print settings. Note that the return value is %NULL until either gtk_print_operation_set_print_settings() or -gtk_print_operation_run() have been called." - version="2.10"> - +gtk_print_operation_run() have been called. + + the current print settings of @op. - + Returns the status of the print operation. +Also see gtk_print_operation_get_status_string(). - + the status of the print operation + - - - - - - + Returns a string representation of the status of the +print operation. The string is translated and suitable +for displaying the print status e.g. in a #GtkStatusbar. +Use gtk_print_operation_get_status() to obtain a status +value that is suitable for programmatic use. +of the print operation - + a string representation of the status + - - - - - - + + Gets the value of #GtkPrintOperation::support-selection property. - + whether the application supports print of selection + - - - - - - + A convenience function to find out if the print operation +is finished, either successfully (%GTK_PRINT_STATUS_FINISHED) +or unsuccessfully (%GTK_PRINT_STATUS_FINISHED_ABORTED). +can be in a non-finished state even after done has been called, as +the operation status then tracks the print job status on the printer. - + %TRUE, if the print operation is finished. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Runs the print operation, by first letting the user modify print settings in the print dialog, and then print the document. -Normally that this function does not return until the rendering of all -pages is complete. You can connect to the -#GtkPrintOperation::status-changed signal on @op to obtain some -information about the progress of the print operation. +Normally that this function does not return until the rendering of all +pages is complete. You can connect to the +#GtkPrintOperation::status-changed signal on @op to obtain some +information about the progress of the print operation. Furthermore, it may use a recursive mainloop to show the print dialog. -If you call gtk_print_operation_set_allow_async() or set the -#GtkPrintOperation:allow-async property the operation will run -asynchronously if this is supported on the platform. The -#GtkPrintOperation::done signal will be emitted with the result of the -operation when the it is done (i.e. when the dialog is canceled, or when +If you call gtk_print_operation_set_allow_async() or set the +#GtkPrintOperation:allow-async property the operation will run +asynchronously if this is supported on the platform. The +#GtkPrintOperation::done signal will be emitted with the result of the +operation when the it is done (i.e. when the dialog is canceled, or when the print succeeds or fails). |[ if (settings != NULL) gtk_print_operation_set_print_settings (print, settings); if (page_setup != NULL) gtk_print_operation_set_default_page_setup (print, page_setup); -g_signal_connect (print, "begin-print", +g_signal_connect (print, "begin-print", G_CALLBACK (begin_print), &data); -g_signal_connect (print, "draw-page", +g_signal_connect (print, "draw-page", G_CALLBACK (draw_page), &data); -res = gtk_print_operation_run (print, -GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG, -parent, +res = gtk_print_operation_run (print, +GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG, +parent, &error); if (res == GTK_PRINT_OPERATION_RESULT_ERROR) { @@ -41298,9 +35358,9 @@ error_dialog = gtk_message_dialog_new (GTK_WINDOW (parent), GTK_DIALOG_DESTROY_WITH_PARENT, GTK_MESSAGE_ERROR, GTK_BUTTONS_CLOSE, -"Error printing file:\n%s", +"Error printing file:\n%s", error->message); -g_signal_connect (error_dialog, "response", +g_signal_connect (error_dialog, "response", G_CALLBACK (gtk_widget_destroy), NULL); gtk_widget_show (error_dialog); g_error_free (error); @@ -41315,425 +35375,555 @@ settings = g_object_ref (gtk_print_operation_get_print_settings (print)); Note that gtk_print_operation_run() can only be called once on a given #GtkPrintOperation. %GTK_PRINT_OPERATION_RESULT_APPLY indicates that the printing was -completed successfully. In this case, it is a good idea to obtain -the used print settings with gtk_print_operation_get_print_settings() +completed successfully. In this case, it is a good idea to obtain +the used print settings with gtk_print_operation_get_print_settings() and store them for reuse with the next print operation. A value of %GTK_PRINT_OPERATION_RESULT_IN_PROGRESS means the operation is running -asynchronously, and will emit the #GtkPrintOperation::done signal when -done." - version="2.10" - throws="1"> - +asynchronously, and will emit the #GtkPrintOperation::done signal when +done. + + the result of the print operation. A return value of + the action to start - + + Transient parent of the dialog - - - - - - - - - - - - - - - - + Sets whether the gtk_print_operation_run() may return +before the print operation is completed. Note that +some platforms may not allow asynchronous operation. + + + %TRUE to allow asynchronous operation + + + - + + Sets the current page. +If this is called before gtk_print_operation_run(), +the user will be able to select to print only the current page. +Note that this only makes sense for pre-paginated documents. + + + the current page, 0-based + + + + + + Sets the label for the tab holding custom widgets. + + + + + + the label to use, or %NULL to use the default label + + + + + + Makes @default_page_setup the default page setup for @op. +This page setup will be used by gtk_print_operation_run(), +but it can be overridden on a per-page basis by connecting +to the #GtkPrintOperation::request-page-setup signal. + + + + + + a #GtkPageSetup, or %NULL + + + + Sets up the #GtkPrintOperation to wait for calling of gtk_print_operation_draw_page_finish() from application. It can be used for drawing page in another thread. -This function must be called in the callback of "draw-page" signal." - version="2.16"> +This function must be called in the callback of "draw-page" signal. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Embed page size combo box and orientation combo box into page setup page. +Selected page setup is stored as default page setup in #GtkPrintOperation. - + %TRUE to embed page setup selection in the #GtkPrintDialog + - + + Sets up the #GtkPrintOperation to generate a file instead +of showing the print dialog. The indended use of this function +is for implementing "Export to PDF" actions. Currently, PDF +is the only supported format. +"Print to PDF" support is independent of this and is done +by letting the user pick the "Print to PDF" item from the list +of printers in the print dialog. - + + + + the filename for the exported file + + + - + Sets whether there is a selection to print. +Application has to set number of pages to which the selection +will draw by gtk_print_operation_set_n_pages() in a callback of +#GtkPrintOperation::begin-print. - + + + + %TRUE indicates that a selection exists + + + + + + Sets the name of the print job. The name is used to identify +the job (e.g. in monitoring applications like eggcups). +If you don't set a job name, GTK+ picks a default one by +numbering successive print jobs. + + + + + + a string that identifies the print job + + + + + + Sets the number of pages in the document. +This <emphasis>must</emphasis> be set to a positive number +before the rendering starts. It may be set in a +#GtkPrintOperation::begin-print signal hander. +Note that the page numbers passed to the +#GtkPrintOperation::request-page-setup +and #GtkPrintOperation::draw-page signals are 0-based, i.e. if +the user chooses to print all pages, the last ::draw-page signal +will be for page @n_pages - 1. + + + + + + the number of pages + + + + + + Sets the print settings for @op. This is typically used to +re-establish print settings from a previous print operation, +see gtk_print_operation_run(). + + + + + + #GtkPrintSettings + + + + + + If @show_progress is %TRUE, the print operation will show a +progress dialog during the print operation. + + + + + + %TRUE to show a progress dialog + + + + + + Sets whether selection is supported by #GtkPrintOperation. + + + + + + %TRUE to support selection + + + + + + If track_status is %TRUE, the print operation will try to continue report +on the status of the print job in the printer queues and printer. This +can allow your application to show things like "out of paper" issues, +and when the print job actually reaches the printer. +This function is often implemented using some form of polling, so it should +not be enabled unless needed. + + + + + + %TRUE to track status after printing + + + + + + Sets up the transformation for the cairo context obtained from +#GtkPrintContext in such a way that distances are measured in +units of @unit. + + + + + + the unit to use + + + + + + If @full_page is %TRUE, the transformation for the cairo context +obtained from #GtkPrintContext puts the origin at the top left +corner of the page (which may not be the top left corner of the +sheet, depending on page orientation and the number of pages per +sheet). Otherwise, the origin is at the top left corner of the +imageable area (i.e. inside the margins). + + + + + + %TRUE to set up the #GtkPrintContext for the full page + + + + Determines whether the print operation may run asynchronously or not. +Some systems don't support asynchronous printing, but those that do will return %GTK_PRINT_OPERATION_RESULT_IN_PROGRESS as the status, and -emit the #GtkPrintOperation::done signal when the operation is actually +emit the #GtkPrintOperation::done signal when the operation is actually done. -The Windows port does not support asynchronous operation at all (this -is unlikely to change). On other platforms, all actions except for -%GTK_PRINT_OPERATION_ACTION_EXPORT support asynchronous operation."> - +The Windows port does not support asynchronous operation at all (this +is unlikely to change). On other platforms, all actions except for +%GTK_PRINT_OPERATION_ACTION_EXPORT support asynchronous operation. + + The current page in the document. +If this is set before gtk_print_operation_run(), the user will be able to select to print only the current page. -Note that this only makes sense for pre-paginated documents."> - +Note that this only makes sense for pre-paginated documents. + + Used as the label of the tab containing custom widgets. Note that this property may be ignored on some platforms. -If this is %NULL, GTK+ uses a default label."> - +If this is %NULL, GTK+ uses a default label. + + The #GtkPageSetup used by default. This page setup will be used by gtk_print_operation_run(), but it can be overridden on a per-page basis by connecting -to the #GtkPrintOperation::request-page-setup signal."> - +to the #GtkPrintOperation::request-page-setup signal. + - + transfer-ownership="none"> + If %TRUE, page size combo box and orientation combo box are embedded into page setup page. + + The name of a file to generate instead of showing the print dialog. Currently, PDF is the only supported format. -The intended use of this property is for implementing -"Export to PDF" actions. -"Print to PDF" support is independent of this and is done -by letting the user pick the "Print to PDF" item from the -list of printers in the print dialog."> - +The intended use of this property is for implementing +"Export to PDF" actions. +"Print to PDF" support is independent of this and is done +by letting the user pick the "Print to PDF" item from the +list of printers in the print dialog. + + Determines whether there is a selection in your application. This can allow your application to print the selection. -This is typically used to make a "Selection" button sensitive."> - +This is typically used to make a "Selection" button sensitive. + - + transfer-ownership="none"> + A string used to identify the job (e.g. in monitoring +applications like eggcups). +If you don't set a job name, GTK+ picks a default one +by numbering successive print jobs. + + The number of pages in the document. This <emphasis>must</emphasis> be set to a positive number -before the rendering starts. It may be set in a +before the rendering starts. It may be set in a #GtkPrintOperation::begin-print signal hander. -Note that the page numbers passed to the -#GtkPrintOperation::request-page-setup and -#GtkPrintOperation::draw-page signals are 0-based, i.e. if -the user chooses to print all pages, the last ::draw-page signal -will be for page @n_pages - 1."> - +Note that the page numbers passed to the +#GtkPrintOperation::request-page-setup and +#GtkPrintOperation::draw-page signals are 0-based, i.e. if +the user chooses to print all pages, the last ::draw-page signal +will be for page @n_pages - 1. + + The number of pages that will be printed. Note that this value is set during print preparation phase (%GTK_PRINT_STATUS_PREPARING), so this value should never be get before the data generation phase (%GTK_PRINT_STATUS_GENERATING_DATA). You can connect to the #GtkPrintOperation::status-changed signal and call gtk_print_operation_get_n_pages_to_print() when print status is %GTK_PRINT_STATUS_GENERATING_DATA. -This is typically used to track the progress of print operation."> - +This is typically used to track the progress of print operation. + - + transfer-ownership="none"> + The #GtkPrintSettings used for initializing the dialog. +Setting this property is typically used to re-establish +print settings from a previous print operation, see +gtk_print_operation_run(). + - + transfer-ownership="none"> + Determines whether to show a progress dialog during the +print operation. + - - + + The status of the print operation. + - + A string representation of the status of the print operation. +The string is translated and suitable for displaying the print status e.g. in a #GtkStatusbar. -See the #GtkPrintOperation:status property for a status value that -is suitable for programmatic use."> - +See the #GtkPrintOperation:status property for a status value that +is suitable for programmatic use. + - + transfer-ownership="none"> + If %TRUE, the print operation will support print of selection. +This allows the print dialog to show a "Selection" button. + - + transfer-ownership="none"> + If %TRUE, the print operation will try to continue report on +the status of the print job in the printer queues and printer. +This can allow your application to show things like "out of paper" +issues, and when the print job actually reaches the printer. +However, this is often implemented using polling, and should +not be enabled unless needed. + - + transfer-ownership="none"> + The transformation for the cairo context obtained from +#GtkPrintContext is set up in such a way that distances +are measured in units of @unit. + - + transfer-ownership="none"> + If %TRUE, the transformation for the cairo context obtained +from #GtkPrintContext puts the origin at the top left corner +of the page (which may not be the top left corner of the sheet, +depending on page orientation and the number of pages per sheet). +Otherwise, the origin is at the top left corner of the imageable +area (i.e. inside the margins). + - + - + Emitted after the user has finished changing print settings +in the dialog, before the actual rendering starts. A typical use for ::begin-print is to use the parameters from the #GtkPrintContext and paginate the document accordingly, and then -set the number of pages with gtk_print_operation_set_n_pages()." - version="2.10"> - - +set the number of pages with gtk_print_operation_set_n_pages(). + + - - + + the #GtkPrintContext for the current operation + + Emitted when displaying the print dialog. If you return a widget in a handler for this signal it will be added to a custom tab in the print dialog. You typically return a container widget with multiple widgets in it. -The print dialog owns the returned widget, and its lifetime is not -controlled by the application. However, the widget is guaranteed -to stay around until the #GtkPrintOperation::custom-widget-apply -signal is emitted on the operation. Then you can read out any +The print dialog owns the returned widget, and its lifetime is not +controlled by the application. However, the widget is guaranteed +to stay around until the #GtkPrintOperation::custom-widget-apply +signal is emitted on the operation. Then you can read out any information you need from the widgets. -or %NULL" - version="2.10"> - - +or %NULL + + A custom widget that gets embedded in the print dialog, + - - - + + Emitted right before #GtkPrintOperation::begin-print if you added +a custom widget in the #GtkPrintOperation::create-custom-widget handler. +When you get this signal you should read the information from the +custom widgets, as the widgets are not guaraneed to be around at a +later time. + + - - + + the custom widget added in create-custom-widget + - + Emitted when the print operation run has finished doing +everything required for printing. If @result is %GTK_PRINT_OPERATION_RESULT_ERROR then you can call gtk_print_operation_get_error() for more information. -If you enabled print status tracking then -gtk_print_operation_is_finished() may still return %FALSE -after #GtkPrintOperation::done was emitted." - version="2.10"> - - +If you enabled print status tracking then +gtk_print_operation_is_finished() may still return %FALSE +after #GtkPrintOperation::done was emitted. + + - - + + the result of the print operation + - + Emitted for every page that is printed. The signal handler +must render the @page_nr's page onto the cairo context obtained from @context using gtk_print_context_get_cairo_context(). |[ static void @@ -41753,10 +35943,10 @@ cairo_rectangle (cr, 0, 0, width, HEADER_HEIGHT); cairo_set_source_rgb (cr, 0.8, 0.8, 0.8); cairo_fill (cr); layout = gtk_print_context_create_pango_layout (context); -desc = pango_font_description_from_string ("sans 14"); +desc = pango_font_description_from_string ("sans 14"); pango_layout_set_font_description (layout, desc); pango_font_description_free (desc); -pango_layout_set_text (layout, "some text", -1); +pango_layout_set_text (layout, "some text", -1); pango_layout_set_width (layout, width * PANGO_SCALE); pango_layout_set_alignment (layout, PANGO_ALIGN_CENTER); pango_layout_get_size (layout, NULL, &layout_height); @@ -41766,140 +35956,144 @@ pango_cairo_show_layout (cr, layout); g_object_unref (layout); } ]| -Use gtk_print_operation_set_use_full_page() and +Use gtk_print_operation_set_use_full_page() and gtk_print_operation_set_unit() before starting the print operation to set up the transformation of the cairo context according to your -needs." - version="2.10"> - - +needs. + + - - + + the #GtkPrintContext for the current operation + - - + + the number of the currently printed page (0-based) + - + Emitted after all pages have been rendered. A handler for this signal can clean up any resources that have -been allocated in the #GtkPrintOperation::begin-print handler." - version="2.10"> - - +been allocated in the #GtkPrintOperation::begin-print handler. + + - - + + the #GtkPrintContext for the current operation + - + Emitted after the #GtkPrintOperation::begin-print signal, but before +the actual rendering starts. It keeps getting emitted until a connected signal handler returns %TRUE. The ::paginate signal is intended to be used for paginating a document in small chunks, to avoid blocking the user interface for a long time. The signal handler should update the number of pages using gtk_print_operation_set_n_pages(), and return %TRUE if the document has been completely paginated. -If you don't need to do pagination in chunks, you can simply do +If you don't need to do pagination in chunks, you can simply do it all in the ::begin-print handler, and set the number of pages -from there." - version="2.10"> - - +from there. + + %TRUE if pagination is complete + - - + + the #GtkPrintContext for the current operation + - + Gets emitted when a preview is requested from the native dialog. +The default handler for this signal uses an external viewer application to preview. To implement a custom print preview, an application must return %TRUE from its handler for this signal. In order to use the provided @context for the preview implementation, it must be given a suitable cairo context with gtk_print_context_set_cairo_context(). -The custom preview implementation can use -gtk_print_operation_preview_is_selected() and +The custom preview implementation can use +gtk_print_operation_preview_is_selected() and gtk_print_operation_preview_render_page() to find pages which are selected for print and render them. The preview must be finished by calling gtk_print_operation_preview_end_preview() -(typically in response to the user clicking a close button)." - version="2.10"> - - +(typically in response to the user clicking a close button). + + %TRUE if the listener wants to take over control of the preview + - - + + the #GtkPrintPreviewOperation for the current operation + - - + + the #GtkPrintContext that will be used + - - + + the #GtkWindow to use as window parent, or %NULL + - - - + + Emitted once for every page that is printed, to give +the application a chance to modify the page setup. Any changes +done to @setup will be in force only for printing this page. + + - - + + the #GtkPrintContext for the current operation + - - + + the number of the currently printed page (0-based) + - - + + the #GtkPageSetup + - + Emitted at between the various phases of the print operation. See #GtkPrintStatus for the phases that are being discriminated. Use gtk_print_operation_get_status() to find out the current -status." - version="2.10"> - - +status. + + - + Emitted after change of selected printer. The actual page setup and print settings are passed to the custom widget, which can actualize -itself according to this change." - version="2.18"> - - +itself according to this change. + + - - + + the custom widget added in create-custom-widget + - - + + actual page setup + - - + + actual print settings + @@ -41932,7 +36126,7 @@ itself according to this change." - + @@ -41948,7 +36142,7 @@ itself according to this change." - + @@ -41963,9 +36157,9 @@ itself according to this change." - + - + @@ -41978,7 +36172,7 @@ itself according to this change." - + @@ -41990,7 +36184,7 @@ itself according to this change." - + @@ -41999,7 +36193,7 @@ itself according to this change." - + @@ -42011,13 +36205,13 @@ itself according to this change." - + - + @@ -42032,7 +36226,7 @@ itself according to this change." - + @@ -42043,9 +36237,9 @@ itself according to this change." - - - + + + @@ -42056,7 +36250,7 @@ itself according to this change." - + @@ -42071,9 +36265,9 @@ itself according to this change." - + - + @@ -42093,7 +36287,7 @@ itself according to this change." - + @@ -42113,43 +36307,43 @@ itself according to this change." - - + + - - + + - - + + - - + + - - + + - - + + @@ -42157,105 +36351,126 @@ itself according to this change." - - - - - - - - - - - - - - - - - - - - - + + Ends a preview. +This function must be called to finish a custom print preview. - + Returns whether the given page is included in the set of pages that +have been selected for printing. + + %TRUE if the page has been selected for printing + + + + + a page number + + + + + + Renders a page to the preview, using the print context that was passed to the #GtkPrintOperation::preview handler together with @preview. A custom iprint preview should use this function in its ::expose handler to render the currently selected page. -Note that this function requires a suitable cairo context to -be associated with the print context." - version="2.10"> +Note that this function requires a suitable cairo context to +be associated with the print context. - + the page to render + - + + Ends a preview. +This function must be called to finish a custom print preview. + Returns whether the given page is included in the set of pages that +have been selected for printing. - + %TRUE if the page has been selected for printing + - + a page number + - - + + Renders a page to the preview, using the print context that +was passed to the #GtkPrintOperation::preview handler together +with @preview. +A custom iprint preview should use this function in its ::expose +handler to render the currently selected page. +Note that this function requires a suitable cairo context to +be associated with the print context. + - - + + the page to render + - - + + + + The ::got-page-size signal is emitted once for each page +that gets rendered to the preview. +A handler for this signal should update the @context +according to @page_setup and set up a suitable cairo +context, using gtk_print_context_set_cairo_context(). + + + + + + the current #GtkPrintContext + + + + the #GtkPageSetup for the current page + - + The ::ready signal gets emitted once per preview operation, before the first page is rendered. -A handler for this signal can be used for setup tasks."> - - +A handler for this signal can be used for setup tasks. + + - - + + the current #GtkPrintContext + @@ -42267,7 +36482,7 @@ A handler for this signal can be used for setup tasks."> - + @@ -42283,7 +36498,7 @@ A handler for this signal can be used for setup tasks."> - + @@ -42302,7 +36517,7 @@ A handler for this signal can be used for setup tasks."> - + @@ -42312,15 +36527,17 @@ A handler for this signal can be used for setup tasks."> c:type="GtkPrintOperationPreview*"/> - + the page to render + - + - + %TRUE if the page has been selected for printing + @@ -42328,13 +36545,14 @@ A handler for this signal can be used for setup tasks."> c:type="GtkPrintOperationPreview*"/> - + a page number + - + @@ -42346,57 +36564,59 @@ A handler for this signal can be used for setup tasks."> - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + glib:nick="draft"/> + Creates a new #GtkPrintSettings object. + a new #GtkPrintSettings object + Reads the print settings from @file_name. Returns a new #GtkPrintSettings +object with the restored settings, or %NULL if an error occurred. If the +file could not be loaded then error is set to either a #GFileError or +#GKeyFileError. See gtk_print_settings_to_file(). + the restored #GtkPrintSettings + the filename to read the settings from + Reads the print settings from the group @group_name in @key_file. Returns a +new #GtkPrintSettings object with the restored settings, or %NULL if an +error occurred. If the file could not be loaded then error is set to either +a #GFileError or #GKeyFileError. + the restored #GtkPrintSettings + the #GKeyFile to retrieve the settings from + allow-none="1"> + the name of the group to use, or %NULL to use the default "Print Settings" + Copies a #GtkPrintSettings object. + a newly allocated copy of @other - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Calls @func for each key-value pair of @settings. @@ -42665,752 +36760,971 @@ This has the same effect as setting the value to %NULL." + closure="1"> + the function to call - + user data for @func + + + + + + Looks up the string value associated with @key. + + the string value for @key + + + + + a key + + Returns the boolean represented by the value +that is associated with @key. +The string "true" represents %TRUE, any other +string %FALSE. - + %TRUE, if @key maps to a true value. + + a key - + Gets the value of %GTK_PRINT_SETTINGS_COLLATE. - + whether to collate the printed pages + + + + + Gets the value of %GTK_PRINT_SETTINGS_DEFAULT_SOURCE. + + the default source + + + + + Gets the value of %GTK_PRINT_SETTINGS_DITHER. + + the dithering that is used + - - - - - - - - + Returns the double value associated with @key, or 0. - + the double value of @key + + a key + Returns the floating point number represented by the value that is associated with @key, or @default_val if the value does not represent a floating point number. -Floating point numbers are parsed with g_ascii_strtod()." - version="2.10"> +Floating point numbers are parsed with g_ascii_strtod(). - + the floating point number associated with @key + + a key - + the default value + - + Gets the value of %GTK_PRINT_SETTINGS_DUPLEX. - + whether to print the output in duplex. + - - - - - - - - - + Gets the value of %GTK_PRINT_SETTINGS_FINISHINGS. - + the finishings + - - - - - - - - - - - - - - - - - - - - - - - - + Returns the integer value of @key, or 0. - + the integer value of @key + + a key + Returns the value of @key, interpreted as +an integer, or the default value. - + the integer value of @key + + a key - + the default value + - + Returns the value associated with @key, interpreted +as a length. The returned value is converted to @units. - + the length value of @key, converted to @unit + + a key - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the unit of the return value - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE. +The set of media types is defined in PWG 5101.1-2002 PWG. +<!-- FIXME link here --> + the media type - + Gets the value of %GTK_PRINT_SETTINGS_N_COPIES. - + the number of copies to print + + + + + Gets the value of %GTK_PRINT_SETTINGS_NUMBER_UP. + + the number of pages per sheet + + + + + Gets the value of %GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT. + + layout of page in number-up mode + + + + + Get the value of %GTK_PRINT_SETTINGS_ORIENTATION, +converted to a #GtkPageOrientation. + + the orientation + + + + + Gets the value of %GTK_PRINT_SETTINGS_OUTPUT_BIN. + + the output bin + + + + + Gets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES. +Use g_free() to free the array when it is no longer needed. + + an array of #GtkPageRange<!-- -->s. + - + + return location for the length of the returned array + + + + + + Gets the value of %GTK_PRINT_SETTINGS_PAGE_SET. + + the set of pages to print + + + + + Gets the value of %GTK_PRINT_SETTINGS_PAPER_HEIGHT, +converted to @unit. + + the paper height, in units of @unit + + + + + the unit for the return value + + + + + + Gets the value of %GTK_PRINT_SETTINGS_PAPER_FORMAT, +converted to a #GtkPaperSize. + + the paper size + + + + + Gets the value of %GTK_PRINT_SETTINGS_PAPER_WIDTH, +converted to @unit. + + the paper width, in units of @unit + + + + + the unit for the return value + + + + + + Gets the value of %GTK_PRINT_SETTINGS_PRINT_PAGES. + + which pages to print + + + + + Convenience function to obtain the value of +%GTK_PRINT_SETTINGS_PRINTER. + + the printer name + + + + + Gets the value of %GTK_PRINT_SETTINGS_PRINTER_LPI. + + the resolution in lpi (lines per inch) + + + + + Gets the value of %GTK_PRINT_SETTINGS_QUALITY. + + the print quality + + + + + Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION. + + the resolution in dpi + + + + + Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION_X. + + the horizontal resolution in dpi + + + + + Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION_Y. + + the vertical resolution in dpi + + + + + Gets the value of %GTK_PRINT_SETTINGS_REVERSE. + + whether to reverse the order of the printed pages + + + + + Gets the value of %GTK_PRINT_SETTINGS_SCALE. + + the scale in percent + + + + + Gets the value of %GTK_PRINT_SETTINGS_USE_COLOR. + + whether to use color + + + + + Returns %TRUE, if a value is associated with @key. + + %TRUE, if @key has a value + + + + + a key - + + Reads the print settings from @file_name. If the file could not be loaded +then error is set to either a #GFileError or #GKeyFileError. +See gtk_print_settings_to_file(). - + %TRUE on success + + + + the filename to read the settings from + + + + + + Reads the print settings from the group @group_name in @key_file. If the +file could not be loaded then error is set to either a #GFileError or +#GKeyFileError. + + %TRUE on success + + + + + the #GKeyFile to retrieve the settings from + + + + the name of the group to use, or %NULL to use the default "Print Settings" + + + + + + Associates @value with @key. + + + + + + a key + + + + a string value, or %NULL + + + + + + Sets @key to a boolean value. + + + + + + a key + + + + a boolean + + + + + + Sets the value of %GTK_PRINT_SETTINGS_COLLATE. + + + + + + whether to collate the output + + + + + + Sets the value of %GTK_PRINT_SETTINGS_DEFAULT_SOURCE. + + + + + + the default source + + + + Sets the value of %GTK_PRINT_SETTINGS_DITHER. + the dithering that is used - + Sets @key to a double value. - + + + + a key + + + + a double value + + + + + + Sets the value of %GTK_PRINT_SETTINGS_DUPLEX. + + + + + + a #GtkPrintDuplex value + + + + Sets the value of %GTK_PRINT_SETTINGS_FINISHINGS. + the finishings - + Sets @key to an integer value. - + + + + a key + + + + an integer + + + + + + Associates a length in units of @unit with @key. + + + + + + a key + + + + a length + + + + the unit of @length + + + + + + Sets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE. +The set of media types is defined in PWG 5101.1-2002 PWG. +<!-- FIXME link here --> + + + + + + the media type + + + + + + Sets the value of %GTK_PRINT_SETTINGS_N_COPIES. + + + + + + the number of copies + + + + + + Sets the value of %GTK_PRINT_SETTINGS_NUMBER_UP. + + + + + + the number of pages per sheet + + + + + + Sets the value of %GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT. + + + + + + a #GtkNumberUpLayout value + + + + + + Sets the value of %GTK_PRINT_SETTINGS_ORIENTATION. + + + + + + a page orientation + + + + Sets the value of %GTK_PRINT_SETTINGS_OUTPUT_BIN. + the output bin + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES. + + + + + + an array of #GtkPageRange<!-- -->s + + + + the length of @page_ranges + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PAGE_SET. + + + + + + a #GtkPageSet value + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PAPER_HEIGHT. + + + + + + the paper height + + + + the units of @height + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PAPER_FORMAT, +%GTK_PRINT_SETTINGS_PAPER_WIDTH and +%GTK_PRINT_SETTINGS_PAPER_HEIGHT. + + + + + + a paper size + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PAPER_WIDTH. + + + + + + the paper width + + + + the units of @width + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PRINT_PAGES. + + + + + + a #GtkPrintPages value + + + + + + Convenience function to set %GTK_PRINT_SETTINGS_PRINTER +to @printer. + + + + + + the printer name + + + + + + Sets the value of %GTK_PRINT_SETTINGS_PRINTER_LPI. + + + + + + the resolution in lpi (lines per inch) + + + + + + Sets the value of %GTK_PRINT_SETTINGS_QUALITY. + + + + + + a #GtkPrintQuality value + + + + + + Sets the values of %GTK_PRINT_SETTINGS_RESOLUTION, +%GTK_PRINT_SETTINGS_RESOLUTION_X and +%GTK_PRINT_SETTINGS_RESOLUTION_Y. + + + + + + the resolution in dpi + + + + + + Sets the values of %GTK_PRINT_SETTINGS_RESOLUTION, +%GTK_PRINT_SETTINGS_RESOLUTION_X and +%GTK_PRINT_SETTINGS_RESOLUTION_Y. + + + + + + the horizontal resolution in dpi + + + + the vertical resolution in dpi + + + + + + Sets the value of %GTK_PRINT_SETTINGS_REVERSE. + + + + + + whether to reverse the output + + + + + + Sets the value of %GTK_PRINT_SETTINGS_SCALE. + + + + + + the scale in percent + + + + + + Sets the value of %GTK_PRINT_SETTINGS_USE_COLOR. + + + + + + whether to use color + + + + + + This function saves the print settings from @settings to @file_name. If the +file could not be loaded then error is set to either a #GFileError or +#GKeyFileError. + + %TRUE on success + + + + + the file to save to + + + + + + This function adds the print settings from @settings to @key_file. + + + + + + the #GKeyFile to save the print settings to + + + + the group to add the settings to in @key_file, or %NULL to use the default "Print Settings" + + + + + + Removes any value associated with @key. +This has the same effect as setting the value to %NULL. + + + + + + a key @@ -43428,7 +37742,7 @@ The set of media types is defined in PWG 5101.1-2002 PWG. - + @@ -43525,628 +37839,282 @@ The set of media types is defined in PWG 5101.1-2002 PWG. value="4096" c:identifier="PRIVATE_GTK_ALLOC_NEEDED" glib:nick="alloc-needed"/> - + c:identifier="PRIVATE_GTK_WIDTH_REQUEST_NEEDED" + glib:nick="width-request-needed"/> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - - - - - - - - - - + + Returns the ellipsizing position of the progressbar. +See gtk_progress_bar_set_ellipsize(). - + #PangoEllipsizeMode + - + + Returns the current fraction of the task that's been completed. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a fraction from 0.0 to 1.0 + - + + Gets the value set by gtk_progress_bar_set_inverted() - + %TRUE if the progress bar is inverted + + c:identifier="gtk_progress_bar_get_pulse_step"> + Retrieves the pulse step set with gtk_progress_bar_set_pulse_step() - + a fraction from 0.0 to 1.0 + - - - + + Gets the value of the #GtkProgressBar::show-text property. +See gtk_progress_bar_set_show_text(). + + %TRUE if text is shown in the progress bar + + + + + Retrieves the text displayed superimposed on the progress bar, +if any, otherwise %NULL. The return value is a reference +to the text, not a copy of it, so will become invalid +if you change the text in the progress bar. +and should not be modified or freed. + + text, or %NULL; this string is owned by the widget + + + + + Indicates that some progress is made, but you don't know how much. +Causes the progress bar to enter "activity mode," where a block +bounces back and forth. Each call to gtk_progress_bar_pulse() +causes the block to move by a little bit (the amount of movement +per pulse is determined by gtk_progress_bar_set_pulse_step()). + + + if there is not enough space to render the entire string. + a #PangoEllipsizeMode - - - - - - + + Causes the progress bar to "fill in" the given fraction +of the bar. The fraction should be between 0.0 and 1.0, +inclusive. - - + + fraction of the task that's been completed + - + + Progress bars normally grow from top to bottom or left to right. +Inverted progress bars grow in the opposite direction. - - + + %TRUE to invert the progress bar + - + + Sets the fraction of total progress bar length to move the +bouncing block for each call to gtk_progress_bar_pulse(). - - + + fraction between 0.0 and 1.0 + - + + Sets whether the progressbar will show text superimposed +over the bar. The shown text is either the value of +the #GtkProgressBar::text property or, if that is %NULL, +the #GtkProgressBar::fraction value, as a percentage. - - + + whether to show superimposed text + - + + Causes the given @text to appear superimposed on the progress bar. - - + + a UTF-8 string, or %NULL + - - - - - - - - - - - - - - - + The preferred place to ellipsize the string, if the progressbar does not have enough room to display the entire string, specified as a #PangoEllisizeMode. Note that setting this property to a value other than %PANGO_ELLIPSIZE_NONE has the side-effect that the progressbar requests -only enough space to display the ellipsis "...". Another means to set a -progressbar's width is gtk_widget_set_size_request()."> - +only enough space to display the ellipsis "...". Another means to set a +progressbar's width is gtk_widget_set_size_request(). + - - + + - - + + - - + + - - + + - - + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Creates a new #GtkRadioAction object. To add the action to +a #GtkActionGroup and set the accelerator for the action, +call gtk_action_group_add_action_with_accel(). + a new #GtkRadioAction + A unique name for the action - + + The label displayed in menu items and on buttons, or %NULL - + + A tooltip for this action, or %NULL + The stock icon to display in widgets representing this action, or %NULL - - + + The value which gtk_radio_action_get_current_value() should return if this action is selected. + + + Obtains the value property of the currently active member of +the group to which @action belongs. + + The value of the currently active group member + + + + Returns the list representing the radio group for this object. Note that the returned list is only valid until the next change -to the group. +to the group. A common way to set up a group of radio group is the following: |[ GSList *group = NULL; @@ -44203,74 +38180,100 @@ action = gtk_radio_action_new (...); gtk_radio_action_set_group (action, group); group = gtk_radio_action_get_group (action); } -]|" - version="2.4"> - +]| + + the list representing the radio group for this object - + - + + Joins a radio action object to the group of another radio action object. +Use this in language bindings instead of the gtk_radio_action_get_group() +and gtk_radio_action_set_group() methods +A common way to set up a group of radio actions is the following: +|[ +GtkRadioAction *action; +GtkRadioAction *last_action; +while (/&ast; more actions to add &ast;/) +{ +action = gtk_radio_action_new (...); +gtk_radio_action_join_group (action, last_action); +last_action = action; +} +]| - - + + a radio action object whos group we are joining, or %NULL to remove the radio action from its group + - - - - - + Sets the currently active group member to the member with value +property @current_value. - + the new value + + + + + + Sets the radio group for the radio action object. + + + + + + a list representing a radio group + + + - + transfer-ownership="none"> + The value property of the currently active member of the group to which +this action belongs. + - + transfer-ownership="none"> + Sets a new group for a radio action. + + The value is an arbitrary integer which can be used as a +convenient way to determine which action in the group is currently active in an ::activate or ::changed signal handler. See gtk_radio_action_get_current_value() and #GtkRadioActionEntry -for convenient ways to get and set this property."> - +for convenient ways to get and set this property. + @@ -44278,17 +38281,17 @@ for convenient ways to get and set this property."> - + The ::changed signal is emitted on every member of a radio group when the active member is changed. The signal gets emitted after the ::activate signals -for the previous and current active members." - version="2.4"> - - +for the previous and current active members. + + - - + + the member of @action<!-- -->s group which has just been activated + @@ -44300,7 +38303,7 @@ for the previous and current active members." - + @@ -44314,29 +38317,29 @@ for the previous and current active members." - - + + - - + + - - + + - - + + @@ -44344,6 +38347,8 @@ for the previous and current active members." + #GtkRadioActionEntry structs are used with +gtk_action_group_add_radio_actions() to construct groups of radio actions. @@ -44360,150 +38365,203 @@ for the previous and current active members." - + - + - + + - - + Creates a new #GtkRadioButton. To be of any practical value, a widget should +then be packed into the radio button. + + a new radio button + - - - - - - - - - - - + an existing radio button group, or %NULL if you are creating a new group. + + + + Creates a new #GtkRadioButton with a text label. - + a new radio button. + - - - - - - - - - - - - - - + an existing radio button group, or %NULL if you are creating a new group. + + + + the text label to display next to the radio button. + Creates a new #GtkRadioButton containing a label, adding it to the same group as @group. The label will be created using gtk_label_new_with_mnemonic(), so underscores in @label indicate the -mnemonic for the button."> +mnemonic for the button. - + a new #GtkRadioButton + - + the radio button group + + + + the text of the button, with an underscore in front of the mnemonic character - - - - - - - - - - - - - - + Retrieves the group assigned to a radio button. containing all the radio buttons in the same group as @radio_button. The returned list is owned by the radio button -and must not be modified or freed."> - +and must not be modified or freed. + + a linked list + + Joins a #GtkRadioButton object to the group of another #GtkRadioButton object +Use this in language bindings instead of the gtk_radio_button_get_group() +and gtk_radio_button_set_group() methods +A common way to set up a group of radio buttons is the following: +|[ +GtkRadioButton *radio_button; +GtkRadioButton *last_button; +while (/&ast; more buttons to add &ast;/) +{ +radio_button = gtk_radio_button_new (...); +gtk_radio_button_join_group (radio_button, last_button); +last_button = radio_button; +} +]| + + + + + + a radio button object whos group we are joining, or %NULL to remove the radio button from its group + + + + + + Creates a new #GtkRadioButton, adding it to the same group as +should be packed into the radio button. + + a new radio button. + + + + + Creates a new #GtkRadioButton with a text label, adding it to +the same group as @radio_group_member. + + a new radio button. + + + + + a text string to display next to the radio button. + + + + + + Creates a new #GtkRadioButton containing a label. The label +will be created using gtk_label_new_with_mnemonic(), so underscores +in @label indicate the mnemonic for the button. + + a new #GtkRadioButton + + + + + the text of the button, with an underscore in front of the mnemonic character + + + + + Sets a #GtkRadioButton's group. It should be noted that this does not change +the layout of your interface in any way, so if you are changing the group, +it is likely you will need to re-arrange the user interface to reflect these +changes. - + an existing radio button group, such as one returned from gtk_radio_button_get_group(). + + + - - + + Sets a new group for a radio button. + - - + + - + Emitted when the group of radio buttons that a radio button belongs to changes. This is emitted when a radio button switches from being alone to being part of a group of 2 or more buttons, or vice-versa, and when a button is moved from one group of 2 or more buttons to a different one, but not when the composition -of the group that a button belongs to changes." - version="2.4"> - - +of the group that a button belongs to changes. + + @@ -44514,7 +38572,7 @@ of the group that a button belongs to changes." - + @@ -44525,52 +38583,61 @@ of the group that a button belongs to changes." - - + + - - + + - - + + + + - + + - - + + - + + + - - + c:identifier="gtk_radio_menu_item_new_with_label"> + Creates a new #GtkRadioMenuItem whose child is a simple #GtkLabel. + + A new #GtkRadioMenuItem + @@ -44579,90 +38646,95 @@ of the group that a button belongs to changes." + the text for the label + Creates a new #GtkRadioMenuItem containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores -in @label indicate the mnemonic for the menu item."> - - +in @label indicate the mnemonic for the menu item. + + a new #GtkRadioMenuItem + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + group the radio menu item is inside + + + + the text of the button, with an underscore in front of the mnemonic character - - + Returns the group to which the radio menu item belongs, as a #GList of +#GtkRadioMenuItem. The list belongs to GTK+ and should not be freed. + + the group of @radio_menu_item + + + + + Creates a new #GtkRadioMenuItem adding it to the same group as @group. + + The new #GtkRadioMenuItem + + + + + Creates a new GtkRadioMenuItem whose child is a simple GtkLabel. +The new #GtkRadioMenuItem is added to the same group as @group. + + The new #GtkRadioMenuItem + + + + + the text for the label + + + + + + Creates a new GtkRadioMenuItem containing a label. The label will be +created using gtk_label_new_with_mnemonic(), so underscores in label +indicate the mnemonic for the menu item. +The new #GtkRadioMenuItem is added to the same group as @group. + + The new #GtkRadioMenuItem + + + + + the text of the button, with an underscore in front of the mnemonic character + + + + - + + + @@ -44670,18 +38742,19 @@ The new #GtkRadioMenuItem is added to the same group as @group." version="2.8" readable="0" writable="1" - doc="The radio menu item whose group this widget belongs to."> - + transfer-ownership="none"> + The radio menu item whose group this widget belongs to. + - - + + - - + + @@ -44692,7 +38765,7 @@ The new #GtkRadioMenuItem is added to the same group as @group." - + @@ -44703,123 +38776,133 @@ The new #GtkRadioMenuItem is added to the same group as @group." - - + + - - + + - - + + + + - + + - - + Creates a new #GtkRadioToolButton, adding it to @group. + + The new #GtkRadioToolButton + - - + + An existing radio button group, or %NULL if you are creating a new group + + + - - + Creates a new #GtkRadioToolButton, adding it to @group. +The new #GtkRadioToolButton will contain an icon and label from the +stock item indicated by @stock_id. + + The new #GtkRadioToolItem + - - - - - - - - - - - - - - - - - - - - - - - - - + + an existing radio button group, or %NULL if you are creating a new group + + + + the name of a stock item - - + Returns the radio button group @button belongs to. + + The group @button belongs to. + + + + + Creates a new #GtkRadioToolButton adding it to the same group as @gruup + + The new #GtkRadioToolButton + + + + + Creates a new #GtkRadioToolButton adding it to the same group as @group. +The new #GtkRadioToolButton will contain an icon and label from the +stock item indicated by @stock_id. + + A new #GtkRadioToolButton + + + + + the name of a stock item + + + + + Adds @button to @group, removing it from the group it belonged to before. - + an existing radio button group + + + @@ -44827,8 +38910,9 @@ stock item indicated by @stock_id." version="2.4" readable="0" writable="1" - doc="Sets a new group for a radio tool button."> - + transfer-ownership="none"> + Sets a new group for a radio tool button. + @@ -44840,29 +38924,29 @@ stock item indicated by @stock_id." - - + + - - + + - - + + - - + + @@ -44870,6 +38954,7 @@ stock item indicated by @stock_id." + @@ -44889,502 +38975,464 @@ stock item indicated by @stock_id." + + Get the #GtkAdjustment which is the "model" object for #GtkRange. +See gtk_range_set_adjustment() for details. +The return value does not have a reference added, so should not +be unreferenced. + + a #GtkAdjustment + + + + + Gets the current position of the fill level indicator. + + The current fill level + + + + + Gets the value set by gtk_range_set_flippable(). + + %TRUE if the range is flippable + + + + + Gets the value set by gtk_range_set_inverted(). + + %TRUE if the range is inverted + + + + + Gets the sensitivity policy for the stepper that points to the +'lower' end of the GtkRange's adjustment. + + The lower stepper's sensitivity policy. + + + + + This function is useful mainly for #GtkRange subclasses. +See gtk_range_set_min_slider_size(). + + The minimum size of the range's slider. + + + + + This function returns the area that contains the range's trough +and its steppers, in widget->window coordinates. +This function is useful mainly for #GtkRange subclasses. + + + + + + return location for the range rectangle + + + + + + Gets whether the range is restricted to the fill level. + + %TRUE if @range is restricted to the fill level. + + + + + Gets whether the range displays the fill level graphically. + + %TRUE if @range shows the fill level. + + + + + This function returns sliders range along the long dimension, +in widget->window coordinates. +This function is useful mainly for #GtkRange subclasses. + + + + + + return location for the slider's start, or %NULL + + + + return location for the slider's end, or %NULL + + + + + + This function is useful mainly for #GtkRange subclasses. +See gtk_range_set_slider_size_fixed(). + + whether the range's slider has a fixed size. + + + + + Gets the update policy of @range. See gtk_range_set_update_policy(). + + the current update policy + + + + + Gets the sensitivity policy for the stepper that points to the +'upper' end of the GtkRange's adjustment. + + The upper stepper's sensitivity policy. + + + + + Gets the current value of the range. + + current value of the range. + + + + + Sets the adjustment to be used as the "model" object for this range +widget. The adjustment indicates the current range value, the +minimum and maximum range values, the step/page increments used +for keybindings and scrolling, and the page size. The page size +is normally 0 for #GtkScale and nonzero for #GtkScrollbar, and +indicates the size of the visible area of the widget being scrolled. +The page size affects the size of the scrollbar slider. + + + + + + a #GtkAdjustment + + + + + + Set the new position of the fill level indicator. +The "fill level" is probably best described by its most prominent +use case, which is an indicator for the amount of pre-buffering in +a streaming media player. In that use case, the value of the range +would indicate the current play position, and the fill level would +be the position up to which the file/stream has been downloaded. +This amount of prebuffering can be displayed on the range's trough +and is themeable separately from the trough. To enable fill level +display, use gtk_range_set_show_fill_level(). The range defaults +to not showing the fill level. +Additionally, it's possible to restrict the range's slider position +to values which are smaller than the fill level. This is controller +by gtk_range_set_restrict_to_fill_level() and is by default +enabled. + + + + + + the new position of the fill level indicator + + + + + + If a range is flippable, it will switch its direction if it is +horizontal and its direction is %GTK_TEXT_DIR_RTL. +See gtk_widget_get_direction(). + + + + + + %TRUE to make the range flippable + + + + + + Sets the step and page sizes for the range. +The step size is used when the user clicks the #GtkScrollbar +arrows or moves #GtkScale via arrow keys. The page size +is used for example when moving via Page Up or Page Down keys. + + + + + + step size + + + + page size + + + + + + Ranges normally move from lower to higher values as the +slider moves from top to bottom or left to right. Inverted +ranges have higher values at the top or on the right rather than +on the bottom or left. + + + + + + %TRUE to invert the range + + + + + + Sets the sensitivity policy for the stepper that points to the +'lower' end of the GtkRange's adjustment. + + + + + + the lower stepper's sensitivity policy. + + + + + + Sets the minimum size of the range's slider. +This function is useful mainly for #GtkRange subclasses. + + + + + + The slider's minimum size + + + + + + Sets the allowable values in the #GtkRange, and clamps the range +value to be between @min and @max. (If the range has a non-zero +page size, it is clamped between @min and @max - page-size.) + + + + + + minimum range value + + + + maximum range value + + + + + + Sets whether the slider is restricted to the fill level. See +gtk_range_set_fill_level() for a general description of the fill +level concept. + + + + + + Whether the fill level restricts slider movement. + + + + + + Sets whether a graphical fill level is show on the trough. See +gtk_range_set_fill_level() for a general description of the fill +level concept. + + + + + + Whether a fill level indicator graphics is shown. + + + + + + Sets whether the range's slider has a fixed size, or a size that +depends on it's adjustment's page size. +This function is useful mainly for #GtkRange subclasses. + + + + + + %TRUE to make the slider size constant + + + + + Sets the update policy for the range. #GTK_UPDATE_CONTINUOUS means that anytime the range slider is moved, the range value will change and the value_changed signal will be emitted. #GTK_UPDATE_DELAYED means that the value will be updated after a brief timeout where no slider motion occurs, so updates are spaced by a short time rather than continuous. #GTK_UPDATE_DISCONTINUOUS means that the value will only be updated when the user releases the button and ends the slider -drag operation."> +drag operation. + update policy - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the sensitivity policy for the stepper that points to the +'upper' end of the GtkRange's adjustment. + the upper stepper's sensitivity policy. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the current value of the range; if the value is outside the minimum or maximum range values, it will be clamped to fit inside -them. The range emits the #GtkRange::value-changed signal if the -value changes."> +them. The range emits the #GtkRange::value-changed signal if the +value changes. - + new value of the range + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + transfer-ownership="none"> + The fill level (e.g. prebuffering of a network stream). +See gtk_range_set_fill_level(). + - - + + - - + + + The restrict-to-fill-level property controls whether slider movement is restricted to an upper boundary set by the -fill level. See gtk_range_set_restrict_to_fill_level()."> - +fill level. See gtk_range_set_restrict_to_fill_level(). + + The show-fill-level property controls whether fill level indicator graphics are displayed on the trough. See -gtk_range_set_show_fill_level()."> - +gtk_range_set_show_fill_level(). + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + Emitted before clamping a value, to give the application a +chance to adjust the bounds. + + - + the value before we clamp + - + The ::change-value signal is emitted when a scroll action is performed on a range. It allows an application to determine the type of scroll event that occurred and the resultant new value. The application can handle the event itself and return %TRUE to @@ -45393,38 +39441,41 @@ the event to other handlers until the default GTK+ handler is reached. The value parameter is unrounded. An application that overrides the ::change-value signal is responsible for clamping the value to -the desired number of decimal digits; the default GTK+ handler +the desired number of decimal digits; the default GTK+ handler clamps the value based on @range->round_digits. It is not possible to use delayed update policies in an overridden -::change-value handler." - version="2.6"> - - +::change-value handler. + + %TRUE to prevent other handlers from being invoked for the signal, %FALSE to propagate the signal further + - - + + the type of scroll action that was performed + - - + + the new value resulting from the scroll action + - - - + + Virtual function that moves the slider. Used for keybindings. + + - - + + how to move the slider + - - - + + Emitted when the range value changes. + + @@ -45441,7 +39492,7 @@ It is not possible to use delayed update policies in an overridden - + @@ -45453,7 +39504,7 @@ It is not possible to use delayed update policies in an overridden - + @@ -45462,13 +39513,13 @@ It is not possible to use delayed update policies in an overridden - + - + @@ -45483,7 +39534,7 @@ It is not possible to use delayed update policies in an overridden - + @@ -45498,9 +39549,9 @@ It is not possible to use delayed update policies in an overridden - + - + @@ -45510,38 +39561,36 @@ It is not possible to use delayed update policies in an overridden - + - - + + - - + + - - + + - + - - - + - + @@ -45589,6 +39638,7 @@ It is not possible to use delayed update policies in an overridden - - + + - - - + + + - - - - - - - - @@ -45627,30 +39669,28 @@ It is not possible to use delayed update policies in an overridden - - - + + + + + + + + + + + - + Makes a copy of the specified #GtkRcStyle. This function will correctly copy an RC style that is a member of a class -derived from #GtkRcStyle."> +derived from #GtkRcStyle. + the resulting #GtkRcStyle - - - - - - - - - - @@ -45658,8 +39698,8 @@ derived from #GtkRcStyle."> - - + + @@ -45667,46 +39707,52 @@ derived from #GtkRcStyle."> - + - + - + - + - + - + - + - + + + - + + + - + + + - + - - - + + + @@ -45728,9 +39774,9 @@ derived from #GtkRcStyle."> - + - + @@ -45746,7 +39792,7 @@ derived from #GtkRcStyle."> - + @@ -45760,9 +39806,9 @@ derived from #GtkRcStyle."> - - - + + + @@ -45772,29 +39818,29 @@ derived from #GtkRcStyle."> - - + + - - + + - - + + - - + + @@ -45967,6 +40013,7 @@ derived from #GtkRcStyle."> glib:nick="last"/> + Creates a new #GtkRecentAction object. To add the action to +a #GtkActionGroup and set the accelerator for the action, +call gtk_action_group_add_action_with_accel(). - + the newly created #GtkRecentAction. + + a unique name for the action - + + the label displayed in menu items and on buttons, or %NULL - + + a tooltip for the action, or %NULL + the stock icon to display in widgets representing the action, or %NULL + Creates a new #GtkRecentAction object. To add the action to +a #GtkActionGroup and set the accelerator for the action, +call gtk_action_group_add_action_with_accel(). - + the newly created #GtkRecentAction + + a unique name for the action - + + the label displayed in menu items and on buttons, or %NULL - + + a tooltip for the action, or %NULL + the stock icon to display in widgets representing the action, or %NULL - + + a #GtkRecentManager, or %NULL for using the default #GtkRecentManager + Returns the value set by gtk_recent_chooser_menu_set_show_numbers(). - + %TRUE if numbers should be shown. + + Sets whether a number should be added to the items shown by the +widgets representing @action. The numbers are shown to provide +a unique character for a mnemonic to be used inside the menu item's +label. Only the first ten items get a number to avoid clashes. - + %TRUE if the shown items should be numbered + - - + + @@ -46084,330 +40126,133 @@ label. Only the first ten items get a number to avoid clashes." - + - + + Adds @filter to the list of #GtkRecentFilter objects held by @chooser. +If no previous filter objects were defined, this function will call +gtk_recent_chooser_set_filter(). - + - - + + a #GtkRecentFilter + - + + Gets the URI currently selected by @chooser. + a newly allocated string holding a URI. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the list of recently used resources in form of #GtkRecentInfo objects. +The return value of this function is affected by the "sort-type" and +"limit" properties of @chooser. +list of #GtkRecentInfo objects. You should +use gtk_recent_info_unref() on every item of the list, and then free +the list itself using g_list_free(). - + A newly allocated + + + - - + + - + + Gets the #GtkRecentFilter objects held by @chooser. +of #GtkRecentFilter objects. You +should just free the returned list using g_slist_free(). + + A singly linked list + + + + + + + Removes @filter from the list of #GtkRecentFilter objects held by @chooser. + a #GtkRecentFilter - + + Selects all the items inside @chooser, if the @chooser supports +multiple selection. + + + Selects @uri inside @chooser. + + %TRUE if @uri was found. + + - - + + a URI + - - - - - - + + Sets @uri as the current URI for @chooser. - + %TRUE if the URI was found. + - - - - - - - - + + a URI + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the comparison function used when sorting to be @sort_func. If the @chooser has the sort type set to #GTK_RECENT_SORT_CUSTOM then the chooser will sort using this function. To the comparison function will be passed two #GtkRecentInfo structs and item comes before the second, zero if the two items are equal and -a negative integer if the first item comes after the second." - version="2.10"> +a negative integer if the first item comes after the second. @@ -46415,283 +40260,557 @@ a negative integer if the first item comes after the second." + closure="1" + destroy="2"> + the comparison function - - + + user data to pass to @sort_func, or %NULL + + scope="async"> + destroy notifier for @sort_data, or %NULL - - + + + Unselects all the items inside @chooser. - + + + + + Unselects @uri inside @chooser. + + + a URI - - + - - + Adds @filter to the list of #GtkRecentFilter objects held by @chooser. +If no previous filter objects were defined, this function will call +gtk_recent_chooser_set_filter(). + + + + + a #GtkRecentFilter + + + - + Gets the #GtkRecentInfo currently selected by @chooser. +when you have finished using it. + + a #GtkRecentInfo. Use gtk_recent_info_unref() when - - - - - - - - - - - - - - - - - - - - - - - + Gets the URI currently selected by @chooser. + + a newly allocated string holding a URI. + - + Gets the #GtkRecentFilter object currently used by @chooser to affect +the display of the recently used resources. - + a #GtkRecentFilter object. + + Gets the list of recently used resources in form of #GtkRecentInfo objects. +The return value of this function is affected by the "sort-type" and +"limit" properties of @chooser. list of #GtkRecentInfo objects. You should use gtk_recent_info_unref() on every item of the list, and then free -the list itself using g_list_free()." - version="2.10"> - +the list itself using g_list_free(). + + A newly allocated + + Gets the number of items returned by gtk_recent_chooser_get_items() +and gtk_recent_chooser_get_uris(). +returned. + + A positive integer, or -1 meaning that all items are + + + + + Gets whether only local resources should be shown in the recently used +resources selector. See gtk_recent_chooser_set_local_only() + + %TRUE if only local resources should be shown. + + + + + Gets whether @chooser can select multiple items. + + %TRUE if @chooser can select more than one item. + + + + + Retrieves whether @chooser should show an icon near the resource. + + %TRUE if the icons should be displayed, %FALSE otherwise. + + + + + Retrieves whether @chooser should show the recently used resources that +were not found. +%FALSE otheriwse. + + %TRUE if the resources not found should be displayed, and + + + + + Returns whether @chooser should display recently used resources +registered as private. +%FALSE otherwise. + + %TRUE if the recent chooser should show private items, + + + + + Gets whether @chooser should display tooltips containing the full path +of a recently user resource. +%FALSE otherwise. + + %TRUE if the recent chooser should show tooltips, + + + + + Gets the value set by gtk_recent_chooser_set_sort_type(). + + the sorting order of the @chooser. + + + + Gets the URI of the recently used resources. +The return value of this function is affected by the "sort-type" and "limit" properties of @chooser. Since the returned array is %NULL terminated, @length may be %NULL. -g_strfreev() to free it." - version="2.10"> +of strings. Use g_strfreev() to free it. + A newly allocated, %NULL-terminated array - - - - - - - - - - - - - - - - - - - - - - + + return location for a the length of the URI list, or %NULL + - + Gets the #GtkRecentFilter objects held by @chooser. +of #GtkRecentFilter objects. You +should just free the returned list using g_slist_free(). + + A singly linked list - + Removes @filter from the list of #GtkRecentFilter objects held by @chooser. + a #GtkRecentFilter - - - + Selects all the items inside @chooser, if the @chooser supports +multiple selection. + + + + Selects @uri inside @chooser. + + %TRUE if @uri was found. + + + + + a URI + + + + + + Sets @uri as the current URI for @chooser. + + %TRUE if the URI was found. + + + + + a URI + + + + + + Sets @filter as the current #GtkRecentFilter object used by @chooser +to affect the displayed recently used resources. + + + + + + a #GtkRecentFilter + + + + + + Sets the number of items that should be returned by +gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris(). + + + + + + a positive integer, or -1 for all items + + + + + + Sets whether only local resources, that is resources using the file:// URI +scheme, should be shown in the recently used resources selector. If +to be accessible through the operating system native file system. + + + + + + %TRUE if only local files can be shown + + + + + + Sets whether @chooser can select multiple items. + + + + + + %TRUE if @chooser can select more than one item + + + + + + Sets whether @chooser should show an icon near the resource when +displaying it. + + + + + + whether to show an icon near the resource + + + + + + Sets whether @chooser should display the recently used resources that +it didn't find. This only applies to local resources. + + + + + + whether to show the local items we didn't find + + + + + + Whether to show recently used resources marked registered as private. + + + + + + %TRUE to show private items, %FALSE otherwise + + + + + + Sets whether to show a tooltips containing the full path of each +recently used resource in a #GtkRecentChooser widget. + + + + + + %TRUE if tooltips should be shown + + + + + + Sets the comparison function used when sorting to be @sort_func. If +the @chooser has the sort type set to #GTK_RECENT_SORT_CUSTOM then +the chooser will sort using this function. +To the comparison function will be passed two #GtkRecentInfo structs and +item comes before the second, zero if the two items are equal and +a negative integer if the first item comes after the second. + + + + + + the comparison function + + + + user data to pass to @sort_func, or %NULL + + + + destroy notifier for @sort_data, or %NULL + + + + + + Changes the sorting order of the recently used resources list displayed by + + + + + + sort order that the chooser should use + + + + + + Unselects all the items inside @chooser. + + + + + + Unselects @uri inside @chooser. + + + + + + a URI + + + + - + transfer-ownership="none"> + The #GtkRecentFilter object to be used when displaying +the recently used resources. + + The maximum number of recently used resources to be displayed, or -1 to display all items. By default, the override that limit on a particular instance of #GtkRecentChooser -by setting this property."> - +by setting this property. + - + transfer-ownership="none"> + Whether this #GtkRecentChooser should display only local (file:) +resources. + - + transfer-ownership="none"> + The #GtkRecentManager instance used by the #GtkRecentChooser to +display the list of recently used resources. + - + transfer-ownership="none"> + Allow the user to select multiple resources. + - + transfer-ownership="none"> + Whether this #GtkRecentChooser should display an icon near the item. + + Whether this #GtkRecentChooser should display the recently used resources even if not present anymore. Setting this to %FALSE will perform a potentially expensive check on every local resource (every remote -resource will always be displayed)."> - +resource will always be displayed). + - - + + - + transfer-ownership="none"> + Whether this #GtkRecentChooser should display a tooltip containing the +full path of the recently used resources. + - + transfer-ownership="none"> + Sorting order to be used when displaying the recently used resources. + - - + + - - + + + - - + version="2.10" + introspectable="0"> + Creates a new #GtkRecentChooserDialog. This function is analogous to +gtk_dialog_new_with_buttons(). + + a new #GtkRecentChooserDialog + - + + Title of the dialog, or %NULL - + + Transient parent of the dialog, or %NULL, + allow-none="1"> + stock ID or text to go in the first button, or %NULL @@ -46736,34 +40853,32 @@ gtk_dialog_new_with_buttons()." + Creates a new #GtkRecentChooserDialog with a specified recent manager. This is useful if you have implemented your own recent manager, or if you -have a customized instance of a #GtkRecentManager object." - version="2.10"> - - +have a customized instance of a #GtkRecentManager object. + + a new #GtkRecentChooserDialog + - + + Title of the dialog, or %NULL - + + Transient parent of the dialog, or %NULL, + a #GtkRecentManager + allow-none="1"> + stock ID or text to go in the first button, or %NULL @@ -46788,13 +40903,17 @@ have a customized instance of a #GtkRecentManager object." + c:type="GtkRecentChooserDialogPrivate" + disguised="1"> + These identify the various errors that can occur while calling +#GtkRecentChooser functions. - + - + %TRUE if the URI was found. + + a URI - + + a newly allocated string holding a URI. @@ -46838,22 +40960,24 @@ have a customized instance of a #GtkRecentManager object." - + - + %TRUE if @uri was found. + + a URI - + @@ -46862,13 +40986,14 @@ have a customized instance of a #GtkRecentManager object." + a URI - + @@ -46880,7 +41005,7 @@ have a customized instance of a #GtkRecentManager object." - + @@ -46892,9 +41017,12 @@ have a customized instance of a #GtkRecentManager object." - + - + A newly allocated + + + @@ -46903,9 +41031,9 @@ have a customized instance of a #GtkRecentManager object." - - - + + + @@ -46916,7 +41044,7 @@ have a customized instance of a #GtkRecentManager object." - + @@ -46925,13 +41053,14 @@ have a customized instance of a #GtkRecentManager object." + a #GtkRecentFilter - + @@ -46940,15 +41069,19 @@ have a customized instance of a #GtkRecentManager object." + a #GtkRecentFilter - - - + + + A singly linked list + + + @@ -46958,7 +41091,7 @@ have a customized instance of a #GtkRecentManager object." - + @@ -46966,20 +41099,32 @@ have a customized instance of a #GtkRecentManager object." - + + the comparison function - - + + user data to pass to @sort_func, or %NULL + - + + destroy notifier for @sort_data, or %NULL - + @@ -46991,7 +41136,7 @@ have a customized instance of a #GtkRecentManager object." - + @@ -47004,18 +41149,21 @@ have a customized instance of a #GtkRecentManager object." - + + + Creates a new #GtkRecentChooserMenu widget. This kind of widget shows the list of recently used resources as a menu, each item as a menu item. Each item inside the menu might have an icon, representing its MIME type, and a number, for mnemonic @@ -47023,61 +41171,65 @@ access. This widget implements the #GtkRecentChooser interface. This widget creates its own #GtkRecentManager object. See the gtk_recent_chooser_menu_new_for_manager() function to know how to create -a #GtkRecentChooserMenu widget bound to another #GtkRecentManager object." - version="2.10"> - - +a #GtkRecentChooserMenu widget bound to another #GtkRecentManager object. + + a new #GtkRecentChooserMenu + + Creates a new #GtkRecentChooserMenu widget using @manager as the underlying recently used resources manager. This is useful if you have implemented your own recent manager, or if you have a customized instance of a #GtkRecentManager object or if you wish to share a common #GtkRecentManager object -among multiple #GtkRecentChooser widgets." - version="2.10"> - - +among multiple #GtkRecentChooser widgets. + + a new #GtkRecentChooserMenu, bound to @manager. + + a #GtkRecentManager + Returns the value set by gtk_recent_chooser_menu_set_show_numbers(). - + %TRUE if numbers should be shown. + + Sets whether a number should be added to the items of @menu. The +numbers are shown to provide a unique character for a mnemonic to +be used inside ten menu item's label. Only the first the items +get a number to avoid clashes. - + whether to show numbers + - - + + - + @@ -47088,29 +41240,29 @@ get a number to avoid clashes." - - + + - - + + - - + + - - + + @@ -47118,9 +41270,11 @@ get a number to avoid clashes." + c:type="GtkRecentChooserMenuPrivate" + disguised="1"> + - - + Creates a new #GtkRecentChooserWidget object. This is an embeddable widget +used to access the recently used resources list. + + a new #GtkRecentChooserWidget + - - + Creates a new #GtkRecentChooserWidget with a specified recent manager. +This is useful if you have implemented your own recent manager, or if you +have a customized instance of a #GtkRecentManager object. + + a new #GtkRecentChooserWidget + + a #GtkRecentManager @@ -47157,7 +41315,7 @@ have a customized instance of a #GtkRecentManager object." - + @@ -47170,19 +41328,12 @@ have a customized instance of a #GtkRecentManager object." + c:type="GtkRecentChooserWidgetPrivate" + disguised="1"> - + + Meta-data to be passed to gtk_recent_manager_add_full() when +registering a recently used resource. @@ -47202,17 +41353,19 @@ registering a recently used resource."> - + + Creates a new #GtkRecentFilter with no rules added to it. Such filter does not accept any recently used resources, so is not particularly useful until you add rules with gtk_recent_filter_add_pattern(), gtk_recent_filter_add_mime_type(), @@ -47220,182 +41373,193 @@ gtk_recent_filter_add_application(), gtk_recent_filter_add_age(). To create a filter that accepts any recently used resource, use: |[ GtkRecentFilter *filter = gtk_recent_filter_new (); -gtk_recent_filter_add_pattern (filter, "*"); -]|" - version="2.10"> - +gtk_recent_filter_add_pattern (filter, "*"); +]| + + a new #GtkRecentFilter - + Adds a rule that allows resources based on their age - that is, the number +of days elapsed since they were last modified. - + + number of days + + + + + + Adds a rule that allows resources based on the name of the application +that has registered them. + + + + + + an application name - + Adds a rule to a filter that allows resources based on a custom callback +function. The bitfield @needed which is passed in provides information +about what sorts of information that the filter function needs; +this allows GTK+ to avoid retrieving expensive information when +it isn't needed by the filter. - + + + + bitfield of flags indicating the information that the custom filter function needs. + + + + callback function; if the function returns %TRUE, then the file will be displayed. + + + + data to pass to @func + + + + function to call to free @data when it is no longer needed. + + + + + + Adds a rule that allows resources based on the name of the group +to which they belong + + + + + + a group name + + + + Adds a rule that allows resources based on their registered MIME type. + a MIME type + Adds a rule that allows resources based on a pattern matching their +display name. + a file pattern + Adds a rule allowing image files in the formats supported +by GdkPixbuf. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Tests whether a file should be displayed according to @filter. The #GtkRecentFilterInfo structure @filter_info should include the fields returned from gtk_recent_filter_get_needed(). This function will not typically be used by applications; it is intended principally for use in the implementation of -#GtkRecentChooser." - version="2.10"> +#GtkRecentChooser. - + %TRUE if the file should be displayed + + a #GtkRecentFilterInfo structure containing information about a recently used resource + + Gets the human-readable name for the filter. +See gtk_recent_filter_set_name(). +is owned by the filter object and should not be freed. + + the name of the filter, or %NULL. The returned string + + + + + Gets the fields that need to be filled in for the structure +passed to gtk_recent_filter_filter() +This function will not typically be used by applications; it +is intended principally for use in the implementation of +#GtkRecentChooser. +calling gtk_recent_filter_filter() + + bitfield of flags indicating needed fields when + + + + + Sets the human-readable name of the filter; this is the string +that will be displayed in the recently used resources selector +user interface if there is a selectable list of filters. + + + + + + then human readable name of @filter + + + + - + - + @@ -47459,402 +41623,374 @@ is intended principally for use in the implementation of - + - - - - - - + #GtkRecentInfo is an opaque data structure +whose members can only be accessed using the provided API. +#GtkRecentInfo constains all the meta-data +associated with an entry in the recently used files list. + + Checks whether the resource pointed by @info still exists. At +the moment this check is done only on resources pointing to local files. - - - - - - - - - - - - - - - - - - - - - + %TRUE if the resource exists + + Gets the timestamp (seconds from system's Epoch) when the resource was added to the recently used resources list. -the resource was added to the list, or -1 on failure." - version="2.10"> +the resource was added to the list, or -1 on failure. - + the number of seconds elapsed from system's Epoch when + - + Gets the number of days elapsed since the last update of the resource +pointed by @info. +since the time this resource was last modified. - - - - - - - - - - - + a positive integer containing the number of days elapsed + + Gets the data regarding the application that has registered the resource pointed by @info. If the command line contains any escape characters defined inside the storage specification, they will be expanded. resource inside the recently used list, or %FALSE otherwise. The -modified or freed" - version="2.10"> +modified or freed - + %TRUE if an application with @app_name has registered this + + the name of the application that has registered this item + caller-allocates="0" + transfer-ownership="none"> + return location for the string containing the command line - + caller-allocates="0" + transfer-ownership="full"> + return location for the number of times this item was registered + - + caller-allocates="0" + transfer-ownership="full"> + return location for the timestamp this item was last registered for this application + - - + Retrieves the list of applications that have registered this resource. +a newly allocated %NULL-terminated array of strings. +Use g_strfreev() to free it. + + - + allow-none="1"> + return location for the length of the returned list + - - + Gets the (short) description of the resource. +is owned by the recent manager, and should not be freed. + + the description of the resource. The returned string - + Gets the name of the resource. If none has been defined, the basename +of the resource is obtained. +is owned by the recent manager, and should not be freed. - + the display name of the resource. The returned string + - - - - - + Returns all groups registered for the recently used item @info. The array of returned group names will be %NULL terminated, so length might optionally be %NULL. -%NULL terminated array of strings. Use g_strfreev() to free it." - version="2.10"> - - +a newly allocated %NULL terminated array of strings. +Use g_strfreev() to free it. + + - - - - - - - - - - - + allow-none="1"> + return location for the number of groups returned + + Retrieves the icon of size @size associated to the resource MIME type. +or %NULL. Use g_object_unref() when finished using the icon. + a #GdkPixbuf containing the icon, - + the size of the icon in pixels + + + Gets the MIME type of the resource. +is owned by the recent manager, and should not be freed. + + the MIME type of the resource. The returned string + + + + + Gets the timestamp (seconds from system's Epoch) when the resource +was last modified. +the resource was last modified, or -1 on failure. + + the number of seconds elapsed from system's Epoch when + + + + + Gets the value of the "private" flag. Resources in the recently used +list that have this flag set to %TRUE should only be displayed by the +applications that have registered them. + + %TRUE if the private flag was found, %FALSE otherwise. + + + + Computes a valid UTF-8 string that can be used as the name of the item in a +menu or list. For example, calling this function on an item that refers to +"file:///foo/bar.txt" will yield "bar.txt". +g_free(). + A newly-allocated string in UTF-8 encoding; free it with + + + + + Gets the URI of the resource. +owned by the recent manager, and should not be freed. + + the URI of the resource. The returned string is + Gets a displayable version of the resource's URI. If the resource is local, it returns a local path; if the resource is not local, it returns the UTF-8 encoded content of gtk_recent_info_get_uri(). -resource's URI or %NULL. Use g_free() when done using it." - version="2.10"> +resource's URI or %NULL. Use g_free() when done using it. + a newly allocated UTF-8 string containing the - + Gets the timestamp (seconds from system's Epoch) when the resource +was last visited. +the resource was last visited, or -1 on failure. - + the number of seconds elapsed from system's Epoch when + + + Checks whether an application registered this resource using @app_name. +%FALSE otherwise. + + %TRUE if an application with name @app_name was found, + + + + + a string containing an application name + + + + + + Checks whether @group_name appears inside the groups registered for the +recently used item @info. + + %TRUE if the group was found. + + + + + name of a group + + + + + Checks whether the resource is local or not by looking at the +scheme of its URI. - + %TRUE if the resource is local. + - - - + Gets the name of the last application that have registered the +recently used resource represented by @info. + + an application name. Use g_free() to free it. + - + Checks whether two #GtkRecentInfo structures point to the same resource. -resource, %FALSE otherwise." - version="2.10"> +resource, %FALSE otherwise. - + %TRUE if both #GtkRecentInfo structures point to se same + + a #GtkRecentInfo + + Increases the reference count of @recent_info by one. +by one. + + the recent info object with its reference count increased + + + + + Decreases the reference count of @info by one. If the reference +count reaches zero, @info is deallocated, and the memory freed. + + + + + #GtkRecentManager contains only private data +and should be accessed using the provided API. + Creates a new recent manager object. Recent manager objects are used to +handle the list of recently used resources. A #GtkRecentManager object +monitors the recently used resources list, and emits the "changed" signal +each time something inside the list changes. +#GtkRecentManager objects are expensive: be sure to create them only when +needed. You should use gtk_recent_manager_get_default() instead. + A newly created #GtkRecentManager object. - + Gets a unique instance of #GtkRecentManager, that you can share +in your application without caring about memory management. The +returned instance will be freed when you application terminates. + + A unique #GtkRecentManager. Do not ref or unref it. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a new resource, pointed by @uri, into the recently used resources list, using the metadata specified inside the #GtkRecentData structure passed in @recent_data. The passed URI will be used to identify this resource inside the @@ -47870,168 +42006,177 @@ to be used when viewing the item instead of the last component of the URI; a short description of the item; whether the item should be considered private - that is, should be displayed only by the applications that have registered it. -recently used resources list, %FALSE otherwise." - version="2.10"> +recently used resources list, %FALSE otherwise. - + %TRUE if the new item was successfully added to the + + a valid URI + metadata of the resource - + + Adds a new resource, pointed by @uri, into the recently used +resources list. +This function automatically retrieves some of the needed +metadata and setting other metadata to common default values; it +then feeds the data to gtk_recent_manager_add_full(). +See gtk_recent_manager_add_full() if you want to explicitly +define the metadata for the resource pointed by @uri. +to the recently used resources list - + %TRUE if the new item was successfully added + + a valid URI + + + + + + Gets the list of recently used resources. +newly allocated #GtkRecentInfo objects. Use +gtk_recent_info_unref() on each item inside the list, and then +free the list itself using g_list_free(). + + a list of + + + + + + + Checks whether there is a recently used resource registered +with @uri inside the recent manager. + + %TRUE if the resource was found, %FALSE otherwise. + + + + + a URI + Searches for a URI inside the recently used resources list, and returns a structure containing informations about the resource like its MIME type, or its display name. about the resource pointed by @uri, or %NULL if the URI was not registered in the recently used resources list. Free with -gtk_recent_info_unref()." - version="2.10" - throws="1"> +gtk_recent_info_unref(). + a #GtkRecentInfo structure containing information - - - - - - - - - - + a URI + Changes the location of a recently used resource from @uri to @new_uri. +Please note that this function will not affect the resource pointed +by the URIs, but only the URI used in the recently used resources list. - + %TRUE on success. + + the URI of a recently used resource - + + the new URI of the recently used resource, or %NULL to remove the item pointed by @uri in the list - - - - - - - - - - - - - - - - - - - - - - + Purges every item from the recently used resources list. +recently used resources list. - + the number of items that have been removed from the + - - + + Removes a resource pointed by @uri from the recently used resources +list handled by a recent manager. +removed by the recently used resources list, and %FALSE otherwise. + + %TRUE if the item pointed by @uri has been successfully + + + + + the URI of the item you wish to remove + + + + + + - - + + - - - - + - + - - + + + glib:is-gtype-struct-for="RecentManager" + version="2.10"> + #GtkRecentManagerClass contains only private data. - + @@ -48042,29 +42187,29 @@ recently used resources list." - - + + - - + + - - + + - - + + @@ -48072,16 +42217,12 @@ recently used resources list." + Error codes for #GtkRecentManager operations - + - + @@ -48125,20 +42268,17 @@ Error codes for GtkRecentManager operations" - + + Used to specify the sorting method to be applyed to the recently +used resource list. + + Represents a request of a screen object in a given orientation. These +are primarily used in container implementations when allocating a natural +size for children calling. See gtk_distribute_natural_allocation(). + + + + + + + + + + + glib:get-type="gtk_requisition_get_type" + c:symbol-prefix="requisition"> + A <structname>GtkRequisition</structname> represents the desired size of a widget. See +<xref linkend="size-requisition"/> for more information. - + - + - + + Allocates a new #GtkRequisition structure and initializes its elements to zero. +be freed with gtk_requisition_free(). + a new empty #GtkRequisition. The newly allocated #GtkRequisition should + + + + + Copies a #GtkRequisition. + + a copy of @requisition - + + Frees a #GtkRequisition. @@ -48267,6 +42429,7 @@ used resource list." glib:nick="help"/> - + + + Creates a new #GtkRuler with the given orientation. - + a new #GtkRuler. + - + + + the ruler's orientation. + + + + + + + + + + + + + + + + + + + + + Gets the units used for a #GtkRuler. See gtk_ruler_set_metric(). + + the units currently used for @ruler + + + + + Retrieves values indicating the range and current position of a #GtkRuler. +See gtk_ruler_set_range(). + + + + + + location to store lower limit of the ruler, or %NULL + + + + location to store upper limit of the ruler, or %NULL + + + + location to store the current position of the mark on the ruler, or %NULL + + + + location to store the maximum size of the ruler used when calculating the space to leave for the text, or %NULL. + + + + @@ -48295,130 +42514,54 @@ used resource list." - - - - - - + + This sets the range of the ruler. - + the lower limit of the ruler + - + the upper limit of the ruler + - + the mark on the ruler + - + the maximum size of the ruler used when calculating the space to leave for the text + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + transfer-ownership="none"> + The metric used for the ruler. + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - + @@ -48440,7 +42583,7 @@ See gtk_ruler_set_range()."> - + @@ -48451,29 +42594,29 @@ See gtk_ruler_set_range()."> - - + + - - + + - - + + - - + + @@ -48488,780 +42631,805 @@ See gtk_ruler_set_range()."> - + - + - + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + Creates a new #GtkScale. + + a new #GtkScale + + + + + the scale's orientation. + + + + the #GtkAdjustment which sets the range of the scale, or %NULL to create a new adjustment. + + + + + + Creates a new scale widget with the given orientation that lets the +user input a number between @min and @max (including @min and @max) +with the increment @step. @step must be nonzero; it's the distance +the slider moves when using the arrow keys to adjust the scale +value. +Note that the way in which the precision is derived works best if @step +is a power of ten. If the resulting precision is not suitable for your +needs, use gtk_scale_set_digits() to correct it. + + a new #GtkScale + + + + + the scale's orientation. + + + + minimum value + + + + maximum value + + + + step increment (tick size) used with keyboard shortcuts + + + + - + + Obtains the coordinates where the scale will draw the +#PangoLayout representing the text in the scale. Remember +when using the #PangoLayout function you need to convert to +and from pixels using PANGO_PIXELS() or #PANGO_SCALE. +If the #GtkScale:draw-value property is %FALSE, the return +values are undefined. - - + + location to store X offset of layout, or %NULL + - - + + location to store Y offset of layout, or %NULL + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a mark at @value. +A mark is indicated visually by drawing a tick mark next to the scale, +and GTK+ makes it easy for the user to position the scale exactly at the marks value. -If @markup is not %NULL, text is shown next to the tick mark. -To remove marks from a scale, use gtk_scale_clear_marks()." - version="2.16"> +If @markup is not %NULL, text is shown next to the tick mark. +To remove marks from a scale, use gtk_scale_clear_marks(). - + the value at which the mark is placed, must be between the lower and upper limits of the scales' adjustment + + where to draw the mark. For a horizontal scale, #GTK_POS_TOP is drawn above the scale, anything else below. For a vertical scale, #GTK_POS_LEFT is drawn to the left of the scale, anything else to the right. - + + Text to be shown at the mark, using <link linkend="PangoMarkupFormat">Pango markup</link>, or %NULL + Removes any marks that have been added with gtk_scale_add_mark(). - - + + Gets the number of decimal places that are displayed in the value. + + the number of decimal places that are displayed + + + + + Returns whether the current value is displayed as a string +next to the slider. + + whether the current value is displayed as a string + + + + + Gets the #PangoLayout used to display the scale. The returned +object is owned by the scale so does not need to be freed by +the caller. +or %NULL if the #GtkScale:draw-value property is %FALSE. + + the #PangoLayout for this scale, + + + + + Obtains the coordinates where the scale will draw the +#PangoLayout representing the text in the scale. Remember +when using the #PangoLayout function you need to convert to +and from pixels using PANGO_PIXELS() or #PANGO_SCALE. +If the #GtkScale:draw-value property is %FALSE, the return +values are undefined. + + + + + + location to store X offset of layout, or %NULL + + + + location to store Y offset of layout, or %NULL + + + + + + Gets the position in which the current value is displayed. + + the position in which the current value is displayed + + + + + Sets the number of decimal places that are displayed in the value. +Also causes the value of the adjustment to be rounded off to this +number of digits, so the retrieved value matches the value the user saw. + + + + + + the number of decimal places to display, e.g. use 1 to display 1.0, 2 to display 1.00, etc + + + + + + Specifies whether the current value is displayed as a string next +to the slider. + + + + + + %TRUE to draw the value + + + + + + Sets the position in which the current value is displayed. + + + + + + the position in which the current value is displayed + + + + + + - - + + - - + + - - + + - - - - - - - + Signal which allows you to change how the scale value is displayed. +Connect a signal handler which returns an allocated string representing +Here's an example signal handler which displays a value 1.0 as +with "--&gt;1.0&lt;--". |[ static gchar* format_value_callback (GtkScale *scale, gdouble value) { -return g_strdup_printf ("--&gt;&percnt;0.*g&lt;--", +return g_strdup_printf ("--&gt;&percnt;0.*g&lt;--", gtk_scale_get_digits (scale), value); } -]|"> +]| - + allocated string representing @value + - - + + the value to format + - + + - - + Creates a #GtkScaleButton, with a range between @min and @max, with +a stepping of @step. + + a new #GtkScaleButton + - - + + a stock icon size + - + the minimum value of the scale (usually 0) + - + the maximum value of the scale (usually 100) + - + the stepping of value when a scroll-wheel event, or up/down arrow event occurs (usually 2) + - - - - + + a %NULL-terminated array of icon names, or %NULL if you want to set the list later with gtk_scale_button_set_icons() + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the #GtkAdjustment associated with the #GtkScaleButton's scale. +See gtk_range_get_adjustment() for details. - - - - - - - - - - - + the adjustment associated with the scale + - + Retrieves the minus button of the #GtkScaleButton. + + the minus button of the #GtkScaleButton + + + + + Retrieves the plus button of the #GtkScaleButton. + + the plus button of the #GtkScaleButton - + Retrieves the popup of the #GtkScaleButton. + + the popup of the #GtkScaleButton - - - + + Gets the current value of the scale button. + + current value of the scale button + - + + Sets the #GtkAdjustment to be used as a model +for the #GtkScaleButton's scale. +See gtk_range_set_adjustment() for details. - - + + a #GtkAdjustment + - - + + Sets the icons to be used by the scale button. +For details, see the #GtkScaleButton:icons property. + + + + + + a %NULL-terminated array of icon names + + + + + + Sets the current value of the scale; if the value is outside +the minimum or maximum range values, it will be clamped to fit +inside them. The scale button emits the #GtkScaleButton::value-changed +signal if the value changes. + + + + + + new value of the scale button + + + + + + + The names of the icons to be used by the scale button. The first item in the array will be used in the button when the current value is the lowest value, the second item for the highest value. All the subsequent icons will be used for all the other values, spread evenly over the range of values. -If there's only one icon name in the @icons array, it will +If there's only one icon name in the @icons array, it will be used for all the values. If only two icon names are in the @icons array, the first one will be used for the bottom 50% of the scale, and the second one for the top 50%. It is recommended to use at least 3 icons so that the #GtkScaleButton reflects the current value of the scale -better for the users."> - +better for the users. + - - + + - - + + - - - - - - - + The ::popdown signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to popdown the scale widget. -The default binding for this signal is Escape." - version="2.12"> - - +The default binding for this signal is Escape. + + - + The ::popup signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to popup the scale widget. -The default bindings for this signal are Space, Enter and Return." - version="2.12"> - - +The default bindings for this signal are Space, Enter and Return. + + - - - + + The ::value-changed signal is emitted when the value field has +changed. + + - - + + the new value + @@ -49273,7 +43441,7 @@ changed." - + @@ -49282,41 +43450,43 @@ changed." - + - - + + - - + + - - + + - - + + - + - + @@ -49334,13 +43504,13 @@ changed." - + - + @@ -49352,7 +43522,7 @@ changed." - + @@ -49360,37 +43530,41 @@ changed." - - + + location to store X offset of layout, or %NULL + - - + + location to store Y offset of layout, or %NULL + - - + + - - + + - - + + + + + + + Creates a new scrollbar with the given orientation. + + the new #GtkScrollbar. + + + + + the scrollbar's orientation. + + + + the #GtkAdjustment to use, or %NULL to create a new adjustment. + + + + @@ -49509,29 +43703,29 @@ changed." - - + + - - + + - - + + - - + + @@ -49539,6 +43733,7 @@ changed." - - - + + + Creates a new scrolled window. +The two arguments are the scrolled window's adjustments; these will be +shared with the scrollbars and the child widget to keep the bars in sync +with the child. Usually you want to pass %NULL for the adjustments, which +will cause the scrolled window to create them for you. + + a new scrolled window + + allow-none="1"> + horizontal adjustment + allow-none="1"> + vertical adjustment - + + Used to add children without native scrolling capabilities. This +is simply a convenience function; it is equivalent to adding the +unscrollable child to a viewport, then adding the viewport to the +scrolled window. If a child has native scrolling, use +gtk_container_add() instead of this function. +The viewport scrolls the child by moving its #GdkWindow, and takes +the size of the child to be the size of its toplevel #GdkWindow. +This will be very wrong for most widgets that support native scrolling; +for example, if you add a widget such as #GtkTreeView with a viewport, +the whole widget will scroll, including the column headings. Thus, +widgets with native scrolling support should not be used with the +#GtkViewport proxy. +A widget supports scrolling natively if the +set_scroll_adjustments_signal field in #GtkWidgetClass is non-zero, +i.e. has been filled in with a valid signal identifier. - - - - - - - - - - - - + + the widget you want to scroll + - - - - - - + c:identifier="gtk_scrolled_window_get_hadjustment"> + Returns the horizontal scrollbar's adjustment, used to connect the +horizontal scrollbar to the child widget's horizontal scroll +functionality. + + the horizontal #GtkAdjustment - + Returns the horizontal scrollbar of @scrolled_window. +or %NULL if it does not have one. + + the horizontal scrollbar of the scrolled window, + + Gets the placement of the contents with respect to the scrollbars +for the scrolled window. See gtk_scrolled_window_set_placement(). +See also gtk_scrolled_window_set_placement() and +gtk_scrolled_window_unset_placement(). + + the current placement value. + + + + + Retrieves the current policy values for the horizontal and vertical +scrollbars. See gtk_scrolled_window_set_policy(). + + + + + + location to store the policy for the horizontal scrollbar, or %NULL. + + + + location to store the policy for the vertical scrollbar, or %NULL. + + + + + + Gets the shadow type of the scrolled window. See +gtk_scrolled_window_set_shadow_type(). + + the current shadow type + + + + + Returns the vertical scrollbar's adjustment, used to connect the +vertical scrollbar to the child widget's vertical scroll functionality. + + the vertical #GtkAdjustment + + + - + Returns the vertical scrollbar of @scrolled_window. +or %NULL if it does not have one. + + the vertical scrollbar of the scrolled window, - + + Sets the #GtkAdjustment for the horizontal scrollbar. - - - - - - - - - - - - - - - - - - + + horizontal scroll adjustment + + Sets the placement of the contents with respect to the scrollbars for the scrolled window. The default is %GTK_CORNER_TOP_LEFT, meaning the child is in the top left, with the scrollbars underneath and to the right. Other values in #GtkCornerType are %GTK_CORNER_TOP_RIGHT, %GTK_CORNER_BOTTOM_LEFT, and %GTK_CORNER_BOTTOM_RIGHT. See also gtk_scrolled_window_get_placement() and -gtk_scrolled_window_unset_placement()."> +gtk_scrolled_window_unset_placement(). + position of the child window - + + Sets the scrollbar policy for the horizontal and vertical scrollbars. +The policy determines when the scrollbar should appear; it is a value +from the #GtkPolicyType enumeration. If %GTK_POLICY_ALWAYS, the +scrollbar is always present; if %GTK_POLICY_NEVER, the scrollbar is +never present; if %GTK_POLICY_AUTOMATIC, the scrollbar is present only +if needed (that is, if the slider part of the bar would be smaller +than the trough - the display is larger than the page size). - - - - - + + + policy for horizontal bar + + + + policy for vertical bar + + + + c:identifier="gtk_scrolled_window_set_shadow_type"> + Changes the type of shadow drawn around the contents of + kind of shadow to draw around scrolled window contents - - - - - - + + Sets the #GtkAdjustment for the vertical scrollbar. - - + + vertical scroll adjustment + - - + + Unsets the placement of the contents with respect to the scrollbars +for the scrolled window. If no window placement is set for a scrolled +window, it obeys the "gtk-scrolled-window-placement" XSETTING. +See also gtk_scrolled_window_set_placement() and +gtk_scrolled_window_get_placement(). + + + + + + - - + + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + Whether "window-placement" should be used to determine the location +of the contents with respect to the scrollbars. Otherwise, the +"gtk-scrolled-window-placement" setting is used. + - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - - + + - + - + @@ -49844,12 +44037,12 @@ of the contents with respect to the scrollbars. Otherwise, the - + - + - + @@ -49859,13 +44052,13 @@ of the contents with respect to the scrollbars. Otherwise, the - + - + @@ -49879,39 +44072,44 @@ of the contents with respect to the scrollbars. Otherwise, the - - + + - - + + - - + + - - + + + + + glib:get-type="gtk_selection_data_get_type" + c:symbol-prefix="selection_data"> @@ -49922,274 +44120,292 @@ of the contents with respect to the scrollbars. Otherwise, the - + - + - + + + Makes a copy of a #GtkSelectionData structure and its data. + + a pointer to a copy of @data. + + + + + Frees a #GtkSelectionData structure returned from +gtk_selection_data_copy(). + + + + + + Retrieves the raw data of the selection. + + the raw data of the selection. + + + + + Retrieves the data type of the selection. + + the data type of the selection. + + + + + Retrieves the display of the selection. + + the display of the selection. + + + + + Retrieves the format of the selection. + + the format of the selection. + + + + + Retrieves the length of the raw data of the selection. + + the length of the data of the selection. + + + + + Gets the contents of the selection data as a #GdkPixbuf. +image type and it could be converted to a #GdkPixbuf, a +newly allocated pixbuf is returned, otherwise %NULL. +If the result is non-%NULL it must be freed with g_object_unref(). + + if the selection data contained a recognized + + + - + version="2.16" + introspectable="0"> + Retrieves the selection #GdkAtom of the selection data. + + the selection #GdkAtom of the selection data. - + version="2.14" + introspectable="0"> + Retrieves the target of the selection. + + the target of the selection. - - - - - - + + Gets the contents of @selection_data as an array of targets. +This can be used to interpret the results of getting +the standard TARGETS target that is always supplied for +any selection. +array of targets, otherwise %FALSE. - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if @selection_data contains a valid + - - + + location to store an array of targets. The result stored here must be freed with g_free(). + - - - - - - - - - - + + location to store number of items in @targets. + - - - - - - - - - - - - - - + Gets the contents of the selection data as a UTF-8 string. text type and it could be converted to UTF-8, a newly allocated string containing the converted text, otherwise %NULL. -If the result is non-%NULL it must be freed with g_free()."> - - - - - - - +If the result is non-%NULL it must be freed with g_free(). - + if the selection data contained a recognized + - - - - - - - - - - - - - - - - - - - - - - + Gets the contents of the selection data as array of URIs. the selection data contains a list of URIs, a newly allocated %NULL-terminated string array containing the URIs, otherwise %NULL. If the result is -non-%NULL it must be freed with g_strfreev()." - version="2.6"> - +non-%NULL it must be freed with g_strfreev(). + + if - + + Stores new data into a #GtkSelectionData object. Should +<emphasis>only</emphasis> be called from a selection handler callback. +Zero-terminates the stored data. - + - - + + the type of selection data + - - + + format (number of bits in a unit) + + + + pointer to the data (will be copied) + + + + length of the data + - + + Sets the contents of the selection from a #GdkPixbuf +The pixbuf is converted to the form determined by +otherwise %FALSE. - - - - - - + %TRUE if the selection was successfully set, + - - + + a #GdkPixbuf + + + + + + Sets the contents of the selection from a UTF-8 encoded string. +The string is converted to the form determined by +otherwise %FALSE. + + %TRUE if the selection was successfully set, + + + + + a UTF-8 string + + + + the length of @str, or -1 if @str is nul-terminated. + + + + + + Sets the contents of the selection from a list of URIs. +The string is converted to the form determined by +otherwise %FALSE. + + %TRUE if the selection was successfully set, + + + + + a %NULL-terminated array of strings holding URIs + + Given a #GtkSelectionData object holding a list of targets, determines if any of the targets in @targets can be used to provide a #GdkPixbuf. -and a suitable target for images is included, otherwise %FALSE." - version="2.6"> +and a suitable target for images is included, otherwise %FALSE. - + %TRUE if @selection_data holds a list of targets, + - + whether to accept only targets for which GTK+ knows how to convert a pixbuf into the format + + + Given a #GtkSelectionData object holding a list of targets, +determines if any of the targets in @targets can be used to +provide rich text. +and a suitable target for rich text is included, +otherwise %FALSE. + + %TRUE if @selection_data holds a list of targets, + + + + + a #GtkTextBuffer + + + + + + Given a #GtkSelectionData object holding a list of targets, +determines if any of the targets in @targets can be used to +provide text. +and a suitable target for text is included, otherwise %FALSE. + + %TRUE if @selection_data holds a list of targets, + + + + Given a #GtkSelectionData object holding a list of targets, determines if any of the targets in @targets can be used to provide a list or URIs. -and a suitable target for URI lists is included, otherwise %FALSE." - version="2.10"> +and a suitable target for URI lists is included, otherwise %FALSE. - - - - - - - - - - - + %TRUE if @selection_data holds a list of targets, + @@ -50213,15 +44429,13 @@ gtk_selection_data_copy()."> value="3" c:identifier="GTK_SELECTION_MULTIPLE" glib:nick="multiple"/> - + Determines how GTK+ handles the sensitivity of stepper arrows +at the end of range widgets. glib:nick="off"/> + + + Creates a new #GtkSeparator with the given orientation. + + a new #GtkSeparator. + + + + + the separator's orientation. + + + + + + + - + + - - + Creates a new #GtkSeparatorMenuItem. + + a new #GtkSeparatorMenuItem. + @@ -50281,49 +44516,56 @@ gtk_selection_data_copy()."> + + - + + - - + Create a new #GtkSeparatorToolItem + + the new #GtkSeparatorToolItem + + Returns whether @item is drawn as a line, or just blank. +See gtk_separator_tool_item_set_draw(). - + %TRUE if @item is drawn as a line, or just blank. + + Whether @item is drawn as a vertical line, or just blank. +Setting this to %FALSE along with gtk_tool_item_set_expand() is useful +to create an item that forces following items to the end of the toolbar. - + whether @item is drawn as a vertical line + - - + + @@ -50339,29 +44581,29 @@ to create an item that forces following items to the end of the toolbar." - - + + - - + + - - + + - - + + @@ -50369,33 +44611,36 @@ to create an item that forces following items to the end of the toolbar." + c:type="GtkSeparatorToolItemPrivate" + disguised="1"> - + Gets the #GtkSettings object for the default GDK screen, creating it if necessary. See gtk_settings_get_for_screen(). -screen, then returns %NULL."> - +screen, then returns %NULL. + + a #GtkSettings object. If there is no default - + Gets the #GtkSettings object for @screen, creating it if necessary. + + a #GtkSettings object. + a #GdkScreen. @@ -50412,7 +44657,8 @@ screen, then returns %NULL."> + c:identifier="gtk_settings_install_property_parser" + introspectable="0"> @@ -50420,11 +44666,45 @@ screen, then returns %NULL."> - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -50456,355 +44736,402 @@ screen, then returns %NULL."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Holds a hash table representation of the #GtkSettings:gtk-color-scheme +setting, mapping color names to #GdkColor<!-- -->s. + + + + - - + + + Controls the direction of the sort indicators in sorted list and tree views. By default an arrow pointing down means the column is sorted -in ascending order. When set to %TRUE, this order will be inverted."> - +in ascending order. When set to %TRUE, this order will be inverted. + + + + Whether the application prefers to use a dark theme. If a GTK+ theme +includes a dark variant, it will be used instead of the configured +theme. +Some applications benefit from minimizing the amount of light pollution that +interferes with the content. Good candidates for dark themes are photo and +video editors that make the actual content get all the attention and minimize +the distraction of the chrome. +Dark themes should not be used for documents, where large spaces are white/light +and the dark chrome creates too much contrast (web browser, text editor...). + - + transfer-ownership="none"> + Whether mnemonics should be automatically shown and hidden when the user +presses the mnemonic activator. + + A palette of named colors for use in themes. The format of the string is <programlisting> ... </programlisting> -Color names must be acceptable as identifiers in the -<link linkend="gtk-Resource-Files">gtkrc</link> syntax, and +Color names must be acceptable as identifiers in the +<link linkend="gtk-Resource-Files">gtkrc</link> syntax, and color specifications must be in the format accepted by gdk_color_parse(). Note that due to the way the color tables from different sources are merged, color specifications will be converted to hexadecimal form when getting this property. Starting with GTK+ 2.12, the entries can alternatively be separated -by ';' instead of newlines: +by ';' instead of newlines: <programlisting> -</programlisting>"> - +</programlisting> + - + Whether the cursor should blink. +Also see the #GtkSettings:gtk-cursor-blink-timeout setting, +which allows more flexible control over cursor blinking. + + + - - - - + transfer-ownership="none"> + + Time after which the cursor stops blinking, in seconds. The timer is reset after each user interaction. Setting this to zero has the same effect as setting -#GtkSettings:gtk-cursor-blink to %FALSE."> - +#GtkSettings:gtk-cursor-blink to %FALSE. + - - + + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + Whether menu items should have visible accelerators which can be +activated. + - - + + + Whether to play any event sounds at all. +See the <ulink url="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec">Sound Theme spec</ulink> for more information on event sounds and sound themes. -GTK+ itself does not support event sounds, you have to use a loadable -module like the one that comes with libcanberra."> - +GTK+ itself does not support event sounds, you have to use a loadable +module like the one that comes with libcanberra. + + Whether to play event sounds as feedback to user input. +See the <ulink url="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec">Sound Theme spec</ulink> for more information on event sounds and sound themes. -GTK+ itself does not support event sounds, you have to use a loadable -module like the one that comes with libcanberra."> - +GTK+ itself does not support event sounds, you have to use a loadable +module like the one that comes with libcanberra. + - + transfer-ownership="none"> + Whether labels and menu items should have visible mnemonics which +can be activated. + - + transfer-ownership="none"> + Whether tooltips should be shown on widgets. + + When %TRUE, keyboard navigation and other input-related errors will cause a beep. Since the error bell is implemented using gdk_window_beep(), the windowing system may offer ways to configure the error bell in many ways, such as flashing the -window or similar visual effects."> - +window or similar visual effects. + - - - - - - - - - - - - - + + + + + + + + + + + + + A list of icon sizes. The list is separated by colons, and item has the form: <replaceable>size-name</replaceable> = <replaceable>width</replaceable> , <replaceable>height</replaceable> -E.g. "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48". -gtk-button, gtk-small-toolbar, gtk-large-toolbar, gtk-dnd, -gtk-dialog. Applications can register their own named icon -sizes with gtk_icon_size_register()."> - +E.g. "gtk-menu=16,16:gtk-button=20,20:gtk-dialog=48,48". +gtk-button, gtk-small-toolbar, gtk-large-toolbar, gtk-dnd, +gtk-dialog. Applications can register their own named icon +sizes with gtk_icon_size_register(). + - - - - - + transfer-ownership="none"> + - - + + Which IM (input method) module should be used by default. This is the +input method that will be used if the user has not explicitly chosen +another input method from the IM context menu. +See #GtkIMContext and see the #GtkSettings:gtk-show-input-method-menu property. + + + + - + transfer-ownership="none"> + When %TRUE, keyboard navigation should be able to reach all widgets +by using the cursor keys only. Tab, Shift etc. keys can't be expected +to be present on the used input device. + - + transfer-ownership="none"> + When %TRUE, some widgets will wrap around when doing keyboard +navigation, such as menus, menubars and notebooks. + - - + + - - + + + A comma-separated list of print backends to use in the print dialog. Available print backends depend on the GTK+ installation, -and may include "file", "cups", "lpr" or "papi"."> - +and may include "file", "cups", "lpr" or "papi". + + A command to run for displaying the print preview. The command should contain a %f placeholder, which will get replaced by the path to the pdf file. The command may also contain a %s placeholder, which will get replaced by the path to a file -containing the print settings in the format produced by +containing the print settings in the format produced by gtk_print_settings_to_file(). The preview application is responsible for removing the pdf file -and the print settings file when it is done."> - +and the print settings file when it is done. + + The number of recently used files that should be displayed by default by #GtkRecentChooser implementations and by the #GtkFileChooser. A value of --1 means every recently used file stored."> - +-1 means every recently used file stored. + + The maximum age, in days, of the items inside the recently used resources list. Items older than this setting will be excised from the list. If set to 0, the list will always be empty; if -set to -1, no item will be removed."> - +set to -1, no item will be removed. + - - + + - - + + + The XDG sound theme to use for event sounds. +See the <ulink url="http://www.freedesktop.org/wiki/Specifications/sound-theme-spec">Sound Theme spec</ulink> for more information on event sounds and sound themes. -GTK+ itself does not support event sounds, you have to use a loadable -module like the one that comes with libcanberra."> - +GTK+ itself does not support event sounds, you have to use a loadable +module like the one that comes with libcanberra. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + Amount of time, in milliseconds, after which the browse mode will be disabled. See #GtkSettings:gtk-tooltip-browse-timeout for more information -about browse mode."> - +about browse mode. + + Controls the time after which tooltips will appear when browse mode is enabled, in milliseconds. Browse mode is enabled when the mouse pointer moves off an object where a tooltip was currently being displayed. If the mouse pointer hits another object before the browse mode timeout expires (see -#GtkSettings:gtk-tooltip-browse-mode-timeout), it will take the +#GtkSettings:gtk-tooltip-browse-mode-timeout), it will take the amount of milliseconds specified by this setting to popup the tooltip -for the new object."> - +for the new object. + - + transfer-ownership="none"> + Time, in milliseconds, after which a tooltip could appear if the +cursor is hovering on top of a widget. + - + transfer-ownership="none"> + When %TRUE, there are no motion notify events delivered on this screen, +and widgets can't use the pointer hovering them for any essential +functionality. + - - + + - - + + - - + + - - + + - - + + @@ -50829,7 +45156,9 @@ functionality."> - + @@ -50861,198 +45190,133 @@ functionality."> c:identifier="GTK_SHADOW_ETCHED_OUT" glib:nick="etched-out"/> - - - - - - - - - - - - - - - - - - - - + + Create a new #GtkSizeGroup. + a newly created #GtkSizeGroup + the mode for the new size group. - + + Adds a widget to a #GtkSizeGroup. In the future, the requisition +of the widget will be determined as the maximum of its requisition +and the requisition of the other widgets in the size group. +Whether this applies horizontally, vertically, or in both directions +depends on the mode of the size group. See gtk_size_group_set_mode(). +When the widget is destroyed or no longer referenced elsewhere, it will +be removed from the size group. - - - - - - - - - - - - - - - - - + + the #GtkWidget to add + + Returns if invisible widgets are ignored when calculating the size. - + %TRUE if invisible widgets are ignored. + - + + Gets the current mode of the size group. See gtk_size_group_set_mode(). - + the current mode of the size group. + - - - - - - - - - - - - - - - - + Returns the list of widgets associated with @size_group. +widgets. The list is owned by GTK+ and should not be modified. + + a #GSList of + + Removes a widget from a #GtkSizeGroup. + + + + + + the #GtkWidget to remove + + + + + + Sets whether unmapped widgets should be ignored when +calculating the size. + + + + + + whether unmapped widgets should be ignored when calculating the size + + + + + + Sets the #GtkSizeGroupMode of the size group. The mode of the size +group determines whether the widgets in the size group should +all have the same horizontal requisition (%GTK_SIZE_GROUP_MODE_HORIZONTAL) +all have the same vertical requisition (%GTK_SIZE_GROUP_MODE_VERTICAL), +or should all have the same requisition in both directions +(%GTK_SIZE_GROUP_MODE_BOTH). + + + + + + the mode to set for the size group. + + + + - + transfer-ownership="none"> + If %TRUE, unmapped widgets are ignored when determining +the size of the group. + - - + + - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + @@ -51091,11 +45355,11 @@ the size of the group."> + The mode of the size group determines the directions in which the size +group affects the requested sizes of its component widgets. + + + + + + Retrieves a widget's initial minimum and natural height. +<note><para>This call is specific to width-for-height requests.</para></note> +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + location to store the minimum height, or %NULL + + + + location to store the natural height, or %NULL + + + + + + Retrieves a widget's minimum and natural height if it would be given +the specified @width. +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + the width which is available for allocation + + + + location for storing the minimum height, or %NULL + + + + location for storing the natural height, or %NULL + + + + + + Gets whether the widget prefers a height-for-width layout +or a width-for-height layout. +<note><para>#GtkBin widgets generally propagate the preference of +their child, container widgets need to request something either in +context of their children or in context of their allocation +capabilities.</para></note> + + The #GtkSizeRequestMode preferred by @widget. + + + + + Retrieves a widget's initial minimum and natural width. +<note><para>This call is specific to height-for-width +requests.</para></note> +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + location to store the minimum width, or %NULL + + + + location to store the natural width, or %NULL + + + + + + Retrieves a widget's minimum and natural width if it would be given +the specified @height. +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + the height which is available for allocation + + + + location for storing the minimum width, or %NULL + + + + location for storing the natural width, or %NULL + + + + + + Retrieves a widget's initial minimum and natural height. +<note><para>This call is specific to width-for-height requests.</para></note> +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + location to store the minimum height, or %NULL + + + + location to store the natural height, or %NULL + + + + + + Retrieves a widget's minimum and natural height if it would be given +the specified @width. +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + the width which is available for allocation + + + + location for storing the minimum height, or %NULL + + + + location for storing the natural height, or %NULL + + + + + + Gets whether the widget prefers a height-for-width layout +or a width-for-height layout. +<note><para>#GtkBin widgets generally propagate the preference of +their child, container widgets need to request something either in +context of their children or in context of their allocation +capabilities.</para></note> + + The #GtkSizeRequestMode preferred by @widget. + + + + + Retrieves the minimum and natural size of a widget taking +into account the widget's preference for height-for-width management. +This is used to retrieve a suitable size by container widgets which do +not impose any restrictions on the child placement. + + + + + + location for storing the minimum size, or %NULL + + + + location for storing the natural size, or %NULL + + + + + + Retrieves a widget's initial minimum and natural width. +<note><para>This call is specific to height-for-width +requests.</para></note> +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + location to store the minimum width, or %NULL + + + + location to store the natural width, or %NULL + + + + + + Retrieves a widget's minimum and natural width if it would be given +the specified @height. +The returned request will be modified by the +GtkWidgetClass::adjust_size_request virtual method and by any +#GtkSizeGroup that have been applied. That is, the returned request +is the one that should be used for layout, not necessarily the one +returned by the widget itself. + + + + + + the height which is available for allocation + + + + location for storing the minimum width, or %NULL + + + + location for storing the natural width, or %NULL + + + + + + + + + + + + + The #GtkSizeRequestMode preferred by @widget. + + + + + + + + + + + + + + + + + + + + location to store the minimum height, or %NULL + + + + location to store the natural height, or %NULL + + + + + + + + + + + + + + + + the height which is available for allocation + + + + location for storing the minimum width, or %NULL + + + + location for storing the natural width, or %NULL + + + + + + + + + + + + + + + + location to store the minimum width, or %NULL + + + + location to store the natural width, or %NULL + + + + + + + + + + + + + + + + the width which is available for allocation + + + + location for storing the minimum height, or %NULL + + + + location for storing the natural height, or %NULL + + + + + + + + Specifies a preference for height-for-width or +width-for-height geometry management. + + + - - - + + + Create a new empty #GtkSocket. + + the new #GtkSocket. + - + Adds an XEMBED client, such as a #GtkPlug, to the #GtkSocket. The +client may be in the same process or in a different process. To embed a #GtkPlug in a #GtkSocket, you can either create the -#GtkPlug with <literal>gtk_plug_new (0)</literal>, call +#GtkPlug with <literal>gtk_plug_new (0)</literal>, call gtk_plug_get_id() to get the window ID of the plug, and then pass that to the gtk_socket_add_id(), or you can call gtk_socket_get_id() to get the window ID for the socket, and call gtk_plug_new() passing in that ID. The #GtkSocket must have already be added into a toplevel window -before you can make this call."> +before you can make this call. + the window ID of a client participating in the XEMBED protocol. - + Gets the window ID of a #GtkSocket widget, which can then be used to create a client embedded inside the socket, for -instance with gtk_plug_new(). -The #GtkSocket must have already be added into a toplevel window -before you can make this call."> - +instance with gtk_plug_new(). +The #GtkSocket must have already be added into a toplevel window +before you can make this call. + + the window ID for the socket - + Retrieves the window of the plug. Use this to check if the plug has +been created inside of the socket. + + the window of the plug if available, or %NULL - - - - - - - - - - - + - + - + - + @@ -51208,25 +45950,25 @@ before you can make this call."> - + - + - + - + - + - + - + @@ -51234,19 +45976,20 @@ before you can make this call."> - - - + + This signal is emitted when a client is successfully +added to the socket. + + - - - + + This signal is emitted when a client is removed from the socket. +The default action is to destroy the #GtkSocket widget, so if you +want to reuse it you must add a signal handler that returns %TRUE. + + %TRUE to stop other handlers from being invoked. + @@ -51257,7 +46000,7 @@ want to reuse it you must add a signal handler that returns %TRUE."> - + @@ -51269,9 +46012,9 @@ want to reuse it you must add a signal handler that returns %TRUE."> - + - + @@ -51280,29 +46023,29 @@ want to reuse it you must add a signal handler that returns %TRUE."> - - + + - - + + - - + + - - + + @@ -51323,6 +46066,7 @@ want to reuse it you must add a signal handler that returns %TRUE."> glib:nick="descending"/> + - - + + - + - + + This is a convenience constructor that allows creation of a numeric +#GtkSpinButton without manually creating an adjustment. The value is initially set to the minimum value and a page increment of 10 * @step -is the default. The precision of the spin button is equivalent to the -precision of @step. -Note that the way in which the precision is derived works best if @step -is a power of ten. If the resulting precision is not suitable for your -needs, use gtk_spin_button_set_digits() to correct it."> - - +is the default. The precision of the spin button is equivalent to the +precision of @step. +Note that the way in which the precision is derived works best if @step +is a power of ten. If the resulting precision is not suitable for your +needs, use gtk_spin_button_set_digits() to correct it. + + The new spin button as a #GtkWidget. + - + Minimum allowable value + - + Maximum allowable value + - + Increment added or subtracted by spinning the widget + - + + Changes the properties of an existing spin button. The adjustment, climb rate, +and number of decimal places are all changed accordingly, after this function call. + allow-none="1"> + a #GtkAdjustment. - + the new climb rate. + - + the number of decimal places to display in the spin button. + + + Get the adjustment associated with a #GtkSpinButton + + the #GtkAdjustment of @spin_button + + + + + Fetches the precision of @spin_button. See gtk_spin_button_set_digits(). + + the current precision + + + + + Gets the current step and page the increments used by @spin_button. See +gtk_spin_button_set_increments(). + + + + + + location to store step increment, or %NULL + + + + location to store page increment, or %NULL + + + + + + Returns whether non-numeric text can be typed into the spin button. +See gtk_spin_button_set_numeric(). + + %TRUE if only numeric text can be entered + + + + + Gets the range allowed for @spin_button. See +gtk_spin_button_set_range(). + + + + + + location to store minimum allowed value, or %NULL + + + + location to store maximum allowed value, or %NULL + + + + + + Returns whether the values are corrected to the nearest step. See +gtk_spin_button_set_snap_to_ticks(). + + %TRUE if values are snapped to the nearest step. + + + + + Gets the update behavior of a spin button. See +gtk_spin_button_set_update_policy(). + + the current update policy + + + + + Get the value in the @spin_button. + + the value of @spin_button + + + + + Get the value @spin_button represented as an integer. + + the value of @spin_button + + + + + Returns whether the spin button's value wraps around to the +opposite limit when the upper or lower limit of the range is +exceeded. See gtk_spin_button_set_wrap(). + + %TRUE if the spin button wraps around + + + + c:identifier="gtk_spin_button_set_adjustment"> + Replaces the #GtkAdjustment associated with @spin_button. + a #GtkAdjustment to replace the existing adjustment - - - - - - + + Set the precision to be displayed by @spin_button. Up to 20 digit precision +is allowed. - + the number of digits after the decimal point to be displayed for the spin button's value + - - - - - + c:identifier="gtk_spin_button_set_increments"> + Sets the step and page increments for spin_button. This affects how +quickly the value changes when the spin button's arrows are activated. - + increment applied for a button 1 press. + - + increment applied for a button 2 press. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the flag that determines if non-numeric text can be typed into +the spin button. - + flag indicating if only numeric entry is allowed. + - - - - - - + + Sets the minimum and maximum allowable values for @spin_button - - + + minimum allowable value + - - + + maximum allowable value + - - - - - - - - - - - - - - - + c:identifier="gtk_spin_button_set_snap_to_ticks"> + Sets the policy as to whether values are corrected to the nearest step +increment when a spin button is activated after providing an invalid value. - + a flag indicating if invalid values should be corrected. + - + + Sets the update behavior of a spin button. This determines whether the +spin button is always updated or only when a valid value is set. - + + + + a #GtkSpinButtonUpdatePolicy value + + + - + + Set the value of @spin_button. + + + + + + the new value + + + + + + Sets the flag that determines if a spin button value wraps around to the +opposite limit when the upper or lower limit of the range is exceeded. + + + + + + a flag indicating if wrapping behavior is performed. + + + + + + Increment or decrement a spin button's value in a specified direction +by a specified amount. + + + + + + a #GtkSpinType indicating the direction to spin. + + + + step increment to apply in the specified direction. + + + + + + Manually force an update of the spin button. - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - - + + - + - + The ::output signal can be used to change to formatting of the value that is displayed in the spin buttons entry. |[ /&ast; show leading zeros &ast;/ @@ -51757,27 +46460,27 @@ gchar *text; int value; adj = gtk_spin_button_get_adjustment (spin); value = (int)gtk_adjustment_get_value (adj); -text = g_strdup_printf ("%02d", value); +text = g_strdup_printf ("%02d", value); gtk_entry_set_text (GTK_ENTRY (spin), text); g_free (text); return TRUE; } -]|"> - - +]| + + %TRUE if the value has been displayed. + - - + + - - - + + The wrapped signal is emitted right after the spinbutton wraps +from its maximum to minimum value or vice-versa. + + @@ -51788,26 +46491,24 @@ from its maximum to minimum value or vice-versa." - + - + - - + + - + - + @@ -51817,7 +46518,7 @@ from its maximum to minimum value or vice-versa." - + @@ -51829,7 +46530,7 @@ from its maximum to minimum value or vice-versa." - + @@ -51844,7 +46545,7 @@ from its maximum to minimum value or vice-versa." - + @@ -51855,28 +46556,32 @@ from its maximum to minimum value or vice-versa." - - + + - - + + - - + + + + - - - + + + Returns a new spinner widget. Not yet started. + + a new #GtkSpinner + - + + Starts the animation of the spinner. - + + Stops the animation of the spinner. - - + + - + - + @@ -51969,10 +46671,10 @@ from its maximum to minimum value or vice-versa." c:type="GtkSpinnerClass" glib:is-gtype-struct-for="Spinner"> - + - + + Creates an empty status icon object. + a new #GtkStatusIcon - - - - - - - - - - + Creates a status icon displaying the file @filename. +The image will be scaled down to fit in the available +space in the notification area, if necessary. + a new #GtkStatusIcon - - - - - - - - - - - - - - - - - - - - + a filename + Creates a status icon displaying a #GIcon. If the icon is a +themed icon, it will be updated when the theme changes. + a new #GtkStatusIcon + a #GIcon + + Creates a status icon displaying an icon from the current icon theme. +If the current icon theme is changed, the icon will be updated +appropriately. + + a new #GtkStatusIcon + + + + + an icon name + + + + + + Creates a status icon displaying @pixbuf. +The image will be scaled down to fit in the available +space in the notification area, if necessary. + + a new #GtkStatusIcon + + + + + a #GdkPixbuf + + + + + + Creates a status icon displaying a stock icon. Sample stock icon +names are #GTK_STOCK_OPEN, #GTK_STOCK_QUIT. You can register your +own stock icon names, see gtk_icon_factory_add_default() and +gtk_icon_factory_add(). + + a new #GtkStatusIcon + + + + + a stock icon id + + + + + Menu positioning function to use with gtk_menu_popup() +to position @menu aligned to the status icon @user_data. + the #GtkMenu - - + + return location for the x position + - - + + return location for the y position + - - + + whether the first menu item should be offset (pushed in) to be aligned with the menu popup position (only useful for GtkOptionMenu). + - + the status icon to position the menu on + - + Obtains information about the location of the status icon +on screen. This information can be used to e.g. position +popups like notification bubbles. +See gtk_status_icon_position_menu() for a more convenient +alternative for positioning menus. +Note that some platforms do not allow GTK+ to provide +this information, and even on platforms that do allow it, +the information is not reliable unless the status icon +is embedded in a notification area, see +gtk_status_icon_is_embedded(). +been filled in - + %TRUE if the location information has + - - + allow-none="1"> + return location for the screen, or %NULL if the information is not needed + + + + return location for the area occupied by the status icon, or %NULL + + + + return location for the orientation of the panel in which the status icon is embedded, or %NULL. A panel at the top or bottom of the screen is horizontal, a panel at the left or right is vertical. + + + Retrieves the #GIcon being displayed by the #GtkStatusIcon. +The storage type of the status icon must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_GICON (see gtk_status_icon_get_storage_type()). +The caller of this function does not own a reference to the +returned #GIcon. +If this function fails, @icon is left unchanged; + + the displayed icon, or %NULL if the image is empty + + + + + Returns the current value of the has-tooltip property. +See #GtkStatusIcon:has-tooltip for more information. + + current value of has-tooltip on @status_icon. + + + + + Gets the name of the icon being displayed by the #GtkStatusIcon. +The storage type of the status icon must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_ICON_NAME (see gtk_status_icon_get_storage_type()). +The returned string is owned by the #GtkStatusIcon and should not +be freed or modified. + + name of the displayed icon, or %NULL if the image is empty. + + + + + Gets the #GdkPixbuf being displayed by the #GtkStatusIcon. +The storage type of the status icon must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_PIXBUF (see gtk_status_icon_get_storage_type()). +The caller of this function does not own a reference to the +returned pixbuf. +or %NULL if the image is empty. + + the displayed pixbuf, + + + + + Returns the #GdkScreen associated with @status_icon. + + a #GdkScreen. + + + + + Gets the size in pixels that is available for the image. +Stock icons and named icons adapt their size automatically +if the size of the notification area changes. For other +storage types, the size-changed signal can be used to +react to size changes. +Note that the returned size is only meaningful while the +status icon is embedded (see gtk_status_icon_is_embedded()). + + the size that is available for the image + + + + + Gets the id of the stock icon being displayed by the #GtkStatusIcon. +The storage type of the status icon must be %GTK_IMAGE_EMPTY or +%GTK_IMAGE_STOCK (see gtk_status_icon_get_storage_type()). +The returned string is owned by the #GtkStatusIcon and should not +be freed or modified. +or %NULL if the image is empty. + + stock id of the displayed stock icon, + + + + + Gets the type of representation being used by the #GtkStatusIcon +to store image data. If the #GtkStatusIcon has no image data, +the return value will be %GTK_IMAGE_EMPTY. + + the image representation being used + + + + + Gets the title of this tray icon. See gtk_status_icon_set_title(). + + the title of the status icon + + + + + Gets the contents of the tooltip for @status_icon. +returned string with g_free() when done. + + the tooltip text, or %NULL. You should free the + + + + + Gets the contents of the tooltip for @status_icon. +returned string with g_free() when done. + + the tooltip text, or %NULL. You should free the + + + + + Returns whether the status icon is visible or not. +Note that being visible does not guarantee that +the user can actually see the icon, see also +gtk_status_icon_is_embedded(). + + %TRUE if the status icon is visible + + + + + This function is only useful on the X11/freedesktop.org platform. +It returns a window ID for the widget in the underlying +status icon implementation. This is useful for the Galago +notification service, which can send a window ID in the protocol +in order for the server to position notification windows +pointing to a status icon reliably. +This function is not intended for other use cases which are +more likely to be met by one of the non-X11 specific methods, such +as gtk_status_icon_position_menu(). +underlying X11 Window + + An 32 bit unsigned integer identifier for the + + + + + Returns whether the status icon is embedded in a notification +area. +a notification area. + + %TRUE if the status icon is embedded in + + + + version="2.10 "> + Makes @status_icon display the file @filename. +See gtk_status_icon_new_from_file() for details. - - - - - - - - - - - - - - - - - - - - + a filename + Makes @status_icon display the #GIcon. +See gtk_status_icon_new_from_gicon() for details. + a GIcon - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Makes @status_icon display the icon named @icon_name from the +current icon theme. +See gtk_status_icon_new_from_icon_name() for details. - - + + an icon name + - - - - - - + + Makes @status_icon display @pixbuf. +See gtk_status_icon_new_from_pixbuf() for details. - + + a #GdkPixbuf or %NULL + + + + + + Makes @status_icon display the stock icon with the id @stock_id. +See gtk_status_icon_new_from_stock() for details. + + + + + + a stock icon id + Sets the has-tooltip property on @status_icon to @has_tooltip. +See #GtkStatusIcon:has-tooltip for more information. - + whether or not @status_icon has a tooltip + - + + Sets the name of this tray icon. +This should be a string identifying this icon. It is may be +used for sorting the icons in the tray and will not be shown to +the user. - + + the name + + + + + + Sets the #GdkScreen where @status_icon is displayed; if +the icon is already mapped, it will be unmapped, and +then remapped on the new screen. + + + + + + a #GdkScreen + + + + + + Sets the title of this tray icon. +This should be a short, human-readable, localized string +describing the tray icon. It may be used by tools like screen +readers to render the tray icon. + + + + + + the title + Sets @markup as the contents of the tooltip, which is marked up with +the <link linkend="PangoMarkupFormat">Pango text markup language</link>. This function will take care of setting #GtkStatusIcon:has-tooltip to %TRUE and of the default handler for the #GtkStatusIcon::query-tooltip signal. See also the #GtkStatusIcon:tooltip-markup property and -gtk_tooltip_set_markup()." +gtk_tooltip_set_markup(). + + + + + + the contents of the tooltip for @status_icon, or %NULL + + + + + + Sets @text as the contents of the tooltip. +This function will take care of setting #GtkStatusIcon:has-tooltip to +%TRUE and of the default handler for the #GtkStatusIcon::query-tooltip +signal. +See also the #GtkStatusIcon:tooltip-text property and +gtk_tooltip_set_text(). - - - - - - - - - - - - - - - - - - - - - - - - - - + + the contents of the tooltip for @status_icon + Shows or hides a status icon. - + %TRUE to show the status icon, %FALSE to hide it + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + %TRUE if the statusicon is embedded in a notification area. + - - - - - + + - + transfer-ownership="none"> + The #GIcon displayed in the #GtkStatusIcon. For themed icons, +the image will be updated automatically if the theme changes. + + Enables or disables the emission of #GtkStatusIcon::query-tooltip on tooltip, in this case the status icon will be queried using #GtkStatusIcon::query-tooltip to determine whether it will provide a tooltip or not. @@ -52576,59 +47272,61 @@ the event masks of the windows of this status icon to include leave-notify and motion-notify events. This will not be undone when the property is set to %FALSE again. Whether this property is respected is platform dependent. -For plain text tooltips, use #GtkStatusIcon:tooltip-text in preference."> - +For plain text tooltips, use #GtkStatusIcon:tooltip-text in preference. + - - + + - - + + The orientation of the tray in which the statusicon +is embedded. + - - + + - - + + - - + + - - + + - - + + + The title of this tray icon. This should be a short, human-readable, localized string describing the tray icon. It may be used by tools -like screen readers to render the tray icon."> - +like screen readers to render the tray icon. + + Sets the text of tooltip to be the given string, which is marked up +with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. Also see gtk_tooltip_set_markup(). This is a convenience property which will take care of getting the tooltip shown if the given string is not %NULL. #GtkStatusIcon:has-tooltip will automatically be set to %TRUE and the default handler for the #GtkStatusIcon::query-tooltip signal will take care of displaying the tooltip. -On some platforms, embedded markup will be ignored."> - +On some platforms, embedded markup will be ignored. + + Sets the text of tooltip to be the given string. Also see gtk_tooltip_set_text(). This is a convenience property which will take care of getting the tooltip shown if the given string is not %NULL. @@ -52637,11 +47335,11 @@ the default handler for the #GtkStatusIcon::query-tooltip signal will take care of displaying the tooltip. Note that some platforms have limitations on the length of tooltips that they allow on status icons, e.g. Windows only shows the first -64 characters."> - +64 characters. + - - + + @@ -52649,75 +47347,73 @@ that they allow on status icons, e.g. Windows only shows the first - + Gets emitted when the user activates the status icon. If and how status icons can activated is platform-dependent. -Unlike most G_SIGNAL_ACTION signals, this signal is meant to -be used by applications and should be wrapped by language bindings." - version="2.10"> - - +Unlike most G_SIGNAL_ACTION signals, this signal is meant to +be used by applications and should be wrapped by language bindings. + + - + The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed. Whether this event is emitted is platform-dependent. Use the ::activate and ::popup-menu signals in preference. -for the event. %FALSE to propagate the event further." - version="2.14"> - - +for the event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked + - - + + the #GdkEventButton which triggered this signal + - + The ::button-release-event signal will be emitted when a button (typically from a mouse) is released. Whether this event is emitted is platform-dependent. Use the ::activate and ::popup-menu signals in preference. -for the event. %FALSE to propagate the event further." - version="2.14"> - - +for the event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked + - - + + the #GdkEventButton which triggered this signal + - + Gets emitted when the user brings up the context menu +of the status icon. Whether status icons can have context menus and how these are activated is platform-dependent. -The @button and @activate_time parameters should be +The @button and @activate_time parameters should be passed as the last to arguments to gtk_menu_popup(). -Unlike most G_SIGNAL_ACTION signals, this signal is meant to -be used by applications and should be wrapped by language bindings." - version="2.10"> - - +Unlike most G_SIGNAL_ACTION signals, this signal is meant to +be used by applications and should be wrapped by language bindings. + + - - + + the button that was pressed, or 0 if the signal is not emitted in response to a button press event + - - + + the timestamp of the event that triggered the signal emission + - + Emitted when the #GtkSettings:gtk-tooltip-timeout has expired with the cursor hovering above @status_icon; or emitted when @status_icon got focus in keyboard mode. Using the given coordinates, the signal handler should determine @@ -52727,52 +47423,59 @@ should not be used. The signal handler is free to manipulate @tooltip with the therefore destined function calls. Whether this signal is emitted is platform-dependent. -For plain text tooltips, use #GtkStatusIcon:tooltip-text in preference." - version="2.16"> - - +For plain text tooltips, use #GtkStatusIcon:tooltip-text in preference. + + %TRUE if @tooltip should be shown right now, %FALSE otherwise. + - - + + the x coordinate of the cursor position where the request has been emitted, relative to @status_icon + - - + + the y coordinate of the cursor position where the request has been emitted, relative to @status_icon + - - + + %TRUE if the tooltip was trigged using the keyboard + - - + + a #GtkTooltip + - + The ::scroll-event signal is emitted when a button in the 4 to 7 range is pressed. Wheel mice are usually configured to generate button press events for buttons 4 and 5 when the wheel is turned. Whether this event is emitted is platform-dependent. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventScroll which triggered this signal + - + Gets emitted when the size available for the image changes, e.g. because the notification area got resized. -size. Otherwise, GTK+ will scale the icon as necessary." - version="2.10"> - - +size. Otherwise, GTK+ will scale the icon as necessary. + + %TRUE if the icon was updated for the new + - - + + the new size + @@ -52784,7 +47487,7 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + @@ -52796,7 +47499,7 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + @@ -52805,33 +47508,33 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + - + - + - + - + - + - + @@ -52844,9 +47547,9 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + - + @@ -52859,9 +47562,9 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + - + @@ -52874,22 +47577,22 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + - + - + - + - + @@ -52898,15 +47601,18 @@ size. Otherwise, GTK+ will scale the icon as necessary." - + - + - + - - - + + + Creates a new #GtkStatusbar ready for messages. + + the new #GtkStatusbar + + c:identifier="gtk_statusbar_get_context_id"> + Returns a new context identifier, given a description +of the actual context. Note that the description is +<emphasis>not</emphasis> shown in the UI. - + an integer id + + textual description of what context the new message is being used in - + + Returns whether the statusbar has a resize grip. - + %TRUE if the statusbar has a resize grip. + + + + + Retrieves the box containing the label widget. + + a #GtkBox + + + + + Removes the first message in the #GtkStatusBar's stack +with the given context id. +Note that this may not change the displayed message, if +the message at the top of the stack has a different +context id. + + - + a context identifier + + + + + + Pushes a new message onto a statusbar's stack. +gtk_statusbar_remove(). + + a message id that can be used with + + + + + the message's context id, as returned by gtk_statusbar_get_context_id() + + the message to add to the statusbar - + + Forces the removal of a message from a statusbar's stack. +The exact @context_id and @message_id must be specified. - + a context identifier + + + + a message identifier, as returned by gtk_statusbar_push() + - + + Forces the removal of all messages from a statusbar's +stack with the exact @context_id. - - - - + a context identifier + + c:identifier="gtk_statusbar_set_has_resize_grip"> + Sets whether the statusbar has a resize grip. +%TRUE by default. - + %TRUE to have a resize grip + - - - - - - - - - - - + transfer-ownership="none"> + Whether the statusbar has a grip for resizing the toplevel window. + - - + + - - - - - - - - - - - - - - - - - - - - - - - - + + Is emitted whenever a new message is popped off a statusbar's stack. + + - - + + the context id of the relevant message/statusbar. + - - + + the message that was just popped. + - - + + - + - + @@ -53082,10 +47792,10 @@ The exact @context_id and @message_id must be specified."> - + - + @@ -53094,7 +47804,7 @@ The exact @context_id and @message_id must be specified."> - + @@ -53103,7 +47813,7 @@ The exact @context_id and @message_id must be specified."> - + @@ -53112,7 +47822,7 @@ The exact @context_id and @message_id must be specified."> - + @@ -53120,35 +47830,37 @@ The exact @context_id and @message_id must be specified."> - - + + - - + + - - + + - - + + + + @@ -53160,41 +47872,48 @@ The exact @context_id and @message_id must be specified."> - + - + introspectable="0"> + Copies a stock item, mostly useful for language bindings and not in applications. + + a new #GtkStockItem - + Frees a stock item allocated on the heap, such as one returned by gtk_stock_item_copy(). Also frees the fields inside the stock item, -if they are not %NULL."> +if they are not %NULL. - + + Creates a new #GtkStyle. + a new #GtkStyle. + + + + + @@ -53205,192 +47924,6 @@ if they are not %NULL."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -53418,87 +47951,19 @@ if they are not %NULL."> - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -53526,210 +47991,16 @@ if they are not %NULL."> - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -53757,25 +48028,130 @@ if they are not %NULL."> - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -53803,22 +48179,59 @@ if they are not %NULL."> - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -53840,56 +48253,16 @@ if they are not %NULL."> - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -53917,23 +48290,23 @@ if they are not %NULL."> - + - + - + - + - + @@ -53953,14 +48326,14 @@ if they are not %NULL."> - - + + + + + - - - - + @@ -53976,7 +48349,7 @@ if they are not %NULL."> - + @@ -53988,16 +48361,53 @@ if they are not %NULL."> - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -54022,16 +48432,139 @@ if they are not %NULL."> - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -54056,112 +48589,23 @@ if they are not %NULL."> - + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -54172,8 +48616,126 @@ specified by @style for the given state."> + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Renders the icon specified by @source at the given @size +according to the given parameters and returns the result in a +pixbuf. +containing the rendered icon + + a newly-created #GdkPixbuf + + + + + the #GtkIconSource specifying the icon to render + + + + a text direction + + + + a state + + + + the size to render the icon at. A size of (GtkIconSize)-1 means render at the size of the source and don't scale. + + + + the widget + + + + a style detail + + + + + + Sets the background of @window to the background color or pixmap +specified by @style for the given state. + + + + + + a #GdkWindow + + + + a state + + + + @@ -54184,7 +48746,7 @@ specified by @style for the given state."> - + @@ -54193,127 +48755,72 @@ specified by @style for the given state."> - + - + - + - + - + + Attaches a style to a window; this process allocates the +colors and creates the GC's for the style - it specializes +it to a particular visual and colormap. The process may +involve the creation of a new style if the style has already +been attached to a window with a different style and colormap. +Since this function may return a new object, you have to use it +in the following way: +<literal>style = gtk_style_attach (style, window)</literal> +If the style is newly created, the style parameter +will be unref'ed, and the new style will have +a reference count belonging to the caller. + + Either @style, or a newly-created #GtkStyle. + + + + + a #GdkWindow. + + + + + + Creates a copy of the passed in #GtkStyle object. - + a copy of @style + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Detaches a style from a window. If the style is not attached +to any windows anymore, it is unrealized. See gtk_style_attach(). - - - - - - - - - - - + version="2.16" + introspectable="0"> + Gets the values of a multiple style properties for @widget_type +from @style. + the #GType of a descendant of #GtkWidget + the name of the first style property to get @@ -54322,47 +48829,185 @@ from @style." + + Queries the value of a style property corresponding to a +widget class is in the given style. + + + + + + the #GType of a descendant of #GtkWidget + + + + the name of the style property to get + + + + a #GValue where the value of the property being queried will be stored + + + + + + Non-vararg variant of gtk_style_get(). +Used primarily by language bindings. + + + + + + the #GType of a descendant of #GtkWidget + + + + the name of the first style property to get + + + + a <type>va_list</type> of pairs of property names and locations to return the property values, starting with the location for @first_property_name. + + + + + + Looks up @color_name in the style's logical color mappings, +filling in @color and returning %TRUE if found, otherwise +returning %FALSE. Do not cache the found mapping, because +it depends on the #GtkStyle and might change when a theme +switch occurs. + + %TRUE if the mapping was found. + + + + + the name of the logical color to look up + + + + the #GdkColor to fill in + + + + + + Looks up @stock_id in the icon factories associated with @style +and the default icon factory, returning an icon set if found, +otherwise %NULL. + + icon set of @stock_id + + + + + an icon name + + + + + + Renders the icon specified by @source at the given @size +according to the given parameters and returns the result in a +pixbuf. +containing the rendered icon + + a newly-created #GdkPixbuf + + + + + the #GtkIconSource specifying the icon to render + + + + a text direction + + + + a state + + + + the size to render the icon at. A size of (GtkIconSize)-1 means render at the size of the source and don't scale. + + + + the widget + + + + a style detail + + + + + + Sets the background of @window to the background color or pixmap +specified by @style for the given state. + + + + + + a #GdkWindow + + + + a state + + + + - + - + - + - + - + - + - + - + @@ -54375,74 +49020,25 @@ from @style." - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - + + - + - + - - - @@ -54450,32 +49046,36 @@ from @style." - + + + - + + + - + + + - + Emitted when the style has been initialized for a particular colormap and depth. Connecting to this signal is probably seldom useful since most of the time applications and widgets only -deal with styles that have been already realized." - version="2.4"> - - +deal with styles that have been already realized. + + - + Emitted when the aspects of the style specific to a particular colormap and depth are being cleaned up. A connection to this signal can be useful -if a widget wants to cache objects like a #GdkGC as object data on #GtkStyle. -This signal provides a convenient place to free such cached objects." - version="2.4"> - - +if a widget wants to cache objects as object data on #GtkStyle. +This signal provides a convenient place to free such cached objects. + + @@ -54486,7 +49086,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -54498,7 +49098,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -54510,7 +49110,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -54524,9 +49124,9 @@ This signal provides a convenient place to free such cached objects." - - - + + + @@ -54537,7 +49137,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -54552,7 +49152,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -54561,17 +49161,20 @@ This signal provides a convenient place to free such cached objects." + a #GdkWindow + a state - + + a newly-created #GdkPixbuf @@ -54579,28 +49182,34 @@ This signal provides a convenient place to free such cached objects." + the #GtkIconSource specifying the icon to render + a text direction + a state - + the size to render the icon at. A size of (GtkIconSize)-1 means render at the size of the source and don't scale. + - + + the widget - + + a style detail - + @@ -54624,19 +49233,19 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -54660,19 +49269,19 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -54699,61 +49308,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -54783,25 +49353,25 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + - + @@ -54828,58 +49398,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -54906,22 +49440,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -54948,22 +49482,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -54990,22 +49524,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -55032,22 +49566,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -55074,22 +49608,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -55116,31 +49650,31 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + - + - + @@ -55167,31 +49701,31 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + - + - + @@ -55218,16 +49752,16 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -55236,7 +49770,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55260,22 +49794,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -55302,16 +49836,16 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -55320,7 +49854,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55347,16 +49881,16 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -55365,7 +49899,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55389,10 +49923,10 @@ This signal provides a convenient place to free such cached objects." - + - + @@ -55401,7 +49935,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55416,7 +49950,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55428,10 +49962,10 @@ This signal provides a convenient place to free such cached objects." - + - + @@ -55440,7 +49974,7 @@ This signal provides a convenient place to free such cached objects." - + @@ -55467,22 +50001,22 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + @@ -55506,134 +50040,106 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - + + - - + + - + - + - + - - - - - - - - - - - - - @@ -55679,16 +50173,16 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + @@ -55697,10 +50191,10 @@ This signal provides a convenient place to free such cached objects." - + - + @@ -55713,42 +50207,109 @@ This signal provides a convenient place to free such cached objects." - + - + - + - + - + + Gets the amount of space between column @col, and +column @col + 1. See gtk_table_set_col_spacing(). + + the column spacing + + + + + a column in the table, 0 indicates the first column + + + + + + Gets the default column spacing for the table. This is +the spacing that will be used for newly added columns. +(See gtk_table_set_col_spacings()) + + the default column spacing + + + + + Gets the default row spacing for the table. This is +the spacing that will be used for newly added rows. +(See gtk_table_set_row_spacings()) + + the default row spacing + + + + + Returns whether the table cells are all constrained to the same +width and height. (See gtk_table_set_homogenous ()) + + %TRUE if the cells are all constrained to the same size + + + + + Gets the amount of space between row @row, and +row @row + 1. See gtk_table_set_row_spacing(). + + the row spacing + + + + + a row in the table, 0 indicates the first row + + + + + + Returns the number of rows and columns in the table. - - + + return location for the number of rows, or %NULL + - - + + return location for the number of columns, or %NULL + - + - + - - + + + + + @@ -55758,23 +50319,44 @@ row @row + 1. See gtk_table_set_row_spacing()."> - + - + - + - + - - + + + + + + + + + + + + + + + + + + + + + + + + + @@ -55785,98 +50367,30 @@ column @col + 1. See gtk_table_set_col_spacing()."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - + + @@ -55884,40 +50398,40 @@ width and height. (See gtk_table_set_homogenous ())"> - + - + - + - + - + - + - + - + - + - + - + - + + + - + - + - + - + - + - + - + - + @@ -55958,10 +50474,10 @@ width and height. (See gtk_table_set_homogenous ())"> - + - + + glib:get-type="gtk_target_list_get_type" + c:symbol-prefix="target_list"> - + + + - + - + + Creates a new #GtkTargetList from an array of #GtkTargetEntry. + the new #GtkTargetList. + Pointer to an array of #GtkTargetEntry - + number of entries in @targets. + - - - - - - - - - - - + + Appends another target to a #GtkTargetList. + the interned atom representing the target - + the flags for this target + - - - - - - - - - - - - - - - - - - - - - - - - - - - + an ID that will be passed back to the application + + Appends the image targets supported by #GtkSelection to +the target list. All targets are added with the same @info. - + an ID that will be passed back to the application + - + whether to add only targets for which GTK+ knows how to convert a pixbuf into the format + - + + Appends the rich text targets registered with +gtk_text_buffer_register_serialize_format() or +gtk_text_buffer_register_deserialize_format() to the target list. All +targets are added with the same @info. - + an ID that will be passed back to the application + + + + if %TRUE, then deserializable rich text formats will be added, serializable formats otherwise. + + + + a #GtkTextBuffer. + - + + Prepends a table of #GtkTargetEntry to a target list. + the table of #GtkTargetEntry - + number of targets in the table + - + + Appends the text targets supported by #GtkSelection to +the target list. All targets are added with the same @info. + + + + + + an ID that will be passed back to the application + + + + + + Appends the URI targets supported by #GtkSelection to +the target list. All targets are added with the same @info. + + + + + + an ID that will be passed back to the application + + + + + + Looks up a given target in a #GtkTargetList. + + %TRUE if the target was found, otherwise %FALSE + + + + + an interned atom representing the target to search for + + + + a pointer to the location to store application info for target, or %NULL + + + + + + Increases the reference count of a #GtkTargetList by one. + + the passed in #GtkTargetList. + + + + + Removes a target from a target list. + the interned atom representing the target - + + Decreases the reference count of a #GtkTargetList by one. +If the resulting reference count is zero, frees the list. - + - - - - - - - - @@ -56161,31 +50690,34 @@ Looks up a given target in a #GtkTargetList."> - + - + - + + - - + + - - + + - - + + - - + + - - + + - - + + + + @@ -56230,60 +50766,47 @@ Looks up a given target in a #GtkTargetList."> - - - - - - - + - + - + - + - + - + - + - + - + - + - - - - - - - - - + + glib:get-type="gtk_text_attributes_get_type" + c:symbol-prefix="text_attributes"> - + @@ -56298,25 +50821,25 @@ Looks up a given target in a #GtkTargetList."> - + - + - + - + - + - + - + @@ -56331,1334 +50854,500 @@ Looks up a given target in a #GtkTargetList."> - + - + - - - - + - + - + - + - + - + + Creates a #GtkTextAttributes, which describes +a set of properties on some text. + a new #GtkTextAttributes - + + Copies @src and returns a new #GtkTextAttributes. + a copy of @src + c:identifier="gtk_text_attributes_copy_values"> + Copies the values from @src to @dest so that @dest has the same values +as @src. Frees existing values in @dest. + another #GtkTextAttributes - + + Increments the reference count on @values. + + the #GtkTextAttributes that were passed in + + + + + Decrements the reference count on @values, freeing the structure +if the reference count reaches 0. - - - - - - + - + + Creates a new text buffer. + a new text buffer - + + a tag table, or %NULL to create a new one - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds the mark at position @where. The mark must not be added to another buffer, and if its name is not %NULL then there must not be another mark in the buffer with the same name. -Emits the "mark-set" signal as notification of the mark's initial -placement." - version="2.12"> +Emits the "mark-set" signal as notification of the mark's initial +placement. + the mark to add + location to place mark - - - - - - - - - - - - - - - - - + + Adds @clipboard to the list of clipboards in which the selection +contents of @buffer are available. In most cases, @clipboard will be +the #GtkClipboard of type %GDK_SELECTION_PRIMARY for a view of @buffer. - - - - - + + a #GtkClipboard + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Emits the "apply-tag" signal on @buffer. The default +handler for the signal applies @tag to the given range. + a #GtkTextTag + one bound of range to be tagged + other bound of range to be tagged + c:identifier="gtk_text_buffer_apply_tag_by_name"> + Calls gtk_text_tag_table_lookup() on the buffer's tag table to +get a #GtkTextTag, then calls gtk_text_buffer_apply_tag(). + name of a named #GtkTextTag + one bound of range to be tagged + other bound of range to be tagged - + + Performs the appropriate action as if the user hit the delete +key with the cursor at the position specified by @iter. In the +normal case a single character will be deleted, but when +combining accents are involved, more than one character can +be deleted, and when precomposed character and accent combinations +are involved, less than one character will be deleted. +Because the buffer is modified, all outstanding iterators become +invalid after calling this function; however, the @iter will be +re-initialized to point to the location where text was deleted. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the buffer was modified + + a position in @buffer - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + whether the deletion is caused by user interaction + - + whether the buffer is editable by default + + Called to indicate that the buffer operations between here and a call to gtk_text_buffer_end_user_action() are part of a single user-visible operation. The operations between gtk_text_buffer_begin_user_action() and gtk_text_buffer_end_user_action() can then be grouped when creating an undo stack. #GtkTextBuffer maintains a count of calls to gtk_text_buffer_begin_user_action() that have not been closed with -a call to gtk_text_buffer_end_user_action(), and emits the -"begin-user-action" and "end-user-action" signals only for the -outermost pair of calls. This allows you to build user actions +a call to gtk_text_buffer_end_user_action(), and emits the +"begin-user-action" and "end-user-action" signals only for the +outermost pair of calls. This allows you to build user actions from other user actions. -The "interactive" buffer mutation functions, such as +The "interactive" buffer mutation functions, such as gtk_text_buffer_insert_interactive(), automatically call begin/end -user action around the buffer operations they perform, so there's +user action around the buffer operations they perform, so there's no need to add extra calls if you user action consists solely of a -single call to one of those functions."> +single call to one of those functions. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Copies the currently-selected text to a clipboard. + + the #GtkClipboard object to copy to + + + + + + This is a convenience function which simply creates a child anchor +with gtk_text_child_anchor_new() and inserts it into the buffer +with gtk_text_buffer_insert_child_anchor(). The new anchor is +owned by the buffer; no reference count is returned to +the caller of gtk_text_buffer_create_child_anchor(). + + the created child anchor + + + + + location in the buffer + + + + + + Creates a mark at position @where. If @mark_name is %NULL, the mark +is anonymous; otherwise, the mark can be retrieved by name using +gtk_text_buffer_get_mark(). If a mark has left gravity, and text is +inserted at the mark's current location, the mark will be moved to +the left of the newly-inserted text. If the mark has right gravity +(@left_gravity = %FALSE), the mark will end up on the right of +newly-inserted text. The standard left-to-right cursor is a mark +with right gravity (when you type, the cursor stays on the right +side of the text you're typing). +The caller of this function does <emphasis>not</emphasis> own a +reference to the returned #GtkTextMark, so you can ignore the +return value if you like. Marks are owned by the buffer and go +away when the buffer does. +Emits the "mark-set" signal as notification of the mark's initial +placement. + + the new #GtkTextMark object + + + + + name for mark, or %NULL + + + + location to place mark + + + + whether the mark has left gravity + + + + + + Creates a tag and adds it to the tag table for @buffer. +Equivalent to calling gtk_text_tag_new() and then adding the +tag to the buffer's tag table. The returned tag is owned by +the buffer's tag table, so the ref count will be equal to one. +If @tag_name is %NULL, the tag is anonymous. +If @tag_name is non-%NULL, a tag called @tag_name must not already +exist in the tag table for this buffer. +The @first_property_name argument and subsequent arguments are a list +of properties to set on the tag, as with g_object_set(). + + a new tag + + + + + name of the new tag, or %NULL + + + + name of first property to set, or %NULL + + + + + + + + + + Copies the currently-selected text to a clipboard, then deletes +said text if it's editable. + + + + + + the #GtkClipboard object to cut to + + + + default editability of the buffer + + + + + + Deletes text between @start and @end. The order of @start and @end +is not actually relevant; gtk_text_buffer_delete() will reorder +them. This function actually emits the "delete-range" signal, and +the default handler of that signal deletes the text. Because the +buffer is modified, all outstanding iterators become invalid after +calling this function; however, the @start and @end will be +re-initialized to point to the location where text was deleted. + + + + + + a position in @buffer + + + + another position in @buffer + + + + + + Deletes all <emphasis>editable</emphasis> text in the given range. +Calls gtk_text_buffer_delete() for each editable sub-range of +[@start,@end). @start and @end are revalidated to point to +the location of the last deleted range, or left untouched if +no text was deleted. + + whether some text was actually deleted + + + + + start of range to delete + + + + end of range + + + + whether the buffer is editable by default + + + + + + Deletes @mark, so that it's no longer located anywhere in the +buffer. Removes the reference the buffer holds to the mark, so if +you haven't called g_object_ref() on the mark, it will be freed. Even +if the mark isn't freed, most operations on @mark become +invalid, until it gets added to a buffer again with +gtk_text_buffer_add_mark(). Use gtk_text_mark_get_deleted() to +find out if a mark has been removed from its buffer. +The "mark-deleted" signal will be emitted as notification after +the mark is deleted. + + + + + + a #GtkTextMark in @buffer + + + + + + Deletes the mark named @name; the mark must exist. See +gtk_text_buffer_delete_mark() for details. + + + + + + name of a mark in @buffer + + + + + + Deletes the range between the "insert" and "selection_bound" marks, +that is, the currently-selected text. If @interactive is %TRUE, +the editability of the selection will be considered (users can't delete +uneditable text). + + whether there was a non-empty selection to delete + + + + + whether the deletion is caused by user interaction + + + + whether the buffer is editable by default + + + + + + This function deserializes rich text in format @format and inserts +it at @iter. +gtk_text_buffer_register_deserialize_format() or +gtk_text_buffer_register_deserialize_tagset() beforehand. + + %TRUE on success, %FALSE otherwise. + + + + + the #GtkTextBuffer to deserialize into + + + the rich text format to use for deserializing + + insertion point for the deserialized text + + + + data to deserialize + + + + length of @data + + - + This functions returns the value set with +gtk_text_buffer_deserialize_set_can_create_tags() - + whether deserializing this format may create tags + + a #GdkAtom representing a registered rich text format + Use this function to allow a rich text deserialization function to create new tags in the receiving buffer. Note that using this function is almost always a bad idea, because the rich text functions you register should know how to map the rich text format @@ -57670,415 +51359,1415 @@ because that format is essentially a dump of the internal structure of the source buffer, including its tag names. You should allow creation of tags only if you know what you are doing, e.g. if you defined a tagset name for your application -suite's text buffers and you know that it's fine to receive new +suite's text buffers and you know that it's fine to receive new tags from these buffers, because you know that your application can -handle the newly created tags." - version="2.10"> +handle the newly created tags. + a #GdkAtom representing a registered rich text format - + whether deserializing this format may create tags + - + + Should be paired with a call to gtk_text_buffer_begin_user_action(). +See that function for a full explanation. - + + + + + Retrieves the first and last iterators in the buffer, i.e. the +entire buffer lies within the range [@start,@end). + + - - + + iterator to initialize with first position in the buffer + + + + iterator to initialize with the end iterator + + + + + + Gets the number of characters in the buffer; note that characters +and bytes are not the same, you can't e.g. expect the contents of +the buffer in string form to be this many bytes long. The character +count is cached, so this function is very fast. + + number of characters in the buffer + + + + + This function returns the list of targets this text buffer can +provide for copying and as DND source. The targets in the list are +added with %info values from the #GtkTextBufferTargetInfo enum, +using gtk_target_list_add_rich_text_targets() and +gtk_target_list_add_text_targets(). + + the #GtkTargetList + + + + + This function returns the rich text deserialize formats registered +with @buffer using gtk_text_buffer_register_deserialize_format() or +gtk_text_buffer_register_deserialize_tagset() +formats. + + an array of #GdkAtom<!-- -->s representing the registered + + + + + return location for the number of formats + + + + + + Initializes @iter with the "end iterator," one past the last valid +character in the text buffer. If dereferenced with +gtk_text_iter_get_char(), the end iterator has a character value of +0. The entire buffer lies in the range from the first position in +the buffer (call gtk_text_buffer_get_start_iter() to get +character position 0) to the end iterator. + + + + + + iterator to initialize + + + + + + Indicates whether the buffer has some text currently selected. + + %TRUE if the there is text selected + + + + + Returns the mark that represents the cursor (insertion point). +Equivalent to calling gtk_text_buffer_get_mark() to get the mark +named "insert", but very slightly more efficient, and involves less +typing. + + insertion point mark + + + + + Obtains the location of @anchor within @buffer. + + + + + + an iterator to be initialized + + + + a child anchor that appears in @buffer + + + + + + Initializes @iter to the start of the given line. + + + + + + iterator to initialize + + + + line number counting from 0 + + + + + + Obtains an iterator pointing to @byte_index within the given line. +beyond the end of the line. Note <emphasis>bytes</emphasis>, not +characters; UTF-8 may encode one character as multiple bytes. + + + + + + iterator to initialize + + + + line number counting from 0 + + + + byte index from start of line + + + + + + Obtains an iterator pointing to @char_offset within the given +line. The @char_offset must exist, offsets off the end of the line +are not allowed. Note <emphasis>characters</emphasis>, not bytes; +UTF-8 may encode one character as multiple bytes. + + + + + + iterator to initialize + + + + line number counting from 0 + + + + char offset from start of line + + + + + + Initializes @iter with the current position of @mark. + + + + + + iterator to initialize + + + + a #GtkTextMark in @buffer + + + + + + Initializes @iter to a position @char_offset chars from the start +of the entire buffer. If @char_offset is -1 or greater than the number +of characters in the buffer, @iter is initialized to the end iterator, +the iterator one past the last valid character in the buffer. + + + + + + iterator to initialize + + + + char offset from start of buffer, counting from 0, or -1 + + + + + + Obtains the number of lines in the buffer. This value is cached, so +the function is very fast. + + number of lines in the buffer + + + + + Returns the mark named @name in buffer @buffer, or %NULL if no such +mark exists in the buffer. + + a #GtkTextMark, or %NULL + + + + + a mark name + + + + + + Indicates whether the buffer has been modified since the last call +to gtk_text_buffer_set_modified() set the modification flag to +%FALSE. Used for example to enable a "save" function in a text +editor. + + %TRUE if the buffer has been modified + + + + + This function returns the list of targets this text buffer supports +for pasting and as DND destination. The targets in the list are +added with %info values from the #GtkTextBufferTargetInfo enum, +using gtk_target_list_add_rich_text_targets() and +gtk_target_list_add_text_targets(). + + the #GtkTargetList + + + + + Returns the mark that represents the selection bound. Equivalent +to calling gtk_text_buffer_get_mark() to get the mark named +"selection_bound", but very slightly more efficient, and involves +less typing. +The currently-selected text in @buffer is the region between the +"selection_bound" and "insert" marks. If "selection_bound" and +"insert" are in the same place, then there is no current selection. +gtk_text_buffer_get_selection_bounds() is another convenient function +for handling the selection, if you just want to know whether there's a +selection and what its bounds are. + + selection bound mark + + + + + Returns %TRUE if some text is selected; places the bounds +of the selection in @start and @end (if the selection has length 0, +then @start and @end are filled in with the same value). +NULL, then they are not filled in, but the return value still indicates +whether text is selected. + + whether the selection has nonzero length + + + + + iterator to initialize with selection start + + + + iterator to initialize with selection end + + This function returns the rich text serialize formats registered with @buffer using gtk_text_buffer_register_serialize_format() or gtk_text_buffer_register_serialize_tagset() -formats." - version="2.10"> - +formats. + + an array of #GdkAtom<!-- -->s representing the registered - - + + return location for the number of formats + - + + Returns the text in the range [@start,@end). Excludes undisplayed +text (text marked with tags that set the invisibility attribute) if +0xFFFC character whenever the buffer contains +embedded images, so byte and character indexes into +the returned string <emphasis>do</emphasis> correspond to byte +and character indexes into the buffer. Contrast with +gtk_text_buffer_get_text(). Note that 0xFFFC can occur in normal +text as well, so it is not a reliable indicator that a pixbuf or +widget is in the buffer. - + an allocated UTF-8 string + - + start of a range + + + + end of a range + + + + whether to include invisible text + + + + + + Initialized @iter with the first position in the text buffer. This +is the same as using gtk_text_buffer_get_iter_at_offset() to get +the iter at character offset 0. + + + + + - + caller-allocates="1" + transfer-ownership="none"> + iterator to initialize + + + + + + Get the #GtkTextTagTable associated with this buffer. + + the buffer's tag table + + + + + Returns the text in the range [@start,@end). Excludes undisplayed +text (text marked with tags that set the invisibility attribute) if +representing embedded images, so byte and character indexes into +the returned string do <emphasis>not</emphasis> correspond to byte +and character indexes into the buffer. Contrast with +gtk_text_buffer_get_slice(). + + an allocated UTF-8 string + + + + + start of a range + + + + end of a range + + + + whether to include invisible text + + + + + + Inserts @len bytes of @text at position @iter. If @len is -1, +entirety. Emits the "insert-text" signal; insertion actually occurs +in the default handler for the signal. @iter is invalidated when +insertion occurs (because the buffer contents change), but the +default signal handler revalidates it to point to the end of the +inserted text. + + + + + + a position in the buffer + + + + text in UTF-8 format + + + + length of text in bytes, or -1 + + + + + + Simply calls gtk_text_buffer_insert(), using the current +cursor position as the insertion point. + + + + + + text in UTF-8 format + + + + length of text, in bytes + + + + + + Inserts a child widget anchor into the text buffer at @iter. The +anchor will be counted as one character in character counts, and +when obtaining the buffer contents as a string, will be represented +by the Unicode "object replacement character" 0xFFFC. Note that the +"slice" variants for obtaining portions of the buffer as a string +include this character for child anchors, but the "text" variants do +not. E.g. see gtk_text_buffer_get_slice() and +gtk_text_buffer_get_text(). Consider +gtk_text_buffer_create_child_anchor() as a more convenient +alternative to this function. The buffer will add a reference to +the anchor, so you can unref it after insertion. + + + + + + location to insert the anchor + + + + a #GtkTextChildAnchor + + + + + + Like gtk_text_buffer_insert(), but the insertion will not occur if +want to prevent insertions at ineditable locations if the insertion +results from a user action (is interactive). +have a tag affecting editability applied to it. Typically the +result of gtk_text_view_get_editable() is appropriate here. + + whether text was actually inserted + + + + + a position in @buffer + + + + some UTF-8 text + + + + length of text in bytes, or -1 + + + + default editability of buffer + + + + + + Calls gtk_text_buffer_insert_interactive() at the cursor +position. +have a tag affecting editability applied to it. Typically the +result of gtk_text_view_get_editable() is appropriate here. + + whether text was actually inserted + + + + + text in UTF-8 format + + + + length of text in bytes, or -1 + + + + default editability of buffer + + + + + + Inserts an image into the text buffer at @iter. The image will be +counted as one character in character counts, and when obtaining +the buffer contents as a string, will be represented by the Unicode +"object replacement character" 0xFFFC. Note that the "slice" +variants for obtaining portions of the buffer as a string include +this character for pixbufs, but the "text" variants do +not. e.g. see gtk_text_buffer_get_slice() and +gtk_text_buffer_get_text(). + + + + + + location to insert the pixbuf + + + + a #GdkPixbuf + + + + + + Copies text, tags, and pixbufs between @start and @end (the order +of @start and @end doesn't matter) and inserts the copy at @iter. +Used instead of simply getting/inserting text because it preserves +images and tags. If @start and @end are in a different buffer from +Implemented via emissions of the insert_text and apply_tag signals, +so expect those. + + + + + + a position in @buffer + + + + a position in a #GtkTextBuffer + + + + another position in the same buffer as @start + + + + + + Same as gtk_text_buffer_insert_range(), but does nothing if the +insertion point isn't editable. The @default_editable parameter +indicates whether the text is editable at @iter if no tags +enclosing @iter affect editability. Typically the result of +gtk_text_view_get_editable() is appropriate here. + + whether an insertion was possible at @iter + + + + + a position in @buffer + + + + a position in a #GtkTextBuffer + + + + another position in the same buffer as @start + + + + default editability of the buffer + + + + + + Inserts @text into @buffer at @iter, applying the list of tags to +the newly-inserted text. The last tag specified must be NULL to +terminate the list. Equivalent to calling gtk_text_buffer_insert(), +then gtk_text_buffer_apply_tag() on the inserted text; +gtk_text_buffer_insert_with_tags() is just a convenience function. + + + + + + an iterator in @buffer + + + + UTF-8 text + + + + length of @text, or -1 + + + + first tag to apply to @text + + + + + + + + + + Same as gtk_text_buffer_insert_with_tags(), but allows you +to pass in tag names instead of tag objects. + + + + + + position in @buffer + + + + UTF-8 text + + + + length of @text, or -1 + + + + name of a tag to apply to @text + + + + + + + + + + Moves @mark to the new location @where. Emits the "mark-set" signal +as notification of the move. + + + + + + a #GtkTextMark + + + + new location for @mark in @buffer + + + + + + Moves the mark named @name (which must exist) to location @where. +See gtk_text_buffer_move_mark() for details. + + + + + + name of a mark + + + + new location for mark + + + + + + Pastes the contents of a clipboard at the insertion point, or +we'll ask for the paste data and return, and at some point later +after the main loop runs, the paste data will be inserted.) + + + + + + the #GtkClipboard to paste from + + + + location to insert pasted text, or %NULL for at the cursor + + + + whether the buffer is editable by default + + + + + + This function moves the "insert" and "selection_bound" marks +simultaneously. If you move them to the same place in two steps +with gtk_text_buffer_move_mark(), you will temporarily select a +region in between their old and new locations, which can be pretty +inefficient since the temporarily-selected region will force stuff +to be recalculated. This function moves them as a unit, which can +be optimized. + + + + + + where to put the cursor + + + + + + This function registers a rich text deserialization @function along with +its @mime_type with the passed @buffer. +format's mime-type. + + the #GdkAtom that corresponds to the newly registered + + + + + the format's mime-type + + + + the deserialize function to register + + + + @function's user_data + + + + a function to call when @user_data is no longer needed + + + + + + This function registers GTK+'s internal rich text serialization +format with the passed @buffer. See +gtk_text_buffer_register_serialize_tagset() for details. +format's mime-type. + + the #GdkAtom that corresponds to the newly registered + + + + + an optional tagset name, on %NULL + + + + + + This function registers a rich text serialization @function along with +its @mime_type with the passed @buffer. +format's mime-type. + + the #GdkAtom that corresponds to the newly registered + + + + + the format's mime-type + + + + the serialize function to register + + + + %function's user_data + + + + a function to call when @user_data is no longer needed + + + + + + This function registers GTK+'s internal rich text serialization +format with the passed @buffer. The internal format does not comply +to any standard rich text format and only works between #GtkTextBuffer +instances. It is capable of serializing all of a text buffer's tags +and embedded pixbufs. +This function is just a wrapper around +gtk_text_buffer_register_serialize_format(). The mime type used +for registering is "application/x-gtk-text-buffer-rich-text", or +"application/x-gtk-text-buffer-rich-text;format=@tagset_name" if a +The @tagset_name can be used to restrict the transfer of rich text +to buffers with compatible sets of tags, in order to avoid unknown +tags from being pasted. It is probably the common case to pass an +identifier != %NULL here, since the %NULL tagset requires the +receiving buffer to deal with with pasting of arbitrary tags. +format's mime-type. + + the #GdkAtom that corresponds to the newly registered + + + + + an optional tagset name, on %NULL + + + + + + Removes all tags in the range between @start and @end. Be careful +with this function; it could remove tags added in code unrelated to +the code you're currently writing. That is, using this function is +probably a bad idea if you have two or more unrelated code sections +that add tags. + + + + + + one bound of range to be untagged + + + + other bound of range to be untagged + + + + + + Removes a #GtkClipboard added with +gtk_text_buffer_add_selection_clipboard(). + + + + + + a #GtkClipboard added to @buffer by gtk_text_buffer_add_selection_clipboard() + + + + + + Emits the "remove-tag" signal. The default handler for the signal +removes all occurrences of @tag from the given range. @start and + + + + + + a #GtkTextTag + + + + one bound of range to be untagged + + + + other bound of range to be untagged + + + + + + Calls gtk_text_tag_table_lookup() on the buffer's tag table to +get a #GtkTextTag, then calls gtk_text_buffer_remove_tag(). + + + + + + name of a #GtkTextTag + + + + one bound of range to be untagged + + + + other bound of range to be untagged + + + + + + This function moves the "insert" and "selection_bound" marks +simultaneously. If you move them in two steps +with gtk_text_buffer_move_mark(), you will temporarily select a +region in between their old and new locations, which can be pretty +inefficient since the temporarily-selected region will force stuff +to be recalculated. This function moves them as a unit, which can +be optimized. + + + + + + where to put the "insert" mark + + + + where to put the "selection_bound" mark + + This function serializes the portion of text between @start and @end in the rich text format represented by @format. gtk_text_buffer_register_serialize_format() or -gtk_text_buffer_register_serialize_tagset() beforehand." - version="2.10"> - - - - +gtk_text_buffer_register_serialize_tagset() beforehand. + + the serialized data, encoded as @format + + the #GtkTextBuffer to serialize + the rich text format to use for serializing + start of block of text to serialize + end of block of test to serialize - - + + return location for the length of the serialized data + - + + Used to keep track of whether the buffer has been modified since the +last time it was saved. Whenever the buffer is saved to disk, call +gtk_text_buffer_set_modified (@buffer, FALSE). When the buffer is modified, +it will automatically toggled on the modified bit again. When the modified +bit flips, the buffer emits a "modified-changed" signal. - + - - + + modification flag setting + + + + + Deletes current contents of @buffer, and inserts @text instead. If + + + + + + UTF-8 text to insert + + + + length of @text in bytes + + + + + + This function unregisters a rich text format that was previously +registered using gtk_text_buffer_register_deserialize_format() or +gtk_text_buffer_register_deserialize_tagset(). + + + + + a #GdkAtom representing a registered rich text format. - - - - - - - - - - + + + + This function unregisters a rich text format that was previously +registered using gtk_text_buffer_register_serialize_format() or +gtk_text_buffer_register_serialize_tagset() + + + + + + a #GdkAtom representing a registered rich text format. + - + transfer-ownership="none"> + The list of targets this buffer supports for clipboard copying +and as DND source. + - + transfer-ownership="none"> + The position of the insert mark (as offset from the beginning +of the buffer). It is useful for getting notified when the +cursor moves. + - - + + Whether the buffer has some text currently selected. + - + transfer-ownership="none"> + The list of targets this buffer supports for clipboard pasting +and as DND destination. + - - + + - + transfer-ownership="none"> + The text content of the buffer. Without child widgets and images, +see gtk_text_buffer_get_text() for more information. + - - + + - - - - - - - - - - - - - - - - - - - - - - + The ::apply-tag signal is emitted to apply a tag to a +range of text in a #GtkTextBuffer. Applying actually occurs in the default handler. -Note that if your handler runs before the default handler it must not -invalidate the @start and @end iters (or has to revalidate them). -See also: +Note that if your handler runs before the default handler it must not +invalidate the @start and @end iters (or has to revalidate them). gtk_text_buffer_apply_tag(), gtk_text_buffer_insert_with_tags(), -gtk_text_buffer_insert_range()."> - - +gtk_text_buffer_insert_range(). + + - - + + the applied tag + - - + + the start of the range the tag is applied to + - - + + the end of the range the tag is applied to + - + The ::begin-user-action signal is emitted at the beginning of a single user-visible operation on a #GtkTextBuffer. -See also: gtk_text_buffer_begin_user_action(), gtk_text_buffer_insert_interactive(), gtk_text_buffer_insert_range_interactive(), gtk_text_buffer_delete_interactive(), gtk_text_buffer_backspace(), -gtk_text_buffer_delete_selection()."> - - +gtk_text_buffer_delete_selection(). + + - - - + + The ::changed signal is emitted when the content of a #GtkTextBuffer +has changed. + + - + The ::delete-range signal is emitted to delete a range +from a #GtkTextBuffer. +Note that if your handler runs before the default handler it must not +invalidate the @start and @end iters (or has to revalidate them). +The default signal handler revalidates the @start and @end iters to both point point to the location where text was deleted. Handlers which run after the default handler (see g_signal_connect_after()) -do not have access to the deleted text."> - - +do not have access to the deleted text. + + - - + + the start of the range to be deleted + - - + + the end of the range to be deleted + - + The ::end-user-action signal is emitted at the end of a single user-visible operation on the #GtkTextBuffer. -See also: gtk_text_buffer_end_user_action(), gtk_text_buffer_insert_interactive(), gtk_text_buffer_insert_range_interactive(), gtk_text_buffer_delete_interactive(), gtk_text_buffer_backspace(), gtk_text_buffer_delete_selection(), -gtk_text_buffer_backspace()."> - - +gtk_text_buffer_backspace(). + + - + The ::insert-child-anchor signal is emitted to insert a #GtkTextChildAnchor in a #GtkTextBuffer. Insertion actually occurs in the default handler. Note that if your handler runs before the default handler it must -not invalidate the @location iter (or has to revalidate it). -The default signal handler revalidates it to be placed after the -inserted @anchor."> - - +not invalidate the @location iter (or has to revalidate it). +The default signal handler revalidates it to be placed after the +inserted @anchor. + + - - + + position to insert @anchor in @textbuffer + - - + + the #GtkTextChildAnchor to be inserted + - + The ::insert-pixbuf signal is emitted to insert a #GdkPixbuf in a #GtkTextBuffer. Insertion actually occurs in the default handler. -Note that if your handler runs before the default handler it must not -invalidate the @location iter (or has to revalidate it). -The default signal handler revalidates it to be placed after the -inserted @pixbuf."> - - +Note that if your handler runs before the default handler it must not +invalidate the @location iter (or has to revalidate it). +The default signal handler revalidates it to be placed after the +inserted @pixbuf. + + - - + + position to insert @pixbuf in @textbuffer + - - + + the #GdkPixbuf to be inserted + - + The ::insert-text signal is emitted to insert text in a #GtkTextBuffer. +Insertion actually occurs in the default handler. +Note that if your handler runs before the default handler it must not +invalidate the @location iter (or has to revalidate it). +The default signal handler revalidates it to point to the end of the inserted text. -See also: -gtk_text_buffer_insert(), -gtk_text_buffer_insert_range()."> - - +gtk_text_buffer_insert(), +gtk_text_buffer_insert_range(). + + - - + + position to insert @text in @textbuffer + - - + + the UTF-8 text to be inserted + - - + + length of the inserted text in bytes + - + The ::mark-deleted signal is emitted as notification +after a #GtkTextMark is deleted. See also: -gtk_text_buffer_delete_mark()."> - - +gtk_text_buffer_delete_mark(). + + - - + + The mark that was deleted + - + The ::mark-set signal is emitted as notification after a #GtkTextMark is set. -See also: gtk_text_buffer_create_mark(), -gtk_text_buffer_move_mark()."> - - +gtk_text_buffer_move_mark(). + + - - + + The location of @mark in @textbuffer + - - + + The mark that is set + - + The ::modified-changed signal is emitted when the modified bit of a #GtkTextBuffer flips. See also: -gtk_text_buffer_set_modified()."> - - +gtk_text_buffer_set_modified(). + + - + The paste-done signal is emitted after paste operation has been completed. This is useful to properly scroll the view to the end of the pasted text. -See gtk_text_buffer_paste_clipboard() for more details." - version="2.16"> - - +See gtk_text_buffer_paste_clipboard() for more details. + + - - + + - + The ::remove-tag signal is emitted to remove all occurrences of @tag from +a range of text in a #GtkTextBuffer. Removal actually occurs in the default handler. -Note that if your handler runs before the default handler it must not -invalidate the @start and @end iters (or has to revalidate them). -See also: -gtk_text_buffer_remove_tag()."> - - +Note that if your handler runs before the default handler it must not +invalidate the @start and @end iters (or has to revalidate them). +gtk_text_buffer_remove_tag(). + + - - + + the tag to be removed + - - + + the start of the range the tag is removed from + - - + + the end of the range the tag is removed from + @@ -58090,7 +52779,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58105,13 +52794,13 @@ gtk_text_buffer_remove_tag()."> - + - + @@ -58129,7 +52818,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58147,7 +52836,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58165,7 +52854,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58177,7 +52866,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58189,7 +52878,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58207,7 +52896,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58222,7 +52911,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58243,7 +52932,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58264,7 +52953,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58276,7 +52965,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58288,7 +52977,7 @@ gtk_text_buffer_remove_tag()."> - + @@ -58302,36 +52991,36 @@ gtk_text_buffer_remove_tag()."> - - + + - - + + - - + + - - + + - - + + @@ -58342,7 +53031,7 @@ gtk_text_buffer_remove_tag()."> c:type="GtkTextBufferDeserializeFunc" throws="1"> - + @@ -58355,27 +53044,27 @@ gtk_text_buffer_remove_tag()."> - - - + - + - + - + + + - - - - + + @@ -58390,11 +53079,11 @@ gtk_text_buffer_remove_tag()."> - - + + - + @@ -58415,99 +53104,67 @@ gtk_text_buffer_remove_tag()."> c:identifier="GTK_TEXT_BUFFER_TARGET_INFO_TEXT" glib:nick="text"/> - + - + - + - + - + Creates a new #GtkTextChildAnchor. Usually you would then insert it into a #GtkTextBuffer with gtk_text_buffer_insert_child_anchor(). To perform the creation and insertion in one step, use the -convenience function gtk_text_buffer_create_child_anchor()."> +convenience function gtk_text_buffer_create_child_anchor(). + a new #GtkTextChildAnchor + + Determines whether a child anchor has been deleted from +the buffer. Keep in mind that the child anchor will be +unreferenced when removed from the buffer, so you need to +hold your own reference (with g_object_ref()) if you plan +to use this function &mdash; otherwise all deleted child anchors +will also be finalized. + + %TRUE if the child anchor has been deleted from its buffer + + + - + c:identifier="gtk_text_child_anchor_get_widgets"> + Gets a list of all widgets anchored at this child anchor. +The returned list should be freed with g_list_free(). + + list of widgets anchored at @anchor - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - c:identifier="GTK_TEXT_DIR_RTL" glib:nick="rtl"/> - - - - - - - - - - - - - + glib:get-type="gtk_text_iter_get_type" + c:symbol-prefix="text_iter"> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - - - - - - - - - - + + Moves backward by one character offset. Returns %TRUE if movement +was possible; if @iter was the first in the buffer (character +offset 0), gtk_text_iter_backward_char () returns %FALSE for convenience when +writing loops. - + whether movement was possible + - + + Moves @count characters backward, if possible (if @count would move +past the start or end of the buffer, moves to the start or end of +the buffer). The return value indicates whether the iterator moved +onto a dereferenceable position; if the iterator didn't move, or +moved onto the end iterator, then %FALSE is returned. If @count is 0, +the function does nothing and returns %FALSE. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + whether @iter moved and is dereferenceable + - + + number of characters to move + + + + + + Like gtk_text_iter_forward_cursor_position(), but moves backward. + + %TRUE if we moved + + + + + Moves up to @count cursor positions. See +gtk_text_iter_forward_cursor_position() for details. + + %TRUE if we moved and the new position is dereferenceable + + + + + number of positions to move + + + + + + Same as gtk_text_iter_forward_find_char(), but goes backward from @iter. + + whether a match was found + + + + + function to be called on each character + + + + user data for @pred + + + + search limit, or %NULL for none - - - + + Moves @iter to the start of the previous line. Returns %TRUE if +function returns %FALSE. Therefore if @iter was already on line 0, +but not at the start of the line, @iter is snapped to the start of +the line and the function returns %TRUE. (Note that this implies that +in a loop calling this function, the line number may not change on +every iteration, if your first iteration is on line 0.) + + whether @iter moved + + + + + Moves @count lines backward, if possible (if @count would move +past the start or end of the buffer, moves to the start or end of +the buffer). The return value indicates whether the iterator moved +onto a dereferenceable position; if the iterator didn't move, or +moved onto the end iterator, then %FALSE is returned. If @count is 0, +the function does nothing and returns %FALSE. If @count is negative, +moves forward by 0 - @count lines. + + whether @iter moved and is dereferenceable + - + + number of lines to move backward + + + + + + Same as gtk_text_iter_forward_search(), but moves backward. + + whether a match was found + + + + + search string + + + + bitmask of flags affecting the search + + + + return location for start of match, or %NULL + + + + return location for end of match, or %NULL + + + + location of last possible @match_start, or %NULL for start of buffer - - - + + Moves backward to the previous sentence start; if @iter is already at +the start of a sentence, moves backward to the next one. Sentence +boundaries are determined by Pango and should be correct for nearly +any language (if not, the correct fix would be to the Pango text +boundary algorithms). + + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_backward_sentence_start() up to @count times, +or until it returns %FALSE. If @count is negative, moves forward +instead of backward. + + %TRUE if @iter moved and is not the end iterator + - - + + number of sentences to move + - - - + + Moves backward to the next toggle (on or off) of the +#GtkTextTag @tag, or to the next toggle of any tag if +returns %FALSE, otherwise %TRUE. Does not return toggles +located at @iter, only toggles before @iter. Sets @iter +to the location of the toggle, or the start of the buffer +if no toggle is found. + + whether we found a tag toggle before @iter + - - + + a #GtkTextTag, or %NULL + - - - + + Moves @iter forward to the previous visible cursor position. See +gtk_text_iter_backward_cursor_position() for details. + + %TRUE if we moved and the new position is dereferenceable + - - - - - - - - - - - - - - - - - + + Moves up to @count visible cursor positions. See +gtk_text_iter_backward_cursor_position() for details. + + %TRUE if we moved and the new position is dereferenceable + - - + + number of positions to move + - + Moves @iter to the start of the previous visible line. Returns %TRUE if +function returns %FALSE. Therefore if @iter was already on line 0, +but not at the start of the line, @iter is snapped to the start of +the line and the function returns %TRUE. (Note that this implies that +in a loop calling this function, the line number may not change on +every iteration, if your first iteration is on line 0.) + + whether @iter moved + + + + + Moves @count visible lines backward, if possible (if @count would move +past the start or end of the buffer, moves to the start or end of +the buffer). The return value indicates whether the iterator moved +onto a dereferenceable position; if the iterator didn't move, or +moved onto the end iterator, then %FALSE is returned. If @count is 0, +the function does nothing and returns %FALSE. If @count is negative, +moves forward by 0 - @count lines. + + whether @iter moved and is dereferenceable + + + + + number of lines to move backward + + + + + + Moves backward to the previous visible word start. (If @iter is currently +on a word start, moves backward to the next one after that.) Word breaks +are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). + + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_backward_visible_word_start() up to @count times. + + %TRUE if @iter moved and is not the end iterator + + + + + number of times to move + + + + + + Moves backward to the previous word start. (If @iter is currently on a +word start, moves backward to the next one after that.) Word breaks +are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). + + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_backward_word_start() up to @count times. + + %TRUE if @iter moved and is not the end iterator + + + + + number of times to move + + + + + + Returns %TRUE if @tag is toggled on at exactly this point. If @tag is %NULL, returns %TRUE if any tag is toggled on at this point. Note that the gtk_text_iter_begins_tag () returns %TRUE if @iter is the <emphasis>start</emphasis> of the tagged range; gtk_text_iter_has_tag () tells you whether an iterator is -<emphasis>within</emphasis> a tagged range."> +<emphasis>within</emphasis> a tagged range. - + whether @iter is the start of a range tagged with @tag + - + + a #GtkTextTag, or %NULL - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Considering the default editability of the buffer, and tags that affect editability, determines whether text inserted at @iter would be editable. If text inserted at @iter would be editable then the user should be allowed to insert text at @iter. gtk_text_buffer_insert_interactive() uses this function to decide -whether insertions are allowed at a given position."> +whether insertions are allowed at a given position. - + whether text inserted at @iter would be editable + - + %TRUE if text is editable by default + - + + A qsort()-style function that returns negative if @lhs is less than +Ordering is in character offset order, i.e. the first character in the buffer +is less than the second character in the buffer. - + -1 if @lhs is less than @rhs, 1 if @lhs is greater, 0 if they are equal + + + + + another #GtkTextIter + + + + + + Creates a dynamically-allocated copy of an iterator. This function +is not useful in applications, because iterators can be copied with a +simple assignment (<literal>GtkTextIter i = j;</literal>). The +function is used by language bindings. + + a copy of the @iter, free with gtk_text_iter_free () + - + + Returns whether the character at @iter is within an editable region +of text. Non-editable text is "locked" and can't be changed by the +user via #GtkTextView. This function is simply a convenience +wrapper around gtk_text_iter_get_attributes (). If no tags applied +to this text affect editability, @default_setting will be returned. +You don't want to use this function to decide whether text can be +inserted at @iter, because for insertion you don't want to know +whether the char at @iter is inside an editable range, you want to +know whether a new character inserted at @iter would be inside an +editable range. Use gtk_text_iter_can_insert() to handle this +case. - + whether @iter is inside an editable range + + + + %TRUE if text is editable by default + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns %TRUE if @iter points to the start of the paragraph delimiter characters for a line (delimiters will be either a newline, a carriage return, a carriage return followed by a newline, or a Unicode paragraph separator character). Note that an iterator pointing to the \n of a \r\n pair will not be counted as the end of a line, the line ends before the \r. The end iterator is considered to be at the end of a line, even though there are no -paragraph delimiter chars there."> +paragraph delimiter chars there. - + whether @iter is at the end of a line + - + + Determines whether @iter ends a sentence. Sentence boundaries are +determined by Pango and should be correct for nearly any language +(if not, the correct fix would be to the Pango text boundary +algorithms). - + %TRUE if @iter is at the end of a sentence. + - + + Returns %TRUE if @tag is toggled off at exactly this point. If @tag +is %NULL, returns %TRUE if any tag is toggled off at this point. Note +that the gtk_text_iter_ends_tag () returns %TRUE if @iter is the +<emphasis>end</emphasis> of the tagged range; +gtk_text_iter_has_tag () tells you whether an iterator is +<emphasis>within</emphasis> a tagged range. - - - - - - - - - - - + whether @iter is the end of a range tagged with @tag + - - + + a #GtkTextTag, or %NULL + - - - - - - + + Determines whether @iter ends a natural-language word. Word breaks +are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). - + %TRUE if @iter is at the end of a word + - + + Tests whether two iterators are equal, using the fastest possible +mechanism. This function is very fast; you can expect it to perform +better than e.g. getting the character offset for each iterator and +comparing the offsets yourself. Also, it's a bit faster than +gtk_text_iter_compare(). - + %TRUE if the iterators point to the same place in the buffer + + + + another #GtkTextIter + + + - + Moves @iter forward by one character offset. Note that images embedded in the buffer occupy 1 character slot, so gtk_text_iter_forward_char () may actually move onto an image instead of a character, if you have images in your buffer. If @iter is the end iterator or one character before it, @iter will now point at the end iterator, and gtk_text_iter_forward_char () returns %FALSE for -convenience when writing loops."> +convenience when writing loops. - + whether @iter moved and is dereferenceable + - - - - - - + Moves @count characters if possible (if @count would move past the start or end of the buffer, moves to the start or end of the buffer). The return value indicates whether the new position of (the last iterator in the buffer is not dereferenceable). If @count -is 0, the function does nothing and returns %FALSE."> +is 0, the function does nothing and returns %FALSE. - + whether @iter moved and is dereferenceable + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + number of characters to move, may be negative + + Moves @iter forward by a single cursor position. Cursor positions are (unsurprisingly) positions where the cursor can appear. Perhaps surprisingly, there may not be a cursor position between all characters. The most common example for European languages would be a carriage return/newline sequence. For some Unicode characters, -the equivalent of say the letter "a" with an accent mark will be -represented as two characters, first the letter then a "combining -mark" that causes the accent to be rendered; so the cursor can't go +the equivalent of say the letter "a" with an accent mark will be +represented as two characters, first the letter then a "combining +mark" that causes the accent to be rendered; so the cursor can't go between those two characters. See also the #PangoLogAttr structure and -pango_break() function."> +pango_break() function. - - - - - - + %TRUE if we moved and the new position is dereferenceable + + c:identifier="gtk_text_iter_forward_cursor_positions"> + Moves up to @count cursor positions. See +gtk_text_iter_forward_cursor_position() for details. - + %TRUE if we moved and the new position is dereferenceable + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + number of positions to move + + introspectable="0"> + Advances @iter, calling @pred on each character. If +If @pred never returns %TRUE, @iter is set to @limit if - + whether a match was found + + closure="1"> + a function to be called on each character - + user data for @pred + - + + search limit, or %NULL for none - + + Moves @iter to the start of the next line. If the iter is already on the +last line of the buffer, moves the iter to the end of the current line. +If after the operation, the iter is at the end of the buffer and not +dereferencable, returns %FALSE. Otherwise, returns %TRUE. - + whether @iter can be dereferenced + + + + + Moves @count lines forward, if possible (if @count would move +past the start or end of the buffer, moves to the start or end of +the buffer). The return value indicates whether the iterator moved +onto a dereferenceable position; if the iterator didn't move, or +moved onto the end iterator, then %FALSE is returned. If @count is 0, +the function does nothing and returns %FALSE. If @count is negative, +moves backward by 0 - @count lines. + + whether @iter moved and is dereferenceable + - - - - - - - - + + number of lines to move forward + + Searches forward for @str. Any match is returned by setting first character after the match. The search will not continue past may wish to use @limit to avoid locking up your UI on large buffers. @@ -59744,1296 +53859,840 @@ possibly-noncontiguous subsequence of the matched range. similarly, if you specify #GTK_TEXT_SEARCH_TEXT_ONLY, the match may have pixbufs or child widgets mixed inside the matched range. If these flags are not given, the match must be exact; the special 0xFFFC -character in @str will match embedded pixbufs or child widgets."> +character in @str will match embedded pixbufs or child widgets. - + whether a match was found + + a search string + flags affecting how the search is done + allow-none="1"> + return location for start of match, or %NULL + allow-none="1"> + return location for end of match, or %NULL - + + bound for the search, or %NULL for the end of the buffer - + + Moves forward to the next sentence end. (If @iter is at the end of +a sentence, moves to the next end of sentence.) Sentence +boundaries are determined by Pango and should be correct for nearly +any language (if not, the correct fix would be to the Pango text +boundary algorithms). - + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_forward_sentence_end() @count times (or until +gtk_text_iter_forward_sentence_end() returns %FALSE). If @count is +negative, moves backward instead of forward. + + %TRUE if @iter moved and is not the end iterator + - - - - - - - - - - - - - - + + number of sentences to move + - + + Moves @iter forward to the "end iterator," which points one past the last +valid character in the buffer. gtk_text_iter_get_char() called on the +end iterator returns 0, which is convenient for writing loops. - + + + + + Moves the iterator to point to the paragraph delimiter characters, +which will be either a newline, a carriage return, a carriage +return/newline in sequence, or the Unicode paragraph separator +character. If the iterator is already at the paragraph delimiter +characters, moves to the paragraph delimiter characters for the +next line. If @iter is on the last line in the buffer, which does +not end in paragraph delimiters, moves to the end iterator (end of +the last line), and returns %FALSE. + + %TRUE if we moved and the new location is not the end iterator + + + + + Moves forward to the next toggle (on or off) of the +#GtkTextTag @tag, or to the next toggle of any tag if +returns %FALSE, otherwise %TRUE. Does not return toggles +located at @iter, only toggles after @iter. Sets @iter to +the location of the toggle, or to the end of the buffer +if no toggle is found. + + whether we found a tag toggle after @iter + - - + + a #GtkTextTag, or %NULL + - + + Moves @iter forward to the next visible cursor position. See +gtk_text_iter_forward_cursor_position() for details. - + %TRUE if we moved and the new position is dereferenceable + + + + + Moves up to @count visible cursor positions. See +gtk_text_iter_forward_cursor_position() for details. + + %TRUE if we moved and the new position is dereferenceable + - + + number of positions to move + + + + + + Moves @iter to the start of the next visible line. Returns %TRUE if there +was a next line to move to, and %FALSE if @iter was simply moved to +the end of the buffer and is now not dereferenceable, or if @iter was +already at the end of the buffer. + + whether @iter can be dereferenced + + + + + Moves @count visible lines forward, if possible (if @count would move +past the start or end of the buffer, moves to the start or end of +the buffer). The return value indicates whether the iterator moved +onto a dereferenceable position; if the iterator didn't move, or +moved onto the end iterator, then %FALSE is returned. If @count is 0, +the function does nothing and returns %FALSE. If @count is negative, +moves backward by 0 - @count lines. + + whether @iter moved and is dereferenceable + + + + + number of lines to move forward + + + + + + Moves forward to the next visible word end. (If @iter is currently on a +word end, moves forward to the next one after that.) Word breaks +are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). + + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_forward_visible_word_end() up to @count times. + + %TRUE if @iter moved and is not the end iterator + + + + + number of times to move + + + + + + Moves forward to the next word end. (If @iter is currently on a +word end, moves forward to the next one after that.) Word breaks +are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). + + %TRUE if @iter moved and is not the end iterator + + + + + Calls gtk_text_iter_forward_word_end() up to @count times. + + %TRUE if @iter moved and is not the end iterator + + + + + number of times to move + + + + + + Free an iterator allocated on the heap. This function +is intended for use in language bindings, and is not +especially useful for applications, because iterators can +simply be allocated on the stack. + + + + + + Computes the effect of any tags applied to this spot in the +text. The @values parameter should be initialized to the default +settings you wish to use if no tags are in effect. You'd typically +obtain the defaults from gtk_text_view_get_default_attributes(). +gtk_text_iter_get_attributes () will modify @values, applying the +effects of any tags present at @iter. If any tags affected @values, +the function returns %TRUE. + + %TRUE if @values was modified + + + + + a #GtkTextAttributes to be filled in + + + + + + Returns the #GtkTextBuffer this iterator is associated with. + + the buffer + + + + + Returns the number of bytes in the line containing @iter, +including the paragraph delimiters. + + number of bytes in the line + + + + + Returns the Unicode character at this iterator. (Equivalent to +operator* on a C++ iterator.) If the element at this iterator is a +non-character element, such as an image embedded in the buffer, the +Unicode "unknown" character 0xFFFC is returned. If invoked on +the end iterator, zero is returned; zero is not a valid Unicode character. +So you can write a loop which ends when gtk_text_iter_get_char () +returns 0. + + a Unicode character, or 0 if @iter is not dereferenceable + + + + + Returns the number of characters in the line containing @iter, +including the paragraph delimiters. + + number of characters in the line + + + + + If the location at @iter contains a child anchor, the +anchor is returned (with no new reference count added). Otherwise, +%NULL is returned. + + the anchor at @iter + + + + + A convenience wrapper around gtk_text_iter_get_attributes (), +which returns the language in effect at @iter. If no tags affecting +language apply to @iter, the return value is identical to that of +gtk_get_default_language (). + + language in effect at @iter + + + + + Returns the line number containing the iterator. Lines in +a #GtkTextBuffer are numbered beginning with 0 for the first +line in the buffer. + + a line number + + + + + Returns the byte index of the iterator, counting +from the start of a newline-terminated line. +Remember that #GtkTextBuffer encodes text in +UTF-8, and that characters can require a variable +number of bytes to represent. + + distance from start of line, in bytes + + + + + Returns the character offset of the iterator, +counting from the start of a newline-terminated line. +The first character on the line has offset 0. + + offset from start of line + + + + + Returns a list of all #GtkTextMark at this location. Because marks +are not iterable (they don't take up any "space" in the buffer, +they are just marks in between iterable locations), multiple marks +can exist in the same place. The returned list is not in any +meaningful order. + + list of #GtkTextMark + + + + + + + Returns the character offset of an iterator. +Each character in a #GtkTextBuffer has an offset, +starting with 0 for the first character in the buffer. +Use gtk_text_buffer_get_iter_at_offset () to convert an +offset back into an iterator. + + a character offset + + + + + If the element at @iter is a pixbuf, the pixbuf is returned +(with no new reference count added). Otherwise, +%NULL is returned. + + the pixbuf at @iter + + + + + Returns the text in the given range. A "slice" is an array of +characters encoded in UTF-8 format, including the Unicode "unknown" +character 0xFFFC for iterable non-character elements in the buffer, +such as images. Because images are encoded in the slice, byte and +character offsets in the returned array will correspond to byte +offsets in the text buffer. Note that 0xFFFC can occur in normal +text as well, so it is not a reliable indicator that a pixbuf or +widget is in the buffer. + + slice of text from the buffer + + + + + iterator at end of a range - + + Returns a list of tags that apply to @iter, in ascending order of +priority (highest-priority tags are last). The #GtkTextTag in the +list don't have a reference added, but you have to free the list +itself. + + list of #GtkTextTag + + + + + + + Returns <emphasis>text</emphasis> in the given range. If the range +contains non-text elements such as images, the character and byte +offsets in the returned string will not correspond to character and +byte offsets in the buffer. If you want offsets to correspond, see +gtk_text_iter_get_slice (). + + array of characters from the buffer + + + + + iterator at end of a range + + + + + + Returns a list of #GtkTextTag that are toggled on or off at this +point. (If @toggled_on is %TRUE, the list contains tags that are +toggled on.) If a tag is toggled on at @iter, then some non-empty +range of characters following @iter has that tag applied to it. If +a tag is toggled off, then some non-empty range following @iter +does <emphasis>not</emphasis> have the tag applied to it. + + tags toggled at this point + + + + + + + %TRUE to get toggled-on tags + + + + + + Returns the number of bytes from the start of the +line to the given @iter, not counting bytes that +are invisible due to tags with the "invisible" flag +toggled on. - + byte index of @iter with respect to the start of the line + + + + + Returns the offset in characters from the start of the +line to the given @iter, not counting characters that +are invisible due to tags with the "invisible" flag +toggled on. + + offset in visible characters from the start of the line + + + + + Like gtk_text_iter_get_slice (), but invisible text is not included. +Invisible text is usually invisible because a #GtkTextTag with the +"invisible" attribute turned on has been applied to it. + + slice of text from the buffer + + + + + iterator at end of range + + + + + + Like gtk_text_iter_get_text (), but invisible text is not included. +Invisible text is usually invisible because a #GtkTextTag with the +"invisible" attribute turned on has been applied to it. + + string containing visible text in the range + + + + + iterator at end of range + + + + + + Returns %TRUE if @iter is within a range tagged with @tag. + + whether @iter is tagged with @tag + + + + + a #GtkTextTag + + + + + + Checks whether @iter falls in the range [@start, @end). + + %TRUE if @iter is in the range + + start of range + end of range - + Determines whether @iter is inside a sentence (as opposed to in +between two sentences, e.g. after a period and before the first +letter of the next sentence). Sentence boundaries are determined +by Pango and should be correct for nearly any language (if not, the +correct fix would be to the Pango text boundary algorithms). + + %TRUE if @iter is inside a sentence. + + + + + Determines whether @iter is inside a natural-language word (as +opposed to say inside some whitespace). Word breaks are determined +by Pango and should be correct for nearly any language (if not, the +correct fix would be to the Pango word break algorithms). + + %TRUE if @iter is inside a word + + + + + See gtk_text_iter_forward_cursor_position() or #PangoLogAttr or +pango_break() for details on what a cursor position is. + + %TRUE if the cursor can be placed at @iter + + + + + Returns %TRUE if @iter is the end iterator, i.e. one past the last +dereferenceable iterator in the buffer. gtk_text_iter_is_end () is +the most efficient way to check whether an iterator is the end +iterator. + + whether @iter is the end iterator + + + + + Returns %TRUE if @iter is the first iterator in the buffer, that is +if @iter has a character offset of 0. + + whether @iter is the first in the buffer + + + + + Swaps the value of @first and @second if @second comes before in sequence. Most text buffer functions that take a range call this -automatically on your behalf, so there's no real reason to call it yourself +automatically on your behalf, so there's no real reason to call it yourself in those cases. There are some exceptions, such as gtk_text_iter_in_range(), -that expect a pre-sorted range."> +that expect a pre-sorted range. + another #GtkTextIter - - - - - - - - - - - - - - - - - - - - - + + Moves iterator @iter to the start of the line @line_number. If +buffer, moves @iter to the start of the last line in the buffer. - - - - - - - - + + line number (counted from 0) + - - + + + Same as gtk_text_iter_set_line_offset(), but works with a +<emphasis>byte</emphasis> index. The given byte index must be at +the start of a character, it can't be in the middle of a UTF-8 +encoded character. - - - - - + + a byte index relative to the start of @iter's current line + - - + + + Moves @iter within a line, to a new <emphasis>character</emphasis> +(not byte) offset. The given character offset must be less than or +equal to the number of characters in the line; if equal, @iter +moves to the start of the next line. See +gtk_text_iter_set_line_index() if you have a byte index rather than +a character offset. - - - - - + + a character offset relative to the start of @iter's current line + - - + + + Sets @iter to point to @char_offset. @char_offset counts from the start +of the entire text buffer, starting with 0. - - - - - + + a character number + - - + + + Like gtk_text_iter_set_line_index(), but the index is in visible +bytes, i.e. text with a tag making it invisible is not counted +in the index. - - + + a byte index + - - - - - - + + Like gtk_text_iter_set_line_offset(), but the offset is in visible +characters, i.e. text with a tag making it invisible is not +counted in the offset. - - + + a character offset + - + + Returns %TRUE if @iter begins a paragraph, +i.e. if gtk_text_iter_get_line_offset () would return 0. +However this function is potentially more efficient than +gtk_text_iter_get_line_offset () because it doesn't have to compute +the offset, it just has to see whether it's 0. - + whether @iter begins a line + + + + + Determines whether @iter begins a sentence. Sentence boundaries are +determined by Pango and should be correct for nearly any language +(if not, the correct fix would be to the Pango text boundary +algorithms). + + %TRUE if @iter is at the start of a sentence. + + + + + Determines whether @iter begins a natural-language word. Word +breaks are determined by Pango and should be correct for nearly any +language (if not, the correct fix would be to the Pango word break +algorithms). + + %TRUE if @iter is at the start of a word + + + + + This is equivalent to (gtk_text_iter_begins_tag () || +gtk_text_iter_ends_tag ()), i.e. it tells you whether a range with + + whether @tag is toggled on or off at @iter + - - - - - + + a #GtkTextTag, or %NULL + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a text mark. Add it to a buffer using gtk_text_buffer_add_mark(). +If @name is %NULL, the mark is anonymous; otherwise, the mark can be +retrieved by name using gtk_text_buffer_get_mark(). If a mark has left +gravity, and text is inserted at the mark's current location, the mark +will be moved to the left of the newly-inserted text. If the mark has +right gravity (@left_gravity = %FALSE), the mark will end up on the +right of newly-inserted text. The standard left-to-right cursor is a mark with right gravity (when you type, the cursor stays on the right -side of the text you're typing)." - version="2.12"> +side of the text you're typing). + new #GtkTextMark - + + mark name or %NULL - + whether the mark should have left gravity + - + Gets the buffer this mark is located inside, +or %NULL if the mark is deleted. + + the mark's #GtkTextBuffer + + + + + Returns %TRUE if the mark has been removed from its buffer +with gtk_text_buffer_delete_mark(). See gtk_text_buffer_add_mark() +for a way to add it to a buffer again. + + whether the mark is deleted + + + + + Determines whether the mark has left gravity. + + %TRUE if the mark has left gravity, %FALSE otherwise + + + + + Returns the mark name; returns NULL for anonymous marks. + + mark name + + + + + Returns %TRUE if the mark is visible (i.e. a cursor is displayed +for it). + + %TRUE if visible + + + + + Sets the visibility of @mark; the insertion point is normally visible, i.e. you can see it as a vertical bar. Also, the text widget uses a visible mark to indicate where a drop will occur when dragging-and-dropping text. Most other marks are not visible. -Marks are not visible by default."> +Marks are not visible by default. - + visibility of mark + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + - - + + - - + + - - + + - - + + - - glib:nick="text-only"/> - + + Creates a #GtkTextTag. Configure the tag using object arguments, +i.e. using g_object_set(). + a new #GtkTextTag - + + tag name, or %NULL - + + Emits the "event" signal on the #GtkTextTag. - + result of signal emission (whether the event was handled) + + + + + object that received the event, such as a widget + + + + the event + + + + location where the event was received + + + + + + Get the tag priority. + + The tag's priority. + - + Sets the priority of a #GtkTextTag. Valid priorities are start at 0 and go to one less than gtk_text_tag_table_get_size(). Each tag in a table has a unique priority; setting the priority of one tag shifts the priorities of all the other tags in the table to maintain a unique priority for each tag. Higher priority -tags "win" if two tags both set the same text attribute. When adding +tags "win" if two tags both set the same text attribute. When adding a tag to a tag table, it will be assigned the highest priority in the table by default; so normally the precedence of a set of tags is the order in which they were added to the table, or created with -gtk_text_buffer_create_tag(), which adds the tag to the buffer's table -automatically."> +gtk_text_buffer_create_tag(), which adds the tag to the buffer's table +automatically. - - - - - - - - - - - - - - - - - + the new priority + - + transfer-ownership="none"> + Whether the margins accumulate or override each other. +When set to %TRUE the margins of this tag are added to the margins +of any other non-accumulative margins present. When set to %FALSE +the margins override one another (the default). + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Font description as string, e.g. \"Sans Italic 12\". Note that the initial value of this property depends on -the internals of #PangoFontDescription."> - +the internals of #PangoFontDescription. + - - + + - - + + - - + + - - + + - - + + - - - - - - - - + + + Whether this text is hidden. +Note that there may still be problems with the support for invisible text, in particular when navigating programmatically inside a buffer -containing invisible segments."> - +containing invisible segments. + - - + + - - + + - - - - + + + + The language this text is in, as an ISO code. Pango can use this as a +hint when rendering the text. If not set, an appropriate default will be used. Note that the initial value of this property depends on the current -locale, see also gtk_get_default_language()."> - +locale, see also gtk_get_default_language(). + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + The paragraph background color as a string. + - + transfer-ownership="none"> + The paragraph background color as a as a (possibly unallocated) +#GdkColor. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -61390,99 +55070,97 @@ locale, see also gtk_get_default_language()."> - + - - - - + - + - - - - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + The ::event signal is emitted when an event occurs on a region of the buffer marked with this tag. -event. %FALSE to propagate the event further."> - - +event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the + - + the object the event was fired from (typically a #GtkTextView) + - - + + the event which triggered the signal + - - + + a #GtkTextIter pointing at the location the event occured + @@ -61494,9 +55172,9 @@ event. %FALSE to propagate the event further."> - + - + @@ -61514,29 +55192,29 @@ event. %FALSE to propagate the event further."> - - + + - - + + - - + + - - + + @@ -61544,65 +55222,38 @@ event. %FALSE to propagate the event further."> - + + Creates a new #GtkTextTagTable. The table contains no tags by +default. + a new #GtkTextTagTable - + Add a tag to the table. The tag is assigned the highest priority in the table. -the same name as an already-added tag."> +the same name as an already-added tag. + a #GtkTextTag - - - - - - - - - - - - - - - - - - - - - + + Calls @func on each tag in @table, with user data @data. +Note that the table may not be modified while iterating +over it (you can't add/remove tags). @@ -61610,66 +55261,90 @@ over it (you can't add/remove tags)."> + closure="1"> + a function to call on each tag - + user data + - + + Returns the size of the table (number of tags) - + number of tags in @table + + + Look up a named tag. + + The tag, or %NULL if none by that name is in the table. + + + + + name of a tag + + + + + + Remove a tag from the table. This will remove the table's +reference to the tag, so be careful - the tag will end +up destroyed if you don't have a reference to it. + + + + + + a #GtkTextTag + + + + - - - - - - - - - - - + + - - + + - + the added tag. + - - + + - + the changed tag. + - + whether the size has been changed. + - - + + - + the removed tag. + @@ -61681,7 +55356,7 @@ over it (you can't add/remove tags)."> - + @@ -61693,13 +55368,13 @@ over it (you can't add/remove tags)."> - + - + @@ -61714,7 +55389,7 @@ over it (you can't add/remove tags)."> - + @@ -61728,29 +55403,29 @@ over it (you can't add/remove tags)."> - - + + - - + + - - + + - - + + @@ -61766,11 +55441,16 @@ over it (you can't add/remove tags)."> - + + + glib:type-struct="TextViewClass"> - + + Creates a new #GtkTextView. If you don't call gtk_text_view_set_buffer() before using the text view, an empty default buffer will be created for you. Get the buffer with gtk_text_view_get_buffer(). If you want -to specify your own buffer, consider gtk_text_view_new_with_buffer()."> - - +to specify your own buffer, consider gtk_text_view_new_with_buffer(). + + a new #GtkTextView + + Creates a new #GtkTextView widget displaying the buffer this function is equivalent to gtk_text_view_new(). The text view adds its own reference count to the buffer; it does not -take over an existing reference."> - - +take over an existing reference. + + a new #GtkTextView. + + a #GtkTextBuffer @@ -61813,497 +55496,630 @@ take over an existing reference."> - + + Adds a child widget in the text buffer, at the given @anchor. - - + + a #GtkWidget + + + + a #GtkTextChildAnchor in the #GtkTextBuffer for @text_view + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Adds a child at fixed coordinates in one of the text widget's +windows. The window must have nonzero size (see +gtk_text_view_set_border_window_size()). Note that the child +coordinates are given relative to the #GdkWindow in question, and +that these coordinates have no sane relationship to scrolling. When +placing a child in #GTK_TEXT_WINDOW_WIDGET, scrolling is +irrelevant, the child floats above all scrollable areas. But when +placing a child in one of the scrollable windows (border windows or +text window), you'll need to compute the child's correct position +in buffer coordinates any time scrolling occurs or buffer changes +occur, and then call gtk_text_view_move_child() to update the +child's position. Unfortunately there's no good way to detect that +scrolling has occurred, using the current API; a possible hack +would be to update all child positions when the scroll adjustments +change or the text buffer changes. See bug 64518 on +bugzilla.gnome.org for status of fixing this issue. - - + + a #GtkWidget + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + which window the child should appear in - - + + X position of child in window coordinates + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Y position of child in window coordinates + + Moves the given @iter backward by one display (wrapped) line. A display line is different from a paragraph. Paragraphs are separated by newlines or other paragraph separator characters. Display lines are created by line-wrapping a paragraph. If wrapping is turned off, display lines and paragraphs will be the same. Display lines are divided differently for each view, since -they depend on the view's width; paragraphs are the same in all -views, since they depend on the contents of the #GtkTextBuffer."> +they depend on the view's width; paragraphs are the same in all +views, since they depend on the contents of the #GtkTextBuffer. - - - - - - - - - - - + %TRUE if @iter was moved and is not on the end iterator + + a #GtkTextIter + Moves the given @iter backward to the next display line start. A display line is different from a paragraph. Paragraphs are separated by newlines or other paragraph separator characters. Display lines are created by line-wrapping a paragraph. If wrapping is turned off, display lines and paragraphs will be the same. Display lines are divided differently for each view, since -they depend on the view's width; paragraphs are the same in all -views, since they depend on the contents of the #GtkTextBuffer."> +they depend on the view's width; paragraphs are the same in all +views, since they depend on the contents of the #GtkTextBuffer. - + %TRUE if @iter was moved and is not on the end iterator + + a #GtkTextIter - + + Converts coordinate (@buffer_x, @buffer_y) to coordinates for the window +Note that you can't convert coordinates for a nonexisting window (see +gtk_text_view_set_border_window_size()). - + + + + + a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE + + + + buffer x coordinate + + + + buffer y coordinate + + + + window x coordinate return location or %NULL + + + + window y coordinate return location or %NULL + + + + + + Moves the given @iter forward by one display (wrapped) line. +A display line is different from a paragraph. Paragraphs are +separated by newlines or other paragraph separator characters. +Display lines are created by line-wrapping a paragraph. If +wrapping is turned off, display lines and paragraphs will be the +same. Display lines are divided differently for each view, since +they depend on the view's width; paragraphs are the same in all +views, since they depend on the contents of the #GtkTextBuffer. + + %TRUE if @iter was moved and is not on the end iterator + + a #GtkTextIter - + Moves the given @iter forward to the next display line end. +A display line is different from a paragraph. Paragraphs are +separated by newlines or other paragraph separator characters. +Display lines are created by line-wrapping a paragraph. If +wrapping is turned off, display lines and paragraphs will be the +same. Display lines are divided differently for each view, since +they depend on the view's width; paragraphs are the same in all +views, since they depend on the contents of the #GtkTextBuffer. + + %TRUE if @iter was moved and is not on the end iterator + + + + + a #GtkTextIter + + + + + + Returns whether pressing the Tab key inserts a tab characters. +gtk_text_view_set_accepts_tab(). +%FALSE if pressing the Tab key moves the keyboard focus. + + %TRUE if pressing the Tab key inserts a tab character, + + + + + Gets the width of the specified border window. See +gtk_text_view_set_border_window_size(). + + width of window + + + + + window to return size from + + + + + + Returns the #GtkTextBuffer being displayed by this text view. +The reference count on the buffer is not incremented; the caller +of this function won't own a new reference. + + a #GtkTextBuffer + + + + + Find out whether the cursor is being displayed. + + whether the insertion mark is visible + + + + + Obtains a copy of the default text attributes. These are the +attributes used for text unless a tag overrides them. +You'd typically pass the default attributes in to +gtk_text_iter_get_attributes() in order to get the +attributes in effect at a given text position. +The return value is a copy owned by the caller of this function, +and should be freed. + + a new #GtkTextAttributes + + + + + Returns the default editability of the #GtkTextView. Tags in the +buffer may override this setting for some ranges of text. + + whether text is editable by default + + + + + Gets the horizontal-scrolling #GtkAdjustment. + + pointer to the horizontal #GtkAdjustment + + + + + Gets the default indentation of paragraphs in @text_view. +Tags in the view's buffer may override the default. +The indentation may be negative. + + number of pixels of indentation + + + + + Retrieves the iterator at buffer coordinates @x and @y. Buffer +coordinates are coordinates for the entire buffer, not just the +currently-displayed portion. If you have coordinates from an +event, you have to convert those to buffer coordinates with +gtk_text_view_window_to_buffer_coords(). + + + + + + a #GtkTextIter + + + + x position, in buffer coordinates + + + + y position, in buffer coordinates + + + + + + Retrieves the iterator pointing to the character at buffer +coordinates @x and @y. Buffer coordinates are coordinates for +the entire buffer, not just the currently-displayed portion. +If you have coordinates from an event, you have to convert +those to buffer coordinates with +gtk_text_view_window_to_buffer_coords(). +Note that this is different from gtk_text_view_get_iter_at_location(), +which returns cursor locations, i.e. positions <emphasis>between</emphasis> +characters. + + + + + + a #GtkTextIter + + + + if non-%NULL, location to store an integer indicating where in the grapheme the user clicked. It will either be zero, or the number of characters in the grapheme. 0 represents the trailing edge of the grapheme. + + + + x position, in buffer coordinates + + + + y position, in buffer coordinates + + + + + + Gets a rectangle which roughly contains the character at @iter. +The rectangle position is in buffer coordinates; use +gtk_text_view_buffer_to_window_coords() to convert these +coordinates to coordinates for one of the windows in the text view. + + + + + + a #GtkTextIter + + + + bounds of the character at @iter + + + + + + Gets the default justification of paragraphs in @text_view. +Tags in the buffer may override the default. + + default justification + + + + + Gets the default left margin size of paragraphs in the @text_view. +Tags in the buffer may override the default. + + left margin in pixels + + + + + Gets the #GtkTextIter at the start of the line containing +the coordinate @y. @y is in buffer coordinates, convert from +window coordinates with gtk_text_view_window_to_buffer_coords(). +If non-%NULL, @line_top will be filled with the coordinate of the top +edge of the line. + + + + + + a #GtkTextIter + + + + a y coordinate + + + + return location for top coordinate of the line + + + + + + Gets the y coordinate of the top of the line containing @iter, +and the height of the line. The coordinate is a buffer coordinate; +convert to window coordinates with gtk_text_view_buffer_to_window_coords(). + + + + + + a #GtkTextIter + + + + return location for a y coordinate + + + + return location for a height + + + + + + Returns whether the #GtkTextView is in overwrite mode or not. + + whether @text_view is in overwrite mode or not. + + + + + Gets the default number of pixels to put above paragraphs. + + default number of pixels above paragraphs + + + + + Gets the value set by gtk_text_view_set_pixels_below_lines(). + + default number of blank pixels below paragraphs + + + + + Gets the value set by gtk_text_view_set_pixels_inside_wrap(). + + default number of pixels of blank space between wrapped lines + + + + + Gets the default right margin for text in @text_view. Tags +in the buffer may override the default. + + right margin in pixels + + + + + Gets the default tabs for @text_view. Tags in the buffer may +override the defaults. The returned array will be %NULL if +"standard" (8-space) tabs are used. Free the return value +with pango_tab_array_free(). +tabs are used; must be freed with pango_tab_array_free(). + + copy of default tab array, or %NULL if "standard" + + + + + Gets the vertical-scrolling #GtkAdjustment. + + pointer to the vertical #GtkAdjustment + + + + + Fills @visible_rect with the currently-visible +region of the buffer, in buffer coordinates. Convert to window coordinates +with gtk_text_view_buffer_to_window_coords(). + + + + + + rectangle to fill + + + + + + Retrieves the #GdkWindow corresponding to an area of the text view; +possible windows include the overall widget window, child windows +on the left, right, top, bottom, and the window that displays the +text buffer. Windows are %NULL and nonexistent if their width or +height is 0, and are nonexistent before the widget has been +realized. + + a #GdkWindow, or %NULL + + + + + window to get + + + + + + Usually used to find out which window an event corresponds to. +If you connect to an event signal on @text_view, this function +should be called on <literal>event-&gt;window</literal> to +see which window it was. + + the window type. + + + + + a window type + + + + + + Gets the line wrapping for the view. + + the line wrap setting + + + + + Allow the #GtkTextView input method to internally handle key press +and release events. If this function returns %TRUE, then no further +processing should be done for this key event. See +gtk_im_context_filter_keypress(). +Note that you are expected to call this function from your handler +when overriding key event handling. This is needed in the case when +you need to insert your own key handling between the input method +and the default key event handling of the #GtkTextView. +|[ +static gboolean +gtk_foo_bar_key_press_event (GtkWidget *widget, +GdkEventKey *event) +{ +if ((key->keyval == GDK_Return || key->keyval == GDK_KP_Enter)) +{ +if (gtk_text_view_im_context_filter_keypress (GTK_TEXT_VIEW (view), event)) +return TRUE; +} +/&ast; Do some stuff &ast;/ +return GTK_WIDGET_CLASS (gtk_foo_bar_parent_class)->key_press_event (widget, event); +} +]| + + %TRUE if the input method handled the key event. + + + + + the key event + + + + + + Updates the position of a child, as for gtk_text_view_add_child_in_window(). + + + + + + child widget already added to the text view + + + + new X position in window coordinates + + + + new Y position in window coordinates + + + + + + Moves a mark within the buffer so that it's +located within the currently-visible text area. + + %TRUE if the mark moved (wasn't already onscreen) + + + + + a #GtkTextMark + + + + + + Move the iterator a given number of characters visually, treating it as the strong cursor position. If @count is positive, then the new strong cursor position will be @count positions to the right of the old cursor position. If @count is negative then the new strong @@ -62312,633 +56128,552 @@ cursor position. In the presence of bi-directional text, the correspondence between logical and visual order will depend on the direction of the current run, and there may be jumps when the cursor -is moved off of the end of a run."> +is moved off of the end of a run. - + %TRUE if @iter moved and is not on the end iterator + + a #GtkTextIter - + number of characters to move (negative moves left, positive moves right) + - + + Moves the cursor to the currently visible region of the +buffer, it it isn't there already. + + %TRUE if the cursor had to be moved. + + + + + Reset the input method context of the text view if needed. +This can be necessary in the case where modifying the buffer +would confuse on-going input method behavior. + + + + + + Scrolls @text_view the minimum distance such that @mark is contained +within the visible area of the widget. - - - - - + + a mark in the buffer for @text_view + - + + Scrolls @text_view so that @iter is on the screen in the position +indicated by @xalign and @yalign. An alignment of 0.0 indicates +left or top, 1.0 indicates right or bottom, 0.5 means center. +If @use_align is %FALSE, the text scrolls the minimal distance to +get the mark onscreen, possibly not scrolling at all. The effective +screen for purposes of this function is reduced by a margin of size +Note that this function uses the currently-computed height of the +lines in the text buffer. Line heights are computed in an idle +handler; so this function may not have the desired effect if it's +called before the height computations. To avoid oddness, consider +using gtk_text_view_scroll_to_mark() which saves a point to be +scrolled to after line validation. + + %TRUE if scrolling occurred + + + + + a #GtkTextIter + + + + margin as a [0.0,0.5) fraction of screen size + + + + whether to use alignment arguments (if %FALSE, just get the mark onscreen) + + + + horizontal alignment of mark within visible area + + + + vertical alignment of mark within visible area + + + + + + Scrolls @text_view so that @mark is on the screen in the position +indicated by @xalign and @yalign. An alignment of 0.0 indicates +left or top, 1.0 indicates right or bottom, 0.5 means center. +If @use_align is %FALSE, the text scrolls the minimal distance to +get the mark onscreen, possibly not scrolling at all. The effective +screen for purposes of this function is reduced by a margin of size - - + + a #GtkTextMark + - - + + margin as a [0.0,0.5) fraction of screen size + - - + + whether to use alignment arguments (if %FALSE, just get the mark onscreen) + - - + + horizontal alignment of mark within visible area + + + + vertical alignment of mark within visible area + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the behavior of the text widget when the Tab key is pressed. +If @accepts_tab is %TRUE, a tab character is inserted. If @accepts_tab +is %FALSE the keyboard focus is moved to the next widget in the focus +chain. - + %TRUE if pressing the Tab key should insert a tab character, %FALSE, if pressing the Tab key should move the keyboard focus. + - - - - - - + + Sets the width of %GTK_TEXT_WINDOW_LEFT or %GTK_TEXT_WINDOW_RIGHT, +or the height of %GTK_TEXT_WINDOW_TOP or %GTK_TEXT_WINDOW_BOTTOM. +Automatically destroys the corresponding window if the size is set +to 0, and creates the window if the size is set to non-zero. This +function can only be used for the "border windows," it doesn't work +with #GTK_TEXT_WINDOW_WIDGET, #GTK_TEXT_WINDOW_TEXT, or +#GTK_TEXT_WINDOW_PRIVATE. - - + + window to affect + + + + width or height of the window + - - - - - - + + Sets @buffer as the buffer being displayed by @text_view. The previous +buffer displayed by the text view is unreferenced, and a reference is +added to @buffer. If you owned a reference to @buffer before passing it +to this function, you must remove that reference yourself; #GtkTextView +will not "adopt" it. - - + + a #GtkTextBuffer + - - - - - - + + Toggles whether the insertion point is displayed. A buffer with no editable +text probably shouldn't have a visible cursor, so you may want to turn +the cursor off. - - + + whether to show the insertion cursor + - - - - - - + + Sets the default editability of the #GtkTextView. You can override +this default setting with tags in the buffer, using the "editable" +attribute of tags. - - + + whether it's editable + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the default indentation for paragraphs in @text_view. +Tags in the buffer may override the default. - + indentation in pixels + - + + Sets the default justification of text in @text_view. +Tags in the view's buffer may override the default. - + + + + justification + + + - + + Sets the default left margin for text in @text_view. +Tags in the buffer may override the default. + + + + + + left margin in pixels + + + + + + Changes the #GtkTextView overwrite mode. + + + + + + %TRUE to turn on overwrite mode, %FALSE to turn it off + + + + + + Sets the default number of blank pixels above paragraphs in @text_view. +Tags in the buffer for @text_view may override the defaults. + + + + + + pixels above paragraphs + + + + + + Sets the default number of pixels of blank space +to put below paragraphs in @text_view. May be overridden +by tags applied to @text_view's buffer. + + + + + + pixels below paragraphs + + + + + + Sets the default number of pixels of blank space to leave between +display/wrapped lines within a paragraph. May be overridden by +tags in @text_view's buffer. + + + + + + default number of pixels between wrapped lines + + + + + + Sets the default right margin for text in the text view. +Tags in the buffer may override the default. + + + + + + right margin in pixels + + + + + + Sets the default tab stops for paragraphs in @text_view. +Tags in the buffer may override the default. + tabs as a #PangoTabArray - - - + + Sets the line wrapping for the view. + + + + + a #GtkWrapMode + + + - - - + + Determines whether @iter is at the start of a display line. +See gtk_text_view_forward_display_line() for an explanation of +display lines vs. paragraphs. + + %TRUE if @iter begins a wrapped line + + + + a #GtkTextIter + + + - - + + Converts coordinates on the window identified by @win to buffer +coordinates, storing the result in (@buffer_x,@buffer_y). +Note that you can't convert coordinates for a nonexisting window (see +gtk_text_view_set_border_window_size()). + + + + + + a #GtkTextWindowType except #GTK_TEXT_WINDOW_PRIVATE + + + + window x coordinate + + + + window y coordinate + + + + buffer x coordinate return location or %NULL + + + + buffer y coordinate return location or %NULL + + + + + + - - + + - - + + - - + + + Which IM (input method) module should be used for this entry. See #GtkIMContext. Setting this to a non-%NULL value overrides the -system-wide IM module setting. See the GtkSettings -#GtkSettings:gtk-im-module property."> - +system-wide IM module setting. See the GtkSettings +#GtkSettings:gtk-im-module property. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The ::backspace signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user asks for it. The default bindings for this signal are -Backspace and Shift-Backspace."> - - +Backspace and Shift-Backspace. + + - + The ::copy-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to copy the selection to the clipboard. The default bindings for this signal are -Ctrl-c and Ctrl-Insert."> - - +Ctrl-c and Ctrl-Insert. + + - + The ::cut-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to cut the selection to the clipboard. The default bindings for this signal are -Ctrl-x and Shift-Delete."> - - +Ctrl-x and Shift-Delete. + + - + The ::delete-from-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user initiates a text deletion. If the @type is %GTK_DELETE_CHARS, GTK+ deletes the selection if there is one, otherwise it deletes the requested number of characters. The default bindings for this signal are -Delete for deleting a character, Ctrl-Delete for -deleting a word and Ctrl-Backspace for deleting a word -backwords."> - - +Delete for deleting a character, Ctrl-Delete for +deleting a word and Ctrl-Backspace for deleting a word +backwords. + + - - + + the granularity of the deletion, as a #GtkDeleteType + - - + + the number of @type units to delete + - + The ::insert-at-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted when the user initiates the insertion of a fixed string at the cursor. -This signal has no default bindings."> - - +This signal has no default bindings. + + - - + + the string to insert + - + The ::move-cursor signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted when the user initiates a cursor movement. If the cursor is not visible in @text_view, this signal causes the viewport to be moved instead. -Applications should not connect to it, but may emit it with +Applications should not connect to it, but may emit it with g_signal_emit_by_name() if they need to control the cursor programmatically. The default bindings for this signal come in two variants, @@ -62951,158 +56686,145 @@ There are too many key combinations to list them all here. <listitem>Home/End keys move to the ends of the buffer</listitem> <listitem>PageUp/PageDown keys move vertically by pages</listitem> <listitem>Ctrl-PageUp/PageDown keys move horizontally by pages</listitem> -</itemizedlist>"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +</itemizedlist> + + - + the granularity of the move, as a #GtkMovementStep + - + the number of @step units to move + + + + %TRUE if the move should extend the selection + - - - + + The ::move-viewport signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which can be bound to key combinations to allow the user +to move the viewport, i.e. change what part of the text view +is visible in a containing scrolled window. +There are no default bindings for this signal. + + + + + + the granularity of the move, as a #GtkMovementStep + + + + the number of @step units to move + + + + + + The ::paste-clipboard signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to paste the contents of the clipboard +into the text view. +The default bindings for this signal are +Ctrl-v and Shift-Insert. + + - + The ::populate-popup signal gets emitted before showing the +context menu of the text view. +If you need to add items to the context menu, connect +to this signal and append your menuitems to the @menu. + + + + + + the menu that is being populated + + + + + + If an input method is used, the typed text will not immediately +be committed to the buffer. So if you are interested in the text, +connect to this signal. +This signal is only emitted if the text at the given position +is actually editable. + + + + + + the current preedit string + + + + + + The ::select-all signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to select or unselect the complete +contents of the text view. +The default bindings for this signal are Ctrl-a and Ctrl-/ +for selecting and Shift-Ctrl-a and Ctrl-\ for unselecting. + + + + + + %TRUE to select, %FALSE to unselect + + + + + + The ::set-anchor signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted when the user initiates setting the "anchor" +mark. The "anchor" mark gets placed at the same position as the +"insert" mark. +This signal has no default bindings. + + + + + + + + + + + + + + + + + + + The ::toggle-cursor-visible signal is a +<link linkend="keybinding-signals">keybinding signal</link> +which gets emitted to toggle the visibility of the cursor. +The default binding for this signal is F7. + + + + + + The ::toggle-overwrite signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted to toggle the overwrite mode of the text view. -The default bindings for this signal is Insert."> - - +The default bindings for this signal is Insert. + + @@ -63113,8 +56835,7 @@ The default bindings for this signal is Insert."> - + @@ -63132,7 +56853,7 @@ The default bindings for this signal is Insert."> - + @@ -63147,7 +56868,7 @@ The default bindings for this signal is Insert."> - + @@ -63159,34 +56880,16 @@ The default bindings for this signal is Insert."> - + - - - - - - - - - - - - - - - - - - - + - + @@ -63198,7 +56901,7 @@ The default bindings for this signal is Insert."> - + @@ -63213,7 +56916,7 @@ The default bindings for this signal is Insert."> - + @@ -63225,13 +56928,13 @@ The default bindings for this signal is Insert."> - + - + @@ -63243,7 +56946,7 @@ The default bindings for this signal is Insert."> - + @@ -63255,7 +56958,7 @@ The default bindings for this signal is Insert."> - + @@ -63267,7 +56970,7 @@ The default bindings for this signal is Insert."> - + @@ -63279,7 +56982,7 @@ The default bindings for this signal is Insert."> - + @@ -63291,7 +56994,7 @@ The default bindings for this signal is Insert."> - + @@ -63305,57 +57008,57 @@ The default bindings for this signal is Insert."> - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + c:identifier="GTK_TEXT_WINDOW_BOTTOM" glib:nick="bottom"/> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Creates a new #GtkToggleAction object. To add the action to +a #GtkActionGroup and set the accelerator for the action, +call gtk_action_group_add_action_with_accel(). + a new #GtkToggleAction + A unique name for the action - + + The label displayed in menu items and on buttons, or %NULL - + + A tooltip for the action, or %NULL + The stock icon to display in widgets representing the action, or %NULL - + Returns the checked state of the toggle action. - + the checked state of the toggle action + + + + + Returns whether the action should have proxies like a radio action. + + whether the action should have proxies like a radio action. + + Sets the checked state on the toggle action. - + whether the action should be checked or not + - - - - - + Sets whether the action should have proxies like a radio action. - + whether the action should have proxies like a radio action + - + Emits the "toggled" signal on the toggle action. - + - + transfer-ownership="none"> + Whether the toggle action should be active. + - - + + Whether the proxies for this action look like radio action proxies. +This is an appearance property and thus only applies if +#GtkActivatable:use-action-appearance is %TRUE. + @@ -63733,8 +57206,10 @@ This is an appearance property and thus only applies if - - + Should be connected if you wish to perform an action +whenever the #GtkToggleAction state is changed. + + @@ -63745,7 +57220,7 @@ This is an appearance property and thus only applies if - + @@ -63756,29 +57231,29 @@ This is an appearance property and thus only applies if - - + + - - + + - - + + - - + + @@ -63786,6 +57261,8 @@ This is an appearance property and thus only applies if + #GtkToggleActionEntry structs are used with +gtk_action_group_add_toggle_actions() to construct toggle actions. @@ -63805,29 +57282,33 @@ This is an appearance property and thus only applies if - + - + - + + - - + + - - + + @@ -63836,44 +57317,41 @@ This is an appearance property and thus only applies if + Creates a new #GtkToggleButton containing a label. The label will be created using gtk_label_new_with_mnemonic(), so underscores -in @label indicate the mnemonic for the button."> - - +in @label indicate the mnemonic for the button. + + a new #GtkToggleButton + + the text of the button, with an underscore in front of the mnemonic character - + - + - - - - - - + + Gets the value set by gtk_toggle_button_set_inconsistent(). - + %TRUE if the button is displayed as inconsistent, %FALSE otherwise + + + + + Retrieves whether the button is displayed as a separate indicator +and label. See gtk_toggle_button_set_mode(). +and label. + + %TRUE if the togglebutton is drawn as a separate indicator + @@ -63882,70 +57360,75 @@ and label."> - + - + + If the user has selected a range of elements (such as some text or +spreadsheet cells) that are affected by a toggle button, and the +current values in that range are inconsistent, you may want to +display the toggle in an "in between" state. This function turns on +"in between" display. Normally you would turn off the inconsistent +state again if the user toggles the toggle button. This has to be +done manually, gtk_toggle_button_set_inconsistent() only affects +visual appearance, it doesn't affect the semantics of the button. - + + + + %TRUE if state is inconsistent + + + + + + Sets whether the button is displayed as a separate indicator and label. +You can call this function on a checkbutton or a radiobutton with +This function only affects instances of classes like #GtkCheckButton +and #GtkRadioButton that derive from #GtkToggleButton, +not instances of #GtkToggleButton itself. + + + + + + if %TRUE, draw the button as a separate indicator and label; if %FALSE, draw the button like a normal button + + + - - - - - - - - - - - - - - - - - + + - - + + - - + + - + - + - + - - + + @@ -63956,7 +57439,7 @@ visual appearance, it doesn't affect the semantics of the button."> - + @@ -63967,29 +57450,29 @@ visual appearance, it doesn't affect the semantics of the button."> - - + + - - + + - - + + - - + + @@ -63997,67 +57480,75 @@ visual appearance, it doesn't affect the semantics of the button."> - + + - - + Returns a new #GtkToggleToolButton + + a newly created #GtkToggleToolButton + + Creates a new #GtkToggleToolButton containing the image and text from a stock item. Some stock ids have preprocessor macros like #GTK_STOCK_OK and #GTK_STOCK_APPLY. -It is an error if @stock_id is not a name of a stock item." - version="2.4"> - - +It is an error if @stock_id is not a name of a stock item. + + A new #GtkToggleToolButton + + the name of the stock item + + Queries a #GtkToggleToolButton and returns its current state. +Returns %TRUE if the toggle button is pressed in and %FALSE if it is raised. + + %TRUE if the toggle tool button is pressed in, %FALSE if not + + + + Sets the status of the toggle tool button. Set to %TRUE if you +want the GtkToggleButton to be 'pressed in', and %FALSE to raise it. +This action causes the toggled signal to be emitted. - + whether @button should be active + - - - - - - + transfer-ownership="none"> + If the toggle tool button should be pressed in. + @@ -64066,10 +57557,10 @@ Returns %TRUE if the toggle button is pressed in and %FALSE if it is raised." - - - + + Emitted whenever the toggle tool button changes state. + + @@ -64080,7 +57571,7 @@ Returns %TRUE if the toggle button is pressed in and %FALSE if it is raised." - + @@ -64091,171 +57582,148 @@ Returns %TRUE if the toggle button is pressed in and %FALSE if it is raised." - - + + - - + + - - + + - - + + - + - + - - - + + + Creates a new %GtkToolButton using @icon_widget as icon and @label as +label. + + A new #GtkToolButton + + allow-none="1"> + a #GtkMisc widget that will be used as icon widget, or %NULL - + + a string that will be used as label, or %NULL + Creates a new #GtkToolButton containing the image and text from a stock item. Some stock ids have preprocessor macros like #GTK_STOCK_OK and #GTK_STOCK_APPLY. -It is an error if @stock_id is not a name of a stock item." - version="2.4"> - - +It is an error if @stock_id is not a name of a stock item. + + A new #GtkToolButton + + the name of the stock item - + - + + + + + Return the widget used as icon widget on @button. +See gtk_tool_button_set_icon_widget(). +on @button, or %NULL. + + The widget used as icon + - - - - - + Returns the label used by the tool button, or %NULL if the tool button +doesn't have a label. or uses a the label from a stock item. The returned +string is owned by GTK+, and must not be modified or freed. + The label, or %NULL - + Returns the widget used as label on @button. +See gtk_tool_button_set_label_widget(). +on @button, or %NULL. - + The widget used as label + - - - - - - - - - - - - - - - - - - - - + Returns the name of the stock item. See gtk_tool_button_set_stock_id(). +The returned string is owned by GTK+ and must not be freed or modifed. + the name of the stock item for @button. + + Returns whether underscores in the label property are used as mnemonics +on menu items on the overflow menu. See gtk_tool_button_set_use_underline(). +mnemonics on menu items on the overflow menu. + + %TRUE if underscores in the label property are used as + + + @@ -64267,90 +57735,121 @@ The returned string is owned by GTK+ and must not be freed or modifed." - - - - - + Sets @icon as the widget used as icon on @button. If @icon_widget is +%NULL the icon is determined by the "stock_id" property. If the +"stock_id" property is also %NULL, @button will not have an icon. + allow-none="1"> + the widget used as icon, or %NULL - - - + Sets @label as the label used for the tool button. The "label" property +only has an effect if not overridden by a non-%NULL "label_widget" property. +If both the "label_widget" and "label" properties are %NULL, the label +is determined by the "stock_id" property. If the "stock_id" property is also +%NULL, @button will not have a label. + + + + + a string that will be used as label, or %NULL. + + + + Sets @label_widget as the widget that will be used as the label +for @button. If @label_widget is %NULL the "label" property is used +as label. If "label" is also %NULL, the label in the stock item +determined by the "stock_id" property is used as label. If +"stock_id" is also %NULL, @button does not have a label. + allow-none="1"> + the widget used as label, or %NULL - - - + Sets the name of the stock item. See gtk_tool_button_new_from_stock(). +The stock_id property only has an effect if not +overridden by non-%NULL "label" and "icon_widget" properties. + + + + + a name of a stock item, or %NULL + + + + + + If set, an underline in the label property indicates that the next character +should be used for the mnemonic accelerator key in the overflow menu. For +example, if the label property is "_Open" and @use_underline is %TRUE, +the label on the tool button will be "Open" and the item on the overflow +menu will have an underlined 'O'. +Labels shown on tool buttons never have mnemonics on them; this property +only affects the menu item on the overflow menu. + + + + + + whether the button label has the form "_Open" + + + - + transfer-ownership="none"> + The name of the themed icon displayed on the item. +This property only has an effect if not overridden by "label", +"icon_widget" or "stock_id" properties. + - - + + - - + + - - + + - - + + - - + + @@ -64358,11 +57857,11 @@ This property only has an effect if not overridden by "label", - - - + + This signal is emitted when the tool button is clicked with the mouse +or activated with the keyboard. + + @@ -64376,7 +57875,7 @@ or activated with the keyboard."> - + @@ -64387,302 +57886,202 @@ or activated with the keyboard."> - - + + - - + + - - + + - - + + - + - + The GtkToolItem struct contains only private data. +It should only be accessed through the functions described below. + - - + + + Creates a new #GtkToolItem + + the new #GtkToolItem - + + Returns the ellipsize mode used for @tool_item. Custom subclasses of +#GtkToolItem should call this function to find out how text should +be ellipsized. +should be ellipsized. - + a #PangoEllipsizeMode indicating how text in @tool_item + - - - - - - - - - - - - - - - - - - - - + Returns whether @tool_item is allocated extra space. +See gtk_tool_item_set_expand(). - + %TRUE if @tool_item is allocated extra space. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns whether @tool_item is the same size as other homogeneous +items. See gtk_tool_item_set_homogeneous(). +items. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the item is the same size as other homogeneous + + Returns the icon size used for @tool_item. Custom subclasses of #GtkToolItem should call this function to find out what size icons they should use. -used for @tool_item" +used for @tool_item + + a #GtkIconSize indicating the icon size + + + + - - + Returns whether @tool_item is considered important. See +gtk_tool_item_set_is_important() + + %TRUE if @tool_item is considered important. + + Returns the orientation used for @tool_item. Custom subclasses of #GtkToolItem should call this function to find out what size icons they should use. -used for @tool_item" - version="2.4"> - +used for @tool_item + + a #GtkOrientation indicating the orientation + + If @menu_item_id matches the string passed to +gtk_tool_item_set_proxy_menu_item() return the corresponding #GtkMenuItem. +Custom subclasses of #GtkToolItem should use this function to +update their menu item when the #GtkToolItem changes. That the +will not inadvertently change a menu item that they did not create. +gtk_tool_item_set_proxy_menu_item(), if the @menu_item_id<!-- -->s +match. + + The #GtkMenuItem passed to + + + + + a string used to identify the menu item + + + + + + Returns the relief style of @tool_item. See gtk_button_set_relief_style(). +Custom subclasses of #GtkToolItem should call this function in the handler +of the #GtkToolItem::toolbar_reconfigured signal to find out the +relief style of buttons. +for @tool_item. + + a #GtkReliefStyle indicating the relief style used + + + + + Returns the text alignment used for @tool_item. Custom subclasses of +#GtkToolItem should call this function to find out how text should +be aligned. +used for @tool_item + + a #gfloat indicating the horizontal text alignment + + + + + Returns the text orientation used for @tool_item. Custom subclasses of +#GtkToolItem should call this function to find out how text should +be orientated. +used for @tool_item + + a #GtkOrientation indicating the text orientation + + + + + Returns the size group used for labels in @tool_item. +Custom subclasses of #GtkToolItem should call this function +and use the size group for labels. + + a #GtkSizeGroup + + + + Returns the toolbar style used for @tool_item. Custom subclasses of #GtkToolItem should call this function in the handler of the GtkToolItem::toolbar_reconfigured signal to find out in what style -the toolbar is displayed and change themselves accordingly +the toolbar is displayed and change themselves accordingly Possibilities are: <itemizedlist> <listitem> GTK_TOOLBAR_BOTH, meaning the tool item should show @@ -64692,138 +58091,240 @@ only icons </listitem> <listitem> GTK_TOOLBAR_TEXT, meaning the tool item should only show text</listitem> <listitem> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show -both an icon and a label, arranged horizontally (however, note the +both an icon and a label, arranged horizontally (however, note the #GtkToolButton::has_text_horizontally that makes tool buttons not show labels when the toolbar style is GTK_TOOLBAR_BOTH_HORIZ. </listitem> </itemizedlist> -for @tool_item." - version="2.4"> - +for @tool_item. + + A #GtkToolbarStyle indicating the toolbar style used - - - - - - + Returns whether @tool_item has a drag window. See +gtk_tool_item_set_use_drag_window(). - + %TRUE if @tool_item uses a drag window. + - - - + + Returns whether the @tool_item is visible on toolbars that are +docked horizontally. +docked horizontally. + + %TRUE if @tool_item is visible on toolbars that are + - - - + + Returns whether @tool_item is visible when the toolbar is docked vertically. +See gtk_tool_item_set_visible_vertical(). + + Whether @tool_item is visible when the toolbar is docked vertically + + + + + Calling this function signals to the toolbar that the +overflow menu item for @tool_item has changed. If the +overflow menu is visible when this function it called, +the menu will be rebuilt. +The function must be called when the tool item changes what it +will do in response to the #GtkToolItem::create-menu-proxy signal. + + + Returns the #GtkMenuItem that was last set by gtk_tool_item_set_proxy_menu_item(), ie. the #GtkMenuItem that is going to appear in the overflow menu. -overflow menu for @tool_item." - version="2.4"> - +overflow menu for @tool_item. + + The #GtkMenuItem that is going to appear in the - - - + Sets whether @tool_item is allocated extra space when there +is more room on the toolbar then needed for the items. The +effect is that the item gets bigger when the toolbar gets bigger +and smaller when the toolbar gets smaller. + + - - + + Whether @tool_item is allocated extra space + + + + + + Sets whether @tool_item is to be allocated the same size as other +homogeneous items. The effect is that all homogeneous items will have +the same width as the widest of the items. + + + + + + whether @tool_item is the same size as other homogeneous items + + + + + + Sets whether @tool_item should be considered important. The #GtkToolButton +class uses this property to determine whether to show or hide its label +when the toolbar style is %GTK_TOOLBAR_BOTH_HORIZ. The result is that +only tool buttons with the "is_important" property set have labels, an +effect known as "priority text" + + + + + + whether the tool item should be considered important + + Sets the #GtkMenuItem used in the toolbar overflow menu. The +should also be used with gtk_tool_item_get_proxy_menu_item(). + a string used to identify @menu_item + a #GtkMenuItem to be used in the overflow menu - + + Sets the markup text to be displayed as tooltip on the item. +See gtk_widget_set_tooltip_markup(). + + + markup text to be used as tooltip for @tool_item + + + + + + Sets the text to be displayed as tooltip on the item. +See gtk_widget_set_tooltip_text(). + + + + + + text to be used as tooltip for @tool_item + + + + + + Sets whether @tool_item has a drag window. When %TRUE the +toolitem can be used as a drag source through gtk_drag_source_set(). +When @tool_item has a drag window it will intercept all events, +even those that would otherwise be sent to a child of @tool_item. + + + + + + Whether @tool_item has a drag window. + + + + + + Sets whether @tool_item is visible when the toolbar is docked horizontally. + + + + + + Whether @tool_item is visible when in horizontal mode + + + + + + Sets whether @tool_item is visible when the toolbar is docked +vertically. Some tool items, such as text entries, are too wide to be +useful on a vertically docked toolbar. If @visible_vertical is %FALSE + + + + + + whether @tool_item is visible when the toolbar is in vertical mode + + + + Emits the signal #GtkToolItem::toolbar_reconfigured on @tool_item. +#GtkToolbar and other #GtkToolShell implementations use this function +to notify children, when some aspect of their configuration changes. - - + + - - + + - - + + @@ -64831,8 +58332,8 @@ to notify children, when some aspect of their configuration changes." - + This signal is emitted when the toolbar needs information from @tool_item about whether the item should appear in the toolbar overflow menu. In response the tool item should either <itemizedlist> @@ -64841,7 +58342,7 @@ pointer and return %TRUE to indicate that the item should not appear in the overflow menu </listitem> <listitem> call gtk_tool_item_set_proxy_menu_item() with a new menu -item and return %TRUE, or +item and return %TRUE, or </listitem> <listitem> return %FALSE to indicate that the signal was not handled by the item. This means that @@ -64852,35 +58353,14 @@ installs a menu item. The toolbar may cache the result of this signal. When the tool item changes how it will respond to this signal it must call gtk_tool_item_rebuild_menu() to invalidate the cache and ensure that the toolbar rebuilds its overflow -menu."> - - +menu. + + %TRUE if the signal was handled, %FALSE if not + - - - - - - - - - - - - - - - - - + This signal is emitted when some property of the toolbar that the item is a child of changes. For custom subclasses of #GtkToolItem, the default handler of this signal use the functions <itemizedlist> @@ -64890,9 +58370,9 @@ the default handler of this signal use the functions <listitem>gtk_tool_shell_get_relief_style()</listitem> </itemizedlist> to find out what the toolbar should look like and change -themselves accordingly."> - - +themselves accordingly. + + @@ -64903,9 +58383,9 @@ themselves accordingly."> - + - + @@ -64915,7 +58395,7 @@ themselves accordingly."> - + @@ -64926,50 +58406,29 @@ themselves accordingly."> - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + @@ -64977,239 +58436,262 @@ themselves accordingly."> + This should not be accessed directly. Use the accessor functions below. + - - + Creates a new tool item group with label @label. + + a new #GtkToolItemGroup. + + the label of the new group - + Gets whether @group is collapsed or expanded. - + %TRUE if @group is collapsed, %FALSE if it is expanded + + + + + Gets the tool item at position (x, y). + + the #GtkToolItem at position (x, y) + - - + + the x position + + + + the y position + - + Gets the ellipsization mode of @group. + + the #PangoEllipsizeMode of @group + + + + + Gets the relief mode of the header button of @group. + + the #GtkReliefStyle + + + + + Gets the position of @item in @group as index. + + the index of @item in @group or -1 if @item is no child of @group + + + + + a #GtkToolItem + + + + + + Gets the label of @group. +and must not be modified. Note that %NULL is returned if a custom +label has been set with gtk_tool_item_group_set_label_widget() + + the label of @group. The label is an internal string of @group + + + + + Gets the label widget of @group. +See gtk_tool_item_group_set_label_widget(). + + the label widget of @group + + + + + Gets the number of tool items in @group. + + the number of tool items in @group + + + + + Gets the tool item at @index in group. + + the #GtkToolItem at index + + + + + the index + + + + + + Inserts @item at @position in the list of children of @group. - - + + the #GtkToolItem to insert into @group + + + + the position of @item in @group, starting with 0. The position -1 means end of list. + + Sets whether the @group should be collapsed or expanded. - + whether the @group should be collapsed or expanded + + Sets the ellipsization mode which should be used by labels in @group. + the #PangoEllipsizeMode labels in @group should use + Set the button relief of the group header. +See gtk_button_set_relief() for details. + the #GtkReliefStyle - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the position of @item in the list of children of @group. + the #GtkToolItem to move to a new position, should be a child of @group. - + the new position of @item in @group, starting with 0. The position -1 means end of list. + - + Sets the label of the tool item group. The label is displayed in the header +of the group. - + - - + + the new human-readable label of of the group + - + Sets the label of the tool item group. +The label widget is displayed in the header of the group, in place +of the usual label. - - - - - - + - - + + the widget to be displayed in place of the usual label + - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + @@ -65225,333 +58707,367 @@ Sets the position of @item in the list of children of @group." - + - + + This should not be accessed directly. Use the accessor functions below. + - - + Creates a new tool palette. + + a new #GtkToolPalette + - - - - - + Get the target entry for a dragged #GtkToolItemGroup. + the #GtkTargetEntry for a dragged group - + Gets the target entry for a dragged #GtkToolItem. + + the #GtkTargetEntry for a dragged item. + + + + + Sets @palette as drag source (see gtk_tool_palette_set_drag_source()) +and sets @widget as a drag destination for drags from @palette. +See gtk_drag_dest_set(). - - + + a #GtkWidget which should be a drag destination for @palette + - - + + the flags that specify what actions GTK+ should take for drops on that widget + + + + the #GtkToolPaletteDragTarget<!-- -->s which the widget should support + + + + the #GdkDragAction<!-- -->s which the widget should suppport + - + Get the dragged item from the selection. +This could be a #GtkToolItem or a #GtkToolItemGroup. - + the dragged item in selection + - - - - - + + a #GtkSelectionData + - + Gets the group at position (x, y). +if there is no such group - + the #GtkToolItemGroup at position or %NULL + - - + + the x position + - - + + the y position + - + Gets the item at position (x, y). +See gtk_tool_palette_get_drop_group(). - + the #GtkToolItem at position or %NULL if there is no such item + - - + + the x position + + + + the y position + + Gets whether @group is exclusive or not. +See gtk_tool_palette_set_exclusive(). - + %TRUE if @group is exclusive + + a #GtkToolItemGroup which is a child of palette + Gets whether group should be given extra space. +See gtk_tool_palette_set_expand(). - + %TRUE if group should be given extra space, %FALSE otherwise + + a #GtkToolItemGroup which is a child of palette - + Gets the position of @group in @palette as index. +See gtk_tool_palette_set_group_position(). - + the index of group or -1 if @group is not a child of @palette + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GtkToolItemGroup + - + Gets the horizontal adjustment of the tool palette. + + the horizontal adjustment of @palette + + Gets the size of icons in the tool palette. +See gtk_tool_palette_set_icon_size(). + + the #GtkIconSize of icons in the tool palette + + + + + Gets the style (icons, text or both) of items in the tool palette. + + the #GtkToolbarStyle of items in the tool palette. + + + - + Gets the vertical adjustment of the tool palette. + + the vertical adjustment of @palette + + Sets the tool palette as a drag source. +Enables all groups and items in the tool palette as drag sources +on button 1 and button 3 press with copy and move actions. +See gtk_drag_source_set(). + + + + + + the #GtkToolPaletteDragTarget<!-- -->s which the widget should support + + + + + + Sets whether the group should be exclusive or not. +If an exclusive group is expanded all other groups are collapsed. + + + + + + a #GtkToolItemGroup which is a child of palette + + + + whether the group should be exclusive or not + + + + + + Sets whether the group should be given extra space. + + + + + + a #GtkToolItemGroup which is a child of palette + + + + whether the group should be given extra space + + + + + + Sets the position of the group as an index of the tool palette. +If position is 0 the group will become the first child, if position is +-1 it will become the last child. + + + + + + a #GtkToolItemGroup which is a child of palette + + + + a new index for group + + + + + + Sets the size of icons in the tool palette. + + + + + + the #GtkIconSize that icons in the tool palette shall have + + + + + + Sets the style (text, icons or both) of items in the tool palette. + + + + + + the #GtkToolbarStyle that items in the tool palette shall have + + + + + + Unsets the tool palette icon size set with gtk_tool_palette_set_icon_size(), +so that user preferences will be used to determine the icon size. + + + + + + Unsets a toolbar style set with gtk_tool_palette_set_style(), +so that user preferences will be used to determine the toolbar style. + + + + + The size of the icons in a tool palette is normally determined by the #GtkSettings:toolbar-icon-size setting. When this property is set, it overrides the setting. This should only be used for special-purpose tool palettes, normal application tool palettes should respect the user preferences for the -size of icons."> - +size of icons. + - + transfer-ownership="none"> + Is %TRUE if the #GtkToolPalette:icon-size property has been set. + - + transfer-ownership="none"> + The style of items in the tool palette. + @@ -65559,21 +59075,22 @@ size of icons."> - + Set the scroll adjustments for the viewport. Usually scrolled containers like GtkScrolledWindow will emit this signal to connect two instances of GtkScrollbar to the scroll -directions of the GtkToolpalette." - version="2.20"> - - +directions of the GtkToolpalette. + + - - + + The horizontal adjustment + - - + + The vertical adjustment + @@ -65585,8 +59102,7 @@ directions of the GtkToolpalette." - + @@ -65603,43 +59119,43 @@ directions of the GtkToolpalette." - - + + - - + + - - + + - - + + - - + + - - + + @@ -65647,10 +59163,10 @@ directions of the GtkToolpalette." + Flags used to specify the supported drag targets. - + + Dummy structure for accessing instances of #GtkToolShellIface. - - + + + + + + + - - + + Retrieves the current orientation for the tool shell. Tool items must not +call this function directly, but rely on gtk_tool_item_get_orientation() +instead. + + the current orientation of @shell - - - - - - - + + Returns the relief style of buttons on @shell. Tool items must not call this +function directly, but rely on gtk_tool_item_get_relief_style() instead. + + The relief style of buttons on @shell. - + + Retrieves whether the tool shell has text, icons, or both. Tool items must +not call this function directly, but rely on gtk_tool_item_get_style() +instead. + + the current style of @shell + + + + + Retrieves the current text alignment for the tool shell. Tool items must not +call this function directly, but rely on gtk_tool_item_get_text_alignment() +instead. + + the current text alignment of @shell + + + + + Retrieves the current text orientation for the tool shell. Tool items must not +call this function directly, but rely on gtk_tool_item_get_text_orientation() +instead. + + the current text orientation of @shell + + + + + Retrieves the current text size group for the tool shell. Tool items must not +call this function directly, but rely on gtk_tool_item_get_text_size_group() +instead. + + the current text size group of @shell + + + + + Calling this function signals the tool shell that the overflow menu item for +tool items have changed. If there is an overflow menu and if it is visible +when this function it called, the menu will be rebuilt. +Tool items must not call this function directly, but rely on +gtk_tool_item_rebuild_menu() instead. - - - - - - + - - - - - - - - - - - + - - + Retrieves the icon size for the tool shell. Tool items must not call this +function directly, but rely on gtk_tool_item_get_icon_size() instead. + + the current size for icons of @shell + + Retrieves the current orientation for the tool shell. Tool items must not call this function directly, but rely on gtk_tool_item_get_orientation() -instead." - version="2.14"> - +instead. + + the current orientation of @shell - - - - - - + Returns the relief style of buttons on @shell. Tool items must not call this +function directly, but rely on gtk_tool_item_get_relief_style() instead. + + The relief style of buttons on @shell. - + Retrieves whether the tool shell has text, icons, or both. Tool items must +not call this function directly, but rely on gtk_tool_item_get_style() +instead. - - - - - - + the current style of @shell + + Retrieves the current text alignment for the tool shell. Tool items must not call this function directly, but rely on gtk_tool_item_get_text_alignment() -instead." - version="2.14"> +instead. - + the current text alignment of @shell + - - - + + Retrieves the current text orientation for the tool shell. Tool items must not +call this function directly, but rely on gtk_tool_item_get_text_orientation() +instead. + + the current text orientation of @shell + + Retrieves the current text size group for the tool shell. Tool items must not call this function directly, but rely on gtk_tool_item_get_text_size_group() -instead." - version="2.14"> - +instead. + + the current text size group of @shell + + Calling this function signals the tool shell that the overflow menu item for +tool items have changed. If there is an overflow menu and if it is visible +when this function it called, the menu will be rebuilt. +Tool items must not call this function directly, but rely on +gtk_tool_item_rebuild_menu() instead. + + + + + glib:is-gtype-struct-for="ToolShell"> + Virtual function table for the #GtkToolShell interface. - - + + @@ -65823,8 +59387,9 @@ instead." - - + + + the current orientation of @shell @@ -65835,8 +59400,9 @@ instead." - - + + + the current style of @shell @@ -65847,8 +59413,9 @@ instead." - - + + + The relief style of buttons on @shell. @@ -65859,7 +59426,7 @@ instead." - + @@ -65871,8 +59438,9 @@ instead." - - + + + the current text orientation of @shell @@ -65883,9 +59451,10 @@ instead." - + - + the current text alignment of @shell + @@ -65895,8 +59464,8 @@ instead." - - + + @@ -65907,8 +59476,9 @@ instead." - - + + + the current text size group of @shell @@ -65920,6 +59490,7 @@ instead." + - - - + + Creates a new toolbar. + + the newly-created toolbar. + - + Returns the position corresponding to the indicated point on +this function returns the position a new item should be +inserted. - + The position corresponding to the point (@x, @y) on the toolbar. + - - + + x coordinate of a point on the toolbar + - - + + y coordinate of a point on the toolbar + + + Retrieves the icon size for the toolbar. See gtk_toolbar_set_icon_size(). +the toolbar. + + the current icon size for the icons on + + + + Returns the position of @item on the toolbar, starting from 0. +It is an error if @item is not a child of the toolbar. - + the position of item on the toolbar. + + a #GtkToolItem that is a child of @toolbar + Returns the number of items on the toolbar. - + the number of items on the toolbar + - + Returns the @n<!-- -->'th item on @toolbar, or %NULL if the +toolbar does not contain an @n<!-- -->'th item. +or %NULL if there isn't an @n<!-- -->'th item. + + The @n<!-- -->'th #GtkToolItem on @toolbar, - + A position on the toolbar + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns the relief style of buttons on @toolbar. See +gtk_button_set_relief(). + + The relief style of buttons on @toolbar. - - - + Returns whether the toolbar has an overflow menu. +See gtk_toolbar_set_show_arrow(). + + %TRUE if the toolbar has an overflow menu. + + + + + Retrieves whether the toolbar has text, icons, or both . See +gtk_toolbar_set_style(). + + the current style of @toolbar + + + + + Insert a #GtkToolItem into the toolbar at position @pos. If @pos is +0 the item is prepended to the start of the toolbar. If @pos is +negative, the item is appended to the end of the toolbar. + + - - + + a #GtkToolItem + - - + + the position of the new item + + Highlights @toolbar to give an idea of what it would look like if @item was added to @toolbar at the position indicated by @index_. -If @item is %NULL, highlighting is turned off. In that case @index_ +If @item is %NULL, highlighting is turned off. In that case @index_ is ignored. The @tool_item passed to this function must not be part of any widget hierarchy. When an item is set as drop highlight item it can not added to any widget hierarchy or used as highlight item for another -toolbar." - version="2.4"> +toolbar. - + + a #GtkToolItem, or %NULL to turn of highlighting - + a position on @toolbar + - - - - - - + + This function sets the size of stock icons in the toolbar. You +can call it both before you add the icons and after they've been +added. The size you set will override user preferences for the default +icon size. +This should only be used for special-purpose toolbars, normal +application toolbars should respect the user preferences for the +size of icons. - - + + The #GtkIconSize that stock icons in the toolbar shall have. + - - - - - - + + Sets whether to show an overflow menu when +items that there are not room are available through an +overflow menu. - - + + Whether to show an overflow menu + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Alters the view of @toolbar to display either icons only, text only, or both. - - + + the new style for @toolbar. + - + + Unsets toolbar icon size set with gtk_toolbar_set_icon_size(), so that +user preferences will be used to determine the icon size. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Unsets a toolbar style set with gtk_toolbar_set_style(), so that +user preferences will be used to determine the toolbar style. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The size of the icons in a toolbar is normally determined by +the toolbar-icon-size setting. When this property is set, it +overrides the setting. This should only be used for special-purpose toolbars, normal application toolbars should respect the user preferences for the -size of icons."> - +size of icons. + - + transfer-ownership="none"> + Is %TRUE if the icon-size property has been set. + - - + + - - - - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + A keybinding signal used internally by GTK+. This signal can't +be used in application code + + %TRUE if the signal was handled, %FALSE if not + - - + + %TRUE if the first item should be focused + - - - + + Emitted when the orientation of the toolbar changes. + + - - + + the new #GtkOrientation of the toolbar + - + Emitted when the user right-clicks the toolbar or uses the keybinding to display a popup menu. Application developers should handle this signal if they want to display a context menu on the toolbar. The context-menu should appear at the coordinates given by @x and @y. The mouse button number is given by the @button parameter. If the menu was popped -up using the keybaord, @button is -1."> - - +up using the keybaord, @button is -1. + + return %TRUE if the signal was handled, %FALSE if not + - - + + the x coordinate of the point where the menu should appear + - - + + the y coordinate of the point where the menu should appear + - - + + the mouse button the user pressed, or -1 + - - - + + Emitted when the style of the toolbar changes. + + - - + + the new #GtkToolbarStyle of the toolbar + - - - - - - - - - - - - - - - - - - - - - @@ -66764,7 +59815,7 @@ up using the keybaord, @button is -1."> - + @@ -66779,7 +59830,7 @@ up using the keybaord, @button is -1."> - + @@ -66794,49 +59845,49 @@ up using the keybaord, @button is -1."> - + - + - + - + - + - - + + - - + + - - + + - + glib:nick="both-horiz"/> + Triggers a new tooltip query on @display, in order to update the current visible tooltip, or to show/hide the current tooltip. This function is useful to call when, for example, the state of the widget changed by a -key press." - version="2.12"> +key press. + a #GdkDisplay - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Replaces the widget packed into the tooltip with +away. +By default a box with a #GtkImage and #GtkLabel is embedded in +the tooltip, which can be configured using gtk_tooltip_set_markup() +and gtk_tooltip_set_icon(). + allow-none="1"> + a #GtkWidget, or %NULL to unset the old custom widget. + + Sets the icon of the tooltip (which is in front of the text) to be + + + + + + a #GdkPixbuf, or %NULL + + + + + + Sets the icon of the tooltip (which is in front of the text) +to be the icon indicated by @gicon with the size indicated +by @size. If @gicon is %NULL, the image will be hidden. + + + + + + a #GIcon representing the icon, or %NULL + + + + a stock icon size + + + + + + Sets the icon of the tooltip (which is in front of the text) to be +the icon indicated by @icon_name with the size indicated +by @size. If @icon_name is %NULL, the image will be hidden. + + + + + + an icon name, or %NULL + + + + a stock icon size + + + + + + Sets the icon of the tooltip (which is in front of the text) to be +the stock item indicated by @stock_id with the size indicated +by @size. If @stock_id is %NULL, the image will be hidden. + + + + + + a stock id, or %NULL + + + + a stock icon size + + + + + + Sets the text of the tooltip to be @markup, which is marked up +with the <link +linkend="PangoMarkupFormat">Pango text markup language</link>. +If @markup is %NULL, the label will be hidden. + + + + + + a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) or %NULL + + + + + + Sets the text of the tooltip to be @text. If @text is %NULL, the label +will be hidden. See also gtk_tooltip_set_markup(). + + + + + + a text string or %NULL + + + + + Sets the area of the widget, where the contents of this tooltip apply, to be @rect (in widget coordinates). This is especially useful for properly setting tooltips on #GtkTreeView rows and cells, #GtkIconViews, etc. For setting tooltips on #GtkTreeView, please refer to the convenience -gtk_tree_view_set_tooltip_cell()." - version="2.12"> +gtk_tree_view_set_tooltip_cell(). + a #GdkRectangle - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -67241,7 +60101,7 @@ applications should have little use for it." - + @@ -67263,7 +60123,7 @@ applications should have little use for it." - + @@ -67279,78 +60139,101 @@ applications should have little use for it." - + - + + Asks the #GtkTreeDragDest to insert a row before the path @dest, +deriving the contents of the row from @selection_data. If @dest is +outside the tree so that inserting before it is impossible, %FALSE +will be returned. Also, %FALSE may be returned if the new row is +not created for some model-specific reason. Should robustly handle +a @dest no longer found in the model! - + whether a new row was created before position @dest + + row to drop in front of + data to drop + Determines whether a drop is possible before the given @dest_path, +at the same depth as @dest_path. i.e., can we drop the data in +exist; the return value will almost certainly be %FALSE if the +parent of @dest_path doesn't exist, though. - + %TRUE if a drop is possible before @dest_path + + destination row + the data being dragged + Asks the #GtkTreeDragDest to insert a row before the path @dest, deriving the contents of the row from @selection_data. If @dest is outside the tree so that inserting before it is impossible, %FALSE will be returned. Also, %FALSE may be returned if the new row is not created for some model-specific reason. Should robustly handle -a @dest no longer found in the model!"> +a @dest no longer found in the model! - + whether a new row was created before position @dest + + row to drop in front of + data to drop + Determines whether a drop is possible before the given @dest_path, at the same depth as @dest_path. i.e., can we drop the data in exist; the return value will almost certainly be %FALSE if the -parent of @dest_path doesn't exist, though."> +parent of @dest_path doesn't exist, though. - + %TRUE if a drop is possible before @dest_path + + destination row + the data being dragged @@ -67363,36 +60246,42 @@ parent of @dest_path doesn't exist, though."> - + - + whether a new row was created before position @dest + + row to drop in front of + data to drop - + - + %TRUE if a drop is possible before @dest_path + + destination row + the data being dragged @@ -67400,91 +60289,118 @@ parent of @dest_path doesn't exist, though."> - + + Asks the #GtkTreeDragSource to delete the row at @path, because +it was moved somewhere else via drag-and-drop. Returns %FALSE +if the deletion fails because @path no longer exists, or for +some model-specific reason. Should robustly handle a @path no +longer found in the model! - + %TRUE if the row was successfully deleted + + row that was being dragged + Asks the #GtkTreeDragSource to fill in @selection_data with a +representation of the row at @path. @selection_data->target gives +the required type of the data. Should robustly handle a @path no +longer found in the model! - + %TRUE if data of the required type was provided + + row that was dragged + a #GtkSelectionData to fill with data from the dragged row - + + Asks the #GtkTreeDragSource whether a particular row can be used as +the source of a DND operation. If the source doesn't implement +this interface, the row is assumed draggable. - + %TRUE if the row can be dragged + + row on which user is initiating a drag - - - - - - - - - - + Asks the #GtkTreeDragSource to delete the row at @path, because it was moved somewhere else via drag-and-drop. Returns %FALSE if the deletion fails because @path no longer exists, or for some model-specific reason. Should robustly handle a @path no -longer found in the model!"> +longer found in the model! - + %TRUE if the row was successfully deleted + + row that was being dragged + Asks the #GtkTreeDragSource to fill in @selection_data with a representation of the row at @path. @selection_data->target gives the required type of the data. Should robustly handle a @path no -longer found in the model!"> +longer found in the model! - + %TRUE if data of the required type was provided + + row that was dragged + a #GtkSelectionData to fill with data from the dragged row + + Asks the #GtkTreeDragSource whether a particular row can be used as +the source of a DND operation. If the source doesn't implement +this interface, the row is assumed draggable. + + %TRUE if the row can be dragged + + + + + row on which user is initiating a drag + + + + - + - + %TRUE if the row can be dragged + + row on which user is initiating a drag - + - + %TRUE if data of the required type was provided + + row that was dragged + a #GtkSelectionData to fill with data from the dragged row - + - + %TRUE if the row was successfully deleted + + row that was being dragged @@ -67544,34 +60467,34 @@ longer found in the model!"> + glib:get-type="gtk_tree_iter_get_type" + c:symbol-prefix="tree_iter"> - + - + - + - + - + Creates a dynamically allocated tree iterator as a copy of @iter. +This function is not intended for use in applications, because you +can just copy the structs by value (<literal>GtkTreeIter new_iter = iter;</literal>). -You must free this iter with gtk_tree_iter_free()."> +You must free this iter with gtk_tree_iter_free(). + a newly-allocated copy of @iter. - + + Frees an iterator that has been allocated by gtk_tree_iter_copy(). +This function is mainly used for language bindings. @@ -67579,7 +60502,7 @@ This function is mainly used for language bindings."> - + @@ -67592,447 +60515,312 @@ This function is mainly used for language bindings."> - + - - - - - - - - - - + Returns the type of the column. + The type of the column. - + The column index. + - + + Returns a set of flags supported by this interface. The flags are a bitwise +combination of #GtkTreeModelFlags. The flags supported should not change +during the lifecycle of the @tree_model. - + The flags supported by this interface. + + + + + Sets @iter to a valid iterator pointing to @path. + + %TRUE, if @iter was set. + - + + The uninitialized #GtkTreeIter. + The #GtkTreePath. + + Returns the number of columns supported by @tree_model. + + The number of columns. + + + + Returns a newly-created #GtkTreePath referenced by @iter. This path should +be freed with gtk_tree_path_free(). + a newly-created #GtkTreePath. + The #GtkTreeIter. + Initializes and sets @value to that at @column. +When done with @value, g_value_unset() needs to be called +to free any allocated memory. + The #GtkTreeIter. - + The column to lookup the value at. + - + + An empty #GValue to set. - - - - - - - - - - + Sets @iter to point to the first child of @parent. If @parent has no +children, %FALSE is returned and @iter is set to be invalid. @parent +will remain a valid node after this function has been called. +If @parent is %NULL returns the first node, equivalent to +<literal>gtk_tree_model_get_iter_first (tree_model, iter);</literal> - + %TRUE, if @child has been set to the first child. + - + + The new #GtkTreeIter to be set to the child. - + + The #GtkTreeIter, or %NULL + Returns %TRUE if @iter has children, %FALSE otherwise. - + %TRUE if @iter has children. + + The #GtkTreeIter to test for children. + Returns the number of children that @iter has. As a special case, if @iter +is %NULL, then the number of toplevel nodes is returned. - + The number of children of @iter. + + + + + The #GtkTreeIter, or %NULL. + + + + + + Sets @iter to point to the node following it at the current level. If there +is no next @iter, %FALSE is returned and @iter is set to be invalid. + + %TRUE if @iter has been changed to the next node. + + The #GtkTreeIter. + Sets @iter to be the child of @parent, using the given index. The first +index is 0. If @n is too big, or @parent has no children, @iter is set +to an invalid iterator and %FALSE is returned. @parent will remain a valid +node after this function has been called. As a special case, if @parent is +%NULL, then the @n<!-- -->th root node is set. - + %TRUE, if @parent has an @n<!-- -->th child. + - + + The #GtkTreeIter to set to the nth child. - + + The #GtkTreeIter to get the child from, or %NULL. - + Then index of the desired child. + + Sets @iter to be the parent of @child. If @child is at the toplevel, and +doesn't have a parent, then @iter is set to an invalid iterator and %FALSE +is returned. @child will remain a valid node after this function has been +called. - + %TRUE, if @iter is set to the parent of @child. + - + + The new #GtkTreeIter to set to the parent. + The #GtkTreeIter. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Lets the tree ref the node. This is an optional method for models to implement. To be more specific, models may ignore this call as it exists primarily for performance reasons. -This function is primarily meant as a way for views to let caching model +This function is primarily meant as a way for views to let caching model know when nodes are being displayed (and hence, whether or not to cache that node.) For example, a file-system based model would not want to keep the entire file-hierarchy in memory, just the sections that are currently being displayed by every current view. A model should be expected to be able to get an iter independent of its -reffed state."> +reffed state. + The #GtkTreeIter. - - + Lets the tree unref the node. This is an optional method for models to implement. To be more specific, models may ignore this call as it exists primarily for performance reasons. For more information on what this means, see gtk_tree_model_ref_node(). -Please note that nodes that are deleted are not unreffed."> +Please note that nodes that are deleted are not unreffed. + The #GtkTreeIter. + + + Creates a new #GtkTreeModel, with @child_model as the child_model +and @root as the virtual root. + + A new #GtkTreeModel. + + + + + A #GtkTreePath or %NULL. + + + - + Calls func on each node in model in a depth-first fashion. +If @func returns %TRUE, then the tree ceases to be walked, and +gtk_tree_model_foreach() returns. + + + + + + A function to be called on each row + + + + User data to passed to func. + + + + + + Gets the value of one or more cells in the row referenced by @iter. The variable argument list should contain integer column numbers, each column number followed by a place to store the value being retrieved. The list is terminated by a -1. For example, to get a value from column 0 with type %G_TYPE_STRING, you would -where <literal>place_string_here</literal> is a <type>gchar*</type> to be +where <literal>place_string_here</literal> is a <type>gchar*</type> to be filled with the string. -If appropriate, the returned values have to be freed or unreferenced."> +Returned values with type %G_TYPE_OBJECT have to be unreferenced, values +with type %G_TYPE_STRING or %G_TYPE_BOXED have to be freed. Other values are +passed by value. + a row in @tree_model @@ -68041,204 +60829,521 @@ If appropriate, the returned values have to be freed or unreferenced."> - + + Returns the type of the column. + + The type of the column. + + + + + The column index. + + + + + + Returns a set of flags supported by this interface. The flags are a bitwise +combination of #GtkTreeModelFlags. The flags supported should not change +during the lifecycle of the @tree_model. + + The flags supported by this interface. + + + + + Sets @iter to a valid iterator pointing to @path. + + %TRUE, if @iter was set. + + + + + The uninitialized #GtkTreeIter. + + + + The #GtkTreePath. + + + + + + Initializes @iter with the first iterator in the tree (the one at the path +"0") and returns %TRUE. Returns %FALSE if the tree is empty. + + %TRUE, if @iter was set. + + + + + The uninitialized #GtkTreeIter. + + + + + + Sets @iter to a valid iterator pointing to @path_string, if it +exists. Otherwise, @iter is left invalid and %FALSE is returned. + + %TRUE, if @iter was set. + + + + + An uninitialized #GtkTreeIter. + + + + A string representation of a #GtkTreePath. + + + + + + Returns the number of columns supported by @tree_model. + + The number of columns. + + + + + Returns a newly-created #GtkTreePath referenced by @iter. This path should +be freed with gtk_tree_path_free(). + + a newly-created #GtkTreePath. + + + + + The #GtkTreeIter. + + + + + + Generates a string representation of the iter. This string is a ':' +separated list of numbers. For example, "4:10:0:3" would be an +acceptable return value for this string. + + A newly-allocated string. Must be freed with g_free(). + + + + + An #GtkTreeIter. + + + + + + See gtk_tree_model_get(), this version takes a <type>va_list</type> +for language bindings to use. - - + + a row in @tree_model + - - + + <type>va_list</type> of column/return location pairs + - + + Initializes and sets @value to that at @column. +When done with @value, g_value_unset() needs to be called +to free any allocated memory. + + + + + + The #GtkTreeIter. + + + + The column to lookup the value at. + + + + An empty #GValue to set. + + + + + + Sets @iter to point to the first child of @parent. If @parent has no +children, %FALSE is returned and @iter is set to be invalid. @parent +will remain a valid node after this function has been called. +If @parent is %NULL returns the first node, equivalent to +<literal>gtk_tree_model_get_iter_first (tree_model, iter);</literal> + + %TRUE, if @child has been set to the first child. + + + + + The new #GtkTreeIter to be set to the child. + + + + The #GtkTreeIter, or %NULL + + + + + + Returns %TRUE if @iter has children, %FALSE otherwise. + + %TRUE if @iter has children. + + + + + The #GtkTreeIter to test for children. + + + + + + Returns the number of children that @iter has. As a special case, if @iter +is %NULL, then the number of toplevel nodes is returned. + + The number of children of @iter. + + + + + The #GtkTreeIter, or %NULL. + + + + + + Sets @iter to point to the node following it at the current level. If there +is no next @iter, %FALSE is returned and @iter is set to be invalid. + + %TRUE if @iter has been changed to the next node. + + + + + The #GtkTreeIter. + + + + + + Sets @iter to be the child of @parent, using the given index. The first +index is 0. If @n is too big, or @parent has no children, @iter is set +to an invalid iterator and %FALSE is returned. @parent will remain a valid +node after this function has been called. As a special case, if @parent is +%NULL, then the @n<!-- -->th root node is set. + + %TRUE, if @parent has an @n<!-- -->th child. + + + + + The #GtkTreeIter to set to the nth child. + + + + The #GtkTreeIter to get the child from, or %NULL. + + + + Then index of the desired child. + + + + + + Sets @iter to be the parent of @child. If @child is at the toplevel, and +doesn't have a parent, then @iter is set to an invalid iterator and %FALSE +is returned. @child will remain a valid node after this function has been +called. + + %TRUE, if @iter is set to the parent of @child. + + + + + The new #GtkTreeIter to set to the parent. + + + + The #GtkTreeIter. + + + + + + Lets the tree ref the node. This is an optional method for models to +implement. To be more specific, models may ignore this call as it exists +primarily for performance reasons. +This function is primarily meant as a way for views to let caching model +know when nodes are being displayed (and hence, whether or not to cache that +node.) For example, a file-system based model would not want to keep the +entire file-hierarchy in memory, just the sections that are currently being +displayed by every current view. +A model should be expected to be able to get an iter independent of its +reffed state. + + + + + + The #GtkTreeIter. + + + + + + Emits the "row-changed" signal on @tree_model. + A #GtkTreePath pointing to the changed row + A valid #GtkTreeIter pointing to the changed row - + + Emits the "row-deleted" signal on @tree_model. This should be called by +models after a row has been removed. The location pointed to by @path +should be the location that the row previously was at. It may not be a +valid location anymore. + A #GtkTreePath pointing to the previous location of the deleted row. - - - + c:identifier="gtk_tree_model_row_has_child_toggled"> + Emits the "row-has-child-toggled" signal on @tree_model. This should be +called by models after the child state of a node changes. + A #GtkTreePath pointing to the changed row + A valid #GtkTreeIter pointing to the changed row - + + Emits the "row-inserted" signal on @tree_model + A #GtkTreePath pointing to the inserted row + + A valid #GtkTreeIter pointing to the inserted row + + + c:identifier="gtk_tree_model_rows_reordered"> + Emits the "rows-reordered" signal on @tree_model. This should be called by +models when their rows have been reordered. + A #GtkTreePath pointing to the tree node whose children have been reordered + A valid #GtkTreeIter pointing to the node whose children have been reordered, or %NULL if the depth of @path is 0. - - + + an array of integers mapping the current position of each child to its old position before the re-ordering, i.e. @new_order<literal>[newpos] = oldpos</literal>. + - + + Creates a new #GtkTreeModel, with @child_model as the child model. + A new #GtkTreeModel. + + + + + Lets the tree unref the node. This is an optional method for models to +implement. To be more specific, models may ignore this call as it exists +primarily for performance reasons. +For more information on what this means, see gtk_tree_model_ref_node(). +Please note that nodes that are deleted are not unreffed. + - - - - + The #GtkTreeIter. + + + + + + This signal is emitted when a row in the model has changed. + + + + + + a #GtkTreePath identifying the changed row + + + + a valid #GtkTreeIter pointing to the changed row + - + This signal is emitted when a row has been deleted. Note that no iterator is passed to the signal handler, since the row is already deleted. -Implementations of GtkTreeModel must emit row-deleted +Implementations of GtkTreeModel must emit row-deleted <emphasis>before</emphasis> removing the node from its -internal data structures. This is because models and +internal data structures. This is because models and views which access and monitor this model might have references on the node which need to be released in the -row-deleted handler."> - - +row-deleted handler. + + - - + + a #GtkTreePath identifying the row + - - - + + This signal is emitted when a row has gotten the first child row or lost +its last child row. + + - - + + a #GtkTreePath identifying the row + - - + + a valid #GtkTreeIter pointing to the row + - + This signal is emitted when a new row has been inserted in the model. Note that the row may still be empty at this point, since -it is a common pattern to first insert an empty row, and -then fill it with the desired values."> - - +it is a common pattern to first insert an empty row, and +then fill it with the desired values. + + - - + + a #GtkTreePath identifying the new row + - - + + a valid #GtkTreeIter pointing to the new row + - + This signal is emitted when the children of a node in the #GtkTreeModel +have been reordered. Note that this signal is <emphasis>not</emphasis> emitted when rows are reordered by DND, since this is implemented -by removing and then reinserting the row."> - - +by removing and then reinserting the row. + + - - + + a #GtkTreePath identifying the tree node whose children have been reordered + - - + + a valid #GtkTreeIter pointing to the node whose + - - + + an array of integers mapping the current position of each child to its old position before the re-ordering, i.e. @new_order<literal>[newpos] = oldpos</literal>. + glib:type-struct="TreeModelFilterClass"> - - - + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + This function should almost never be called. It clears the @filter +of any cached iterators that haven't been reffed with +gtk_tree_model_ref_node(). This might be useful if the child model +being filtered is static (and doesn't change often) and there has been +a lot of unreffed access to nodes. As a side effect of this function, +all unreffed iters will be invalid. + + + + + + Sets @filter_iter to point to the row in @filter that corresponds to the +row pointed at by @child_iter. If @filter_iter was not set, %FALSE is +returned. +valid iterator pointing to a visible row in child model. + + %TRUE, if @filter_iter was set, i.e. if @child_iter is a + + + + + An uninitialized #GtkTreeIter. + + + + A valid #GtkTreeIter pointing to a row on the child model. + + + + + + Converts @child_path to a path relative to @filter. That is, @child_path +points to a path in the child model. The rerturned path will point to the +same row in the filtered model. If @child_path isn't a valid path on the +child model or points to a row which is not visible in @filter, then %NULL +is returned. + + A newly allocated #GtkTreePath, or %NULL. + + + + + A #GtkTreePath to convert. - + + + Sets @child_iter to point to the row pointed to by @filter_iter. + + + + + + An uninitialized #GtkTreeIter. + + + + A valid #GtkTreeIter pointing to a row on @filter. + + + + + + Converts @filter_path to a path on the child model of @filter. That is, +point to the same location in the model not being filtered. If @filter_path +does not point to a location in the child model, %NULL is returned. + + A newly allocated #GtkTreePath, or %NULL. + + + + + A #GtkTreePath to convert. + + + + + + Returns a pointer to the child model of @filter. + + A pointer to a #GtkTreeModel. + + + + + Emits ::row_changed for each row in the child model, which causes +the filter to re-evaluate whether a row is visible or not. + + + + + + With the @n_columns and @types parameters, you give an array of column +types for this model (which will be exposed to the parent model/view). +The @func, @data and @destroy parameters are for specifying the modify +function. The modify function will get called for <emphasis>each</emphasis> +data access, the goal of the modify function is to return the data which +should be displayed at the location specified using the parameters of the +modify function. + + + + + + The number of columns in the filter model. + + + + The #GType<!-- -->s of the columns. + + + + A #GtkTreeModelFilterModifyFunc + + + + User data to pass to the modify function, or %NULL. + + + + Destroy notifier of @data, or %NULL. + + + + + + Sets @column of the child_model to be the column where @filter should +look for visibility information. @columns should be a column of type +%G_TYPE_BOOLEAN, where %TRUE means that a row is visible, and %FALSE +if not. + + + + + + A #gint which is the column containing the visible information. + + + + + Sets the visible function used when filtering the @filter to be @func. The function should return %TRUE if the given row should be visible and %FALSE otherwise. If the condition calculated by the function changes over time (e.g. because -it depends on some global parameters), you must call -gtk_tree_model_filter_refilter() to keep the visibility information of +it depends on some global parameters), you must call +gtk_tree_model_filter_refilter() to keep the visibility information of the model uptodate. Note that @func is called whenever a row is inserted, when it may still be empty. The visible function should therefore take special care of empty @@ -68284,17 +61576,16 @@ visible_func (GtkTreeModel *model, GtkTreeIter *iter, gpointer data) { -/&ast; Visible if row is non-empty and first column is "HI" &ast;/ +/&ast; Visible if row is non-empty and first column is "HI" &ast;/ gchar *str; gboolean visible = FALSE; gtk_tree_model_get (model, iter, 0, &str, -1); -if (str && strcmp (str, "HI") == 0) +if (str && strcmp (str, "HI") == 0) visible = TRUE; g_free (str); return visible; } -</programlisting></informalexample>" - version="2.4"> +</programlisting></informalexample> @@ -68302,187 +61593,36 @@ return visible; + closure="1" + destroy="2"> + A #GtkTreeModelFilterVisibleFunc, the visible function. - - + + User data to pass to the visible function, or %NULL. + + scope="async"> + Destroy notifier of @data, or %NULL. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + @@ -68498,29 +61638,57 @@ all unreffed iters will be invalid." - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - + + @@ -68543,19 +61711,21 @@ all unreffed iters will be invalid." - + - + - + - + @@ -68565,7 +61735,7 @@ all unreffed iters will be invalid." - + @@ -68584,7 +61754,7 @@ all unreffed iters will be invalid." - + @@ -68597,7 +61767,7 @@ all unreffed iters will be invalid." - + @@ -68608,7 +61778,7 @@ all unreffed iters will be invalid." - + @@ -68626,7 +61796,7 @@ all unreffed iters will be invalid." - + @@ -68644,7 +61814,7 @@ all unreffed iters will be invalid." - + @@ -68662,7 +61832,7 @@ all unreffed iters will be invalid." - + @@ -68677,7 +61847,7 @@ all unreffed iters will be invalid." - + @@ -68691,17 +61861,16 @@ all unreffed iters will be invalid." - - + + - - + + + The flags supported by this interface. @@ -68712,9 +61881,10 @@ all unreffed iters will be invalid." - + - + The number of columns. + @@ -68724,8 +61894,9 @@ all unreffed iters will be invalid." - + + The type of the column. @@ -68733,32 +61904,40 @@ all unreffed iters will be invalid." - + The column index. + - + - + %TRUE, if @iter was set. + - + + The uninitialized #GtkTreeIter. + The #GtkTreePath. - + + a newly-created #GtkTreePath. @@ -68766,13 +61945,14 @@ all unreffed iters will be invalid." + The #GtkTreeIter. - + @@ -68781,121 +61961,152 @@ all unreffed iters will be invalid." + The #GtkTreeIter. - + The column to lookup the value at. + - + + An empty #GValue to set. - + - + %TRUE if @iter has been changed to the next node. + + The #GtkTreeIter. - + - + %TRUE, if @child has been set to the first child. + - + + The new #GtkTreeIter to be set to the child. - + + The #GtkTreeIter, or %NULL - + - + %TRUE if @iter has children. + + The #GtkTreeIter to test for children. - + - + The number of children of @iter. + - + + The #GtkTreeIter, or %NULL. - + - + %TRUE, if @parent has an @n<!-- -->th child. + - + + The #GtkTreeIter to set to the nth child. - + + The #GtkTreeIter to get the child from, or %NULL. - + Then index of the desired child. + - + - + %TRUE, if @iter is set to the parent of @child. + - + + The new #GtkTreeIter to set to the parent. + The #GtkTreeIter. - + @@ -68904,13 +62115,14 @@ all unreffed iters will be invalid." + The #GtkTreeIter. - + @@ -68919,6 +62131,7 @@ all unreffed iters will be invalid." + The #GtkTreeIter. @@ -68926,6 +62139,7 @@ all unreffed iters will be invalid." - - - - - - - - - - - - - + + This function should almost never be called. It clears the @tree_model_sort +of any cached iterators that haven't been reffed with +gtk_tree_model_ref_node(). This might be useful if the child model being +sorted is static (and doesn't change often) and there has been a lot of +unreffed access to nodes. As a side effect of this function, all unreffed +iters will be invalid. + + + + Sets @sort_iter to point to the row in @tree_model_sort that corresponds to +the row pointed at by @child_iter. If @sort_iter was not set, %FALSE +valid iterator pointer to a visible row in the child model. + + %TRUE, if @sort_iter was set, i.e. if @sort_iter is a + + + + + An uninitialized #GtkTreeIter. + + + + A valid #GtkTreeIter pointing to a row on the child model + + + + + c:identifier="gtk_tree_model_sort_convert_child_path_to_path"> + Converts @child_path to a path relative to @tree_model_sort. That is, +point to the same row in the sorted model. If @child_path isn't a valid +path on the child model, then %NULL is returned. + A newly allocated #GtkTreePath, or %NULL - - - - - - - - - - - - - - - - - - - - - - - + A #GtkTreePath to convert + c:identifier="gtk_tree_model_sort_convert_iter_to_child_iter"> + Sets @child_iter to point to the row pointed to by @sorted_iter. - + + An uninitialized #GtkTreeIter + A valid #GtkTreeIter pointing to a row on @tree_model_sort. + + + + + + Converts @sorted_path to a path on the child model of @tree_model_sort. +That is, @sorted_path points to a location in @tree_model_sort. The +returned path will point to the same location in the model not being +sorted. If @sorted_path does not point to a location in the child model, +%NULL is returned. + + A newly allocated #GtkTreePath, or %NULL + + + + + A #GtkTreePath to convert + + + + + + Returns the model the #GtkTreeModelSort is sorting. + + the "child model" being sorted + + + + + <warning><para> +This function is slow. Only use it for debugging and/or testing purposes. +</para></warning> +Checks if the given iter is a valid iter for this #GtkTreeModelSort. + + %TRUE if the iter is valid, %FALSE if the iter is invalid. + + + + + A #GtkTreeIter. + This resets the default sort function to be in the 'unsorted' state. That is, it is in the same order as the child model. It will re-sort the model to be in the same order as the child model only if the #GtkTreeModelSort -is in 'unsorted' state."> +is in 'unsorted' state. - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - + - - + + - - + + + + - - + + - + - + - - + + - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -69146,40 +62370,35 @@ Checks if the given iter is a valid iter for this #GtkTreeModelSort." - + glib:get-type="gtk_tree_path_get_type" + c:symbol-prefix="tree_path"> + + Creates a new #GtkTreePath. This structure refers to a row. + A newly created #GtkTreePath. - + + Creates a new #GtkTreePath. The string representation of this path is "0" + A new #GtkTreePath. - - - - - + version="2.2" + introspectable="0"> + Creates a new path with @first_index and @varargs as indices. + A newly created #GtkTreePath. - + first integer + @@ -69187,168 +62406,210 @@ path string is passed in, %NULL is returned."> - + + Creates a new #GtkTreePath initialized to @path. @path is expected to be a +colon separated list of numbers. For example, the string "10:4:0" would +create a path of depth 3 pointing to the 11th child of the root node, the 5th +child of that 11th child, and the 1st child of that 5th child. If an invalid +path string is passed in, %NULL is returned. + A newly-created #GtkTreePath, or %NULL + + + The string representation of a path. + + + - + + Appends a new index to a path. As a result, the depth of the path is +increased. + + + + + + The index. + + + + + + Compares two paths. If @a appears before @b in a tree, then -1 is returned. +If @b appears before @a, then 1 is returned. If the two nodes are equal, +then 0 is returned. + + The relative positions of @a and @b + + + + + A #GtkTreePath to compare with. + + + + + + Creates a new #GtkTreePath as a copy of @path. - + A new #GtkTreePath. + - + + Moves @path to point to the first child of the current path. - - - - - - + + Frees @path. - - - - - - + + Returns the current depth of @path. - + The depth of @path + - - - - - + shadowed-by="get_indices_with_depth"> + Returns the current indices of @path. This is an array of integers, each +representing a node in a tree. This value should not be freed. - + The current indices, or %NULL. + - - - - - - + + Returns the current indices of @path. +This is an array of integers, each representing a node in a tree. +It also returns the number of elements in the array. +The array should not be freed. - + The current indices, or %NULL. + + + - - + + Number of elements returned in the integer array + - + + Returns %TRUE if @descendant is a descendant of @path. - - - - - - - - - - - - - - - - - - - - - + %TRUE if @descendant is contained inside @path + + another #GtkTreePath - + + Returns %TRUE if @path is a descendant of @ancestor. - + %TRUE if @ancestor contains @path somewhere below it + + another #GtkTreePath + + Moves the @path to point to the next node at the current depth. + + + + + + Prepends a new index to a path. As a result, the depth of the path is +increased. + + + + + + The index. + + + + + + Moves the @path to point to the previous node at the current depth, +if it exists. + + %TRUE if @path has a previous node, and the move was made. + + + + + Generates a string representation of the path. This string is a ':' +separated list of numbers. For example, "4:10:0:3" would be an acceptable return value for this string. + + A newly-allocated string. Must be freed with g_free(). + + + + + Moves the @path to point to its parent node, if it has a parent. + + %TRUE if @path has a parent, and the move was made. + + + - + + Creates a row reference based on @path. This reference will keep pointing to the node pointed to by @path, so long as it exists. It listens to all signals emitted by @model, and updates its path appropriately. If @path -isn't a valid path in @model, then %NULL is returned."> +isn't a valid path in @model, then %NULL is returned. + A newly allocated #GtkTreeRowReference, or %NULL + A #GtkTreeModel + A valid #GtkTreePath to monitor + You do not need to use this function. Creates a row reference based on +so long as it exists. If @path isn't a valid path in @model, then %NULL is returned. However, unlike references created with gtk_tree_row_reference_new(), it does not listen to the model for changes. The creator of the row reference must do this explicitly using @@ -69360,169 +62621,138 @@ updates all row references for that proxy. Since built-in GTK+ objects like #GtkTreeView already use this mechanism internally, using them as the proxy object will produce unpredictable results. Further more, passing the same object as @model and @proxy -doesn't work for reasons of internal implementation. +doesn't work for reasons of internal implementation. This type of row reference is primarily meant by structures that need to carefully monitor exactly when a row reference updates itself, and is not -generally needed by most applications."> +generally needed by most applications. + A newly allocated #GtkTreeRowReference, or %NULL + A proxy #GObject + A #GtkTreeModel + A valid #GtkTreePath to monitor - - - - - - - - - - - - - - - + Copies a #GtkTreeRowReference. + a copy of @reference. - + + Free's @reference. @reference may be %NULL. + + Returns the model that the row reference is monitoring. + + the model + + + + + Returns a path that the row reference currently points to, or %NULL if the +path pointed to is no longer valid. + + A current path, or %NULL. + + + + + Returns %TRUE if the @reference is non-%NULL and refers to a current valid +path. + + %TRUE if @reference points to a valid path. + + + - + + Returns the number of rows that have been selected in @tree. - + The number of rows selected. + - - - - - - - + + Gets the selection mode for @selection. See +gtk_tree_selection_set_mode(). + + the current selection mode - - - - - - - - - - - - - - - - - - - - - - - - - - - + version="2.14" + introspectable="0"> + Returns the current selection function. + + The function. + Sets @iter to the currently selected node if @selection is set to #GTK_SELECTION_SINGLE or #GTK_SELECTION_BROWSE. @iter may be NULL if you just want to test if @selection has any selected nodes. @model is filled with the current model as a convenience. This function will not work if you -use @selection is #GTK_SELECTION_MULTIPLE."> +use @selection is #GTK_SELECTION_MULTIPLE. - + TRUE, if there is a selected node. + + caller-allocates="0" + transfer-ownership="none" + allow-none="1"> + A pointer to set to the #GtkTreeModel, or NULL. + allow-none="1"> + The #GtkTreeIter, or NULL. + Creates a list of path of all selected rows. Additionally, if you are planning on modifying the model after calling this function, you may want to convert the returned list into a list of #GtkTreeRowReference<!-- -->s. To do this, you can use gtk_tree_row_reference_new(). @@ -69530,36 +62760,123 @@ To free the return value, use: |[ g_list_foreach (list, (GFunc) gtk_tree_path_free, NULL); g_list_free (list); -]|" - version="2.2"> - +]| + + A #GList containing a #GtkTreePath for each selected row. + allow-none="1"> + A pointer to set to the #GtkTreeModel, or %NULL. - + + Returns the tree view associated with @selection. - + A #GtkTreeView + + + Returns the user data for the selection function. + + The user data. + + + + + Returns %TRUE if the row at @iter is currently selected. + + %TRUE, if @iter is selected + + + + + A valid #GtkTreeIter + + + + + + Returns %TRUE if the row pointed to by @path is currently selected. If @path +does not point to a valid location, %FALSE is returned + + %TRUE if @path is selected. + + + + + A #GtkTreePath to check selection on. + + + + + + Selects all the nodes. @selection must be set to #GTK_SELECTION_MULTIPLE +mode. + + + + + + Selects the specified iterator. + + + + + + The #GtkTreeIter to be selected. + + + + + + Select the row at @path. + + + + + + The #GtkTreePath to be selected. + + + + + + Selects a range of nodes, determined by @start_path and @end_path inclusive. + + + + + + The initial node of the range. + + + + The final node of the range. + + + + + Calls a function for each selected node. Note that you cannot modify the tree or selection from within this function. As a result, -gtk_tree_selection_get_selected_rows() might be more useful."> +gtk_tree_selection_get_selected_rows() might be more useful. @@ -69567,131 +62884,108 @@ gtk_tree_selection_get_selected_rows() might be more useful."> + closure="1"> + The function to call for each selected node. - + user data to pass to the function. + - + + Sets the selection mode of the @selection. If the previous type was +#GTK_SELECTION_MULTIPLE, then the anchor is kept selected, if it was +previously selected. - - + + The selection mode + + + + + + Sets the selection function. +If set, this function is called before any node is selected or unselected, +giving some control over which nodes are selected. The select function +should return %TRUE if the state of the node may be toggled, and %FALSE +if the state of the node should be left unchanged. + + + + + + The selection function. May be %NULL + + + + The selection function's data. May be %NULL + + + + The destroy function for user data. May be %NULL + + + + + + Unselects all the nodes. + + + + + + Unselects the specified iterator. + + + + + + The #GtkTreeIter to be unselected. + + c:identifier="gtk_tree_selection_unselect_path"> + Unselects the row at @path. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The #GtkTreePath to be unselected. + Unselects a range of nodes, determined by @start_path and @end_path +inclusive. + The initial node of the range. + The initial node of the range. @@ -69709,14 +63003,14 @@ inclusive." - + - - + + @@ -69727,7 +63021,7 @@ inclusive." - + @@ -69738,29 +63032,29 @@ inclusive." - - + + - - + + - - + + - - + + @@ -69783,13 +63077,13 @@ inclusive." - + - + @@ -69802,121 +63096,93 @@ inclusive." - + - + + Fills in @sort_column_id and @order with the current sort column and the +order. It returns %TRUE unless the @sort_column_id is +%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or +%GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID. +column ids. - + %TRUE if the sort column is not one of the special sort + - - + + The sort column id to be filled in + + The #GtkSortType to be filled in - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Returns %TRUE if the model has a default sort function. This is used +primarily by GtkTreeViewColumns in order to determine if a model can +go back to the default state, or not. - + %TRUE, if the model has a default sort function + - + + Sets the default comparison function used when sorting to be @sort_func. +If the current sort column id of @sortable is +%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using +this function. +If @sort_func is %NULL, then there will be no default comparison function. +This means that once the model has been sorted, it can't go back to the +default state. In this case, when the current sort column id of @sortable +is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted. - - - - - - - + + The comparison function + - - + + User data to pass to @sort_func, or %NULL + + + + Destroy notifier of @user_data, or %NULL + - - + Sets the current sort column to be @sort_column_id. The @sortable will resort itself to reflect this change, after emitting a -#GtkTreeSortable::sort-column-changed signal. @sortable may either be +#GtkTreeSortable::sort-column-changed signal. @sort_column_id may either be a regular column id, or one of the following special values: <variablelist> <varlistentry> @@ -69927,105 +63193,202 @@ a regular column id, or one of the following special values: <term>%GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID</term> <listitem>no sorting will occur</listitem> </varlistentry> -</variablelist>"> +</variablelist> - + the sort column id to set + + The sort order of the column - - + + + Sets the comparison function used when sorting to be @sort_func. If the +current sort column id of @sortable is the same as @sort_column_id, then +the model will sort using this function. - + the sort column id to set the function for + - - - - - - - - - - - - - - - - + The comparison function - + closure="2"> + User data to pass to @sort_func, or %NULL + + scope="async"> + Destroy notifier of @user_data, or %NULL + + + Fills in @sort_column_id and @order with the current sort column and the +order. It returns %TRUE unless the @sort_column_id is +%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or +%GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID. +column ids. + + %TRUE if the sort column is not one of the special sort + + + + + The sort column id to be filled in + + + + The #GtkSortType to be filled in + + + + c:identifier="gtk_tree_sortable_has_default_sort_func"> + Returns %TRUE if the model has a default sort function. This is used +primarily by GtkTreeViewColumns in order to determine if a model can +go back to the default state, or not. - + %TRUE, if the model has a default sort function + - - + + Sets the default comparison function used when sorting to be @sort_func. +If the current sort column id of @sortable is +%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using +this function. +If @sort_func is %NULL, then there will be no default comparison function. +This means that once the model has been sorted, it can't go back to the +default state. In this case, when the current sort column id of @sortable +is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted. + + + + The comparison function + + + + User data to pass to @sort_func, or %NULL + + + + Destroy notifier of @user_data, or %NULL + + + + + + Sets the current sort column to be @sort_column_id. The @sortable will +resort itself to reflect this change, after emitting a +#GtkTreeSortable::sort-column-changed signal. @sort_column_id may either be +a regular column id, or one of the following special values: +<variablelist> +<varlistentry> +<term>%GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID</term> +<listitem>the default sort function will be used, if it is set</listitem> +</varlistentry> +<varlistentry> +<term>%GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID</term> +<listitem>no sorting will occur</listitem> +</varlistentry> +</variablelist> + + + + + + the sort column id to set + + + + The sort order of the column + + + + + + Sets the comparison function used when sorting to be @sort_func. If the +current sort column id of @sortable is the same as @sort_column_id, then +the model will sort using this function. + + + + + + the sort column id to set the function for + + + + The comparison function + + + + User data to pass to @sort_func, or %NULL + + + + Destroy notifier of @user_data, or %NULL + + + + + + Emits a #GtkTreeSortable::sort-column-changed signal on @sortable. + + + + + + The ::sort-column-changed signal is emitted when the sort column +or sort order of @sortable is changed. The signal is emitted before +the contents of @sortable are resorted. + + + - + @@ -70047,27 +63410,28 @@ the contents of @sortable are resorted."> - + - + %TRUE if the sort column is not one of the special sort + - - + + The sort column id to be filled in + + The #GtkSortType to be filled in - + @@ -70076,16 +63440,18 @@ the contents of @sortable are resorted."> - + the sort column id to set + + The sort order of the column - + @@ -70094,23 +63460,37 @@ the contents of @sortable are resorted."> - + the sort column id to set the function for + - + + The comparison function - - + + User data to pass to @sort_func, or %NULL + - + + Destroy notifier of @user_data, or %NULL - + @@ -70118,23 +63498,37 @@ the contents of @sortable are resorted."> - + + The comparison function - - + + User data to pass to @sort_func, or %NULL + - + + Destroy notifier of @user_data, or %NULL - + - + %TRUE, if the model has a default sort function + @@ -70145,6 +63539,7 @@ the contents of @sortable are resorted."> + Creates a new tree store as with @n_columns columns each of the types passed +in. Note that only types derived from standard GObject fundamental types +are supported. As an example, <literal>gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING, GDK_TYPE_PIXBUF);</literal> will create a new #GtkTreeStore with three columns, of type -<type>int</type>, <type>string</type> and #GdkPixbuf respectively."> +<type>int</type>, <type>string</type> and #GdkPixbuf respectively. + a new #GtkTreeStore - + number of columns in the tree store + @@ -70176,224 +63574,144 @@ GDK_TYPE_PIXBUF);</literal> will create a new #GtkTreeStore with three col - + + Non vararg creation function. Used primarily by language bindings. + a new #GtkTreeStore - + number of columns in the tree store + - + + an array of #GType types for the columns, from first to last - - + + + Appends a new row to @tree_store. If @parent is non-%NULL, then it will append the +new row after the last child of @parent, otherwise it will append a row to +the top level. @iter will be changed to point to this new row. The row will +be empty after this function is called. To fill in values, you need to call +gtk_tree_store_set() or gtk_tree_store_set_value(). - - + + An unset #GtkTreeIter to set to the appended row + - - - - + + A valid #GtkTreeIter, or %NULL + - + + Removes all rows from @tree_store - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a new row at @position. If parent is non-%NULL, then the row will be made a child of @parent. Otherwise, the row will be created at the toplevel. If @position is larger than the number of rows at that level, then the new row will be inserted to the end of the list. @iter will be changed to point to this new row. The row will be empty after this function is called. To fill in values, you need to call gtk_tree_store_set() or -gtk_tree_store_set_value()."> +gtk_tree_store_set_value(). - + + An unset #GtkTreeIter to set to the new row - + + A valid #GtkTreeIter, or %NULL - + position to insert the new row + - - - - - - - - - - - - - - - - - + Inserts a new row after @sibling. If @sibling is %NULL, then the row will be +prepended to @parent 's children. If @parent and @sibling are %NULL, then the row will be prepended to the toplevel. If both @sibling and @parent are set, then @parent must be the parent of @sibling. When @sibling is set, this function is called. To fill in values, you need to call -gtk_tree_store_set() or gtk_tree_store_set_value()."> +gtk_tree_store_set() or gtk_tree_store_set_value(). - + + An unset #GtkTreeIter to set to the new row - + + A valid #GtkTreeIter, or %NULL - + + A valid #GtkTreeIter, or %NULL + + + + + + Inserts a new row before @sibling. If @sibling is %NULL, then the row will +be appended to @parent 's children. If @parent and @sibling are %NULL, then +the row will be appended to the toplevel. If both @sibling and @parent are +set, then @parent must be the parent of @sibling. When @sibling is set, +this function is called. To fill in values, you need to call +gtk_tree_store_set() or gtk_tree_store_set_value(). + + + + + + An unset #GtkTreeIter to set to the new row + + + + A valid #GtkTreeIter, or %NULL + + + + A valid #GtkTreeIter, or %NULL + Creates a new row at @position. @iter will be changed to point to this new row. If @position is larger than the number of rows on the list, then the new row will be appended to the list. The row will be filled with the values given to this function. @@ -70409,26 +63727,26 @@ while the latter will emit row_inserted, row_changed and if the tree store is sorted, rows_reordered. Since emitting the rows_reordered signal repeatedly can affect the performance of the program, gtk_tree_store_insert_with_values() should generally be preferred when -inserting rows in a sorted tree store." - version="2.10"> +inserting rows in a sorted tree store. + allow-none="1"> + An unset #GtkTreeIter to set the new row, or %NULL. - + + A valid #GtkTreeIter, or %NULL - + position to insert the new row + @@ -70438,211 +63756,322 @@ inserting rows in a sorted tree store." + A variant of gtk_tree_store_insert_with_values() which takes +the columns and values as two arrays, instead of varargs. This +function is mainly intended for language bindings. + allow-none="1"> + An unset #GtkTreeIter to set the new row, or %NULL. - + + A valid #GtkTreeIter, or %NULL - + position to insert the new row + - - + + an array of column numbers + + an array of GValues - + the length of the @columns and @values arrays + - + + Returns %TRUE if @iter is an ancestor of @descendant. That is, @iter is the +parent (or grandparent or great-grandparent) of @descendant. - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE, if @iter is an ancestor of @descendant + + A valid #GtkTreeIter + A valid #GtkTreeIter - + + Returns the depth of @iter. This will be 0 for anything on the root level, 1 +for anything down a level, etc. - + The depth of @iter + + A valid #GtkTreeIter - - - - - + purposes. +Checks if the given iter is a valid iter for this #GtkTreeStore. - + %TRUE if the iter is valid, %FALSE if the iter is invalid. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + A #GtkTreeIter. + Moves @iter in @tree_store to the position after @position. @iter and +works with unsorted stores. If @position is %NULL, @iter will be moved +to the start of the level. + A #GtkTreeIter. - + + A #GtkTreeIter. + + + + + + Moves @iter in @tree_store to the position before @position. @iter and +works with unsorted stores. If @position is %NULL, @iter will be +moved to the end of the level. + + + + + + A #GtkTreeIter. + + + + A #GtkTreeIter or %NULL. + + + + + + Prepends a new row to @tree_store. If @parent is non-%NULL, then it will prepend +the new row before the first child of @parent, otherwise it will prepend a row +to the top level. @iter will be changed to point to this new row. The row +will be empty after this function is called. To fill in values, you need to +call gtk_tree_store_set() or gtk_tree_store_set_value(). + + + + + + An unset #GtkTreeIter to set to the prepended row + + + + A valid #GtkTreeIter, or %NULL + + + + + + Removes @iter from @tree_store. After being removed, @iter is set to the +next valid row at that level, or invalidated if it previously pointed to the +last one. + + %TRUE if @iter is still valid, %FALSE if not. + + + + + A valid #GtkTreeIter + + + + + + Reorders the children of @parent in @tree_store to follow the order +indicated by @new_order. Note that this function only works with +unsorted stores. + + + + + + A #GtkTreeIter. + + + + an array of integers mapping the new position of each child to its old position before the re-ordering, i.e. @new_order<literal>[newpos] = oldpos</literal>. + + + + + + Sets the value of one or more cells in the row referenced by @iter. +The variable argument list should contain integer column numbers, +each column number followed by the value to be set. +The list is terminated by a -1. For example, to set column 0 with type +%G_TYPE_STRING to "Foo", you would write +<literal>gtk_tree_store_set (store, iter, 0, "Foo", -1)</literal>. +The value will be referenced by the store if it is a %G_TYPE_OBJECT, and it +will be copied if it is a %G_TYPE_STRING or %G_TYPE_BOXED. + + + + + + A valid #GtkTreeIter for the row being modified + + + + + + + + + + This function is meant primarily for #GObjects that inherit from +#GtkTreeStore, and should only be used when constructing a new +#GtkTreeStore. It will not function after a row has been added, +or a method on the #GtkTreeModel interface is called. + + + + + + Number of columns for the tree store + + + + An array of #GType types, one for each column + + + + + + + + See gtk_tree_store_set(); this version takes a <type>va_list</type> for +use by language bindings. + + + + + + A valid #GtkTreeIter for the row being modified + + + + <type>va_list</type> of column/value pairs + + + + + + Sets the data in the cell specified by @iter and @column. +The type of @value must be convertible to the type of the +column. + + + + + + A valid #GtkTreeIter for the row being modified + + + + column number to modify + + + + new value for the cell + + + + + + A variant of gtk_tree_store_set_valist() which takes +the columns and values as two arrays, instead of varargs. This +function is mainly intended for language bindings or in case +the number of columns to change is not known until run-time. + + + + + + A valid #GtkTreeIter for the row being modified + + + + an array of column numbers + + + + + + an array of GValues + + + + + + the length of the @columns and @values arrays + + + + + + Swaps @a and @b in the same level of @tree_store. Note that this function +only works with unsorted stores. + + + + + + A #GtkTreeIter. + + + + Another #GtkTreeIter. @@ -70651,40 +64080,42 @@ to the start of the level." - + - + - + - + - + - + + + - + - + - + - - + + - - + + - - + + - - + + @@ -70723,6 +64154,7 @@ to the start of the level." - - - + + + Creates a new #GtkTreeView widget. + + A newly created #GtkTreeView widget. + - - + c:identifier="gtk_tree_view_new_with_model"> + Creates a new #GtkTreeView widget with the model initialized to @model. + + A newly created #GtkTreeView widget. + + the model. - - - - - - + + Appends @column to the list of columns. If @tree_view has "fixed_height" +mode enabled, then @column must have its "sizing" property set to be +GTK_TREE_VIEW_COLUMN_FIXED. - + The number of columns in @tree_view after appending. + - - + + The #GtkTreeViewColumn to add. + - - - - - - - - - - - + + Recursively collapses all visible, expanded nodes in @tree_view. - - - - - - - - - - - + + Collapses a row (hides its child rows, if they exist). - + %TRUE if the row was collapsed. + - - - - - - - - - - - - - - - - - + + path to a row in the @tree_view + + c:identifier="gtk_tree_view_columns_autosize"> + Resizes all columns to their optimal width. Only works after the +treeview has been realized. - - - - - - + + Converts bin_window coordinates to coordinates for the +tree (the full scrollable area of the tree). - - + + X coordinate relative to bin_window + + + + Y coordinate relative to bin_window + + + + return location for tree X coordinate + + + + return location for tree Y coordinate + - + + Converts bin_window coordinates (see gtk_tree_view_get_bin_window()) +to widget relative coordinates. - - + + bin_window X coordinate + + + + bin_window Y coordinate + + + + return location for widget X coordinate + + + + return location for widget Y coordinate + - + + Converts tree coordinates (coordinates in full scrollable area of the tree) +to bin_window coordinates. - - - - - - + - - + + tree X coordinate + + + + tree Y coordinate + + + + return location for X coordinate relative to bin_window + + + + return location for Y coordinate relative to bin_window + - + + Converts tree coordinates (coordinates in full scrollable area of the tree) +to widget coordinates. - + - - + + X coordinate relative to the tree + + + + Y coordinate relative to the tree + + + + return location for widget X coordinate + + + + return location for widget Y coordinate + - + + Converts widget coordinates to coordinates for the bin_window +(see gtk_tree_view_get_bin_window()). - + - - + + X coordinate relative to the widget + - - + + Y coordinate relative to the widget + + + + return location for bin_window X coordinate + + + + return location for bin_window Y coordinate + - + + Converts widget coordinates to coordinates for the +tree (the full scrollable area of the tree). - + - - + + X coordinate relative to the widget + - - + + Y coordinate relative to the widget + - - + + return location for tree X coordinate + - - - + + return location for tree Y coordinate + - - - - - - - - - - - - - - - - - - - - - - - - - - + + Creates a #GdkPixmap representation of the row at @path. +This image is used for a drag icon. + a newly-allocated pixmap of the drag icon. + + + + + a #GtkTreePath in @tree_view + + + + + + Turns @tree_view into a drop destination for automatic DND. Calling +this method sets #GtkTreeView:reorderable to %FALSE. + + + + + + the table of targets that the drag will support + + + + the number of items in @targets + + + + the bitmask of possible actions for a drag from this widget + + + + + + Turns @tree_view into a drag source for automatic DND. Calling this +method sets #GtkTreeView:reorderable to %FALSE. + + + + + + Mask of allowed buttons to start drag + + + + the table of targets that the drag will support + + + + the number of items in @targets + + + + the bitmask of possible actions for a drag from this widget + + + + + + Recursively expands all nodes in the @tree_view. + + + + + + Opens the row so its children are visible. + + %TRUE if the row existed and had children + + + + + path to a row + + + + whether to recursively expand, or just expand immediate children + + + + + + Expands the row at @path. This will also expand all parent rows of + + + + + + path to a row. + + + + + + Fills the bounding rectangle in bin_window coordinates for the cell at the +row specified by @path and the column specified by @column. If @path is +%NULL, or points to a node not found in the tree, the @y and @height fields of +the rectangle will be filled with 0. If @column is %NULL, the @x and @width +fields will be filled with 0. The returned rectangle is equivalent to the +areas tile to cover the entire bin window. Contrast with the @cell_area, +returned by gtk_tree_view_get_cell_area(), which returns only the cell +itself, excluding surrounding borders and the tree expander area. + + + + + + a #GtkTreePath for the row, or %NULL to get only horizontal coordinates + + + + a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes + + + + rectangle to fill with cell background rect + + + + + + Returns the window that @tree_view renders to. +This is used primarily to compare to <literal>event->window</literal> +to confirm that the event on @tree_view is on the right window. +hasn't been realized yet + + A #GdkWindow, or %NULL when @tree_view + + + + + Fills the bounding rectangle in bin_window coordinates for the cell at the +row specified by @path and the column specified by @column. If @path is +%NULL, or points to a path not currently displayed, the @y and @height fields +of the rectangle will be filled with 0. If @column is %NULL, the @x and @width +fields will be filled with 0. The sum of all cell rects does not cover the +entire tree; there are extra pixels in between rows, for example. The +returned rectangle is equivalent to the @cell_area passed to +gtk_cell_renderer_render(). This function is only valid if @tree_view is +realized. + + + + + + a #GtkTreePath for the row, or %NULL to get only horizontal coordinates + + + + a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates + + + + rectangle to fill with cell rect + + + + + + Gets the #GtkTreeViewColumn at the given position in the #tree_view. +position is outside the range of columns. + + The #GtkTreeViewColumn, or %NULL if the - + The position of the column, counting from 0. + - - + + Returns a #GList of all the #GtkTreeViewColumn s currently in @tree_view. +The returned list must be freed with g_list_free (). + + A list of #GtkTreeViewColumn s - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Fills in @path and @focus_column with the current path and focus column. If +the cursor isn't currently set, then *@path will be %NULL. If no column currently has focus, then *@focus_column will be %NULL. The returned #GtkTreePath must be freed with gtk_tree_path_free() when -you are done with it."> +you are done with it. + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + A pointer to be filled with the current cursor path, or %NULL + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + A pointer to be filled with the current focus column, or %NULL - - - + + Determines the destination row for a given position. @drag_x and +meaningful if @tree_view is realized. Therefore this function will always +return %FALSE if @tree_view is not realized or does not have a model. +is indeed the case. + + whether there is a row at the given position, %TRUE if this + + + + + the position to determine the destination row for + + + + the position to determine the destination row for + + + + Return location for the path of the highlighted row, or %NULL. + + + + Return location for the drop position, or %NULL + + + + + + Gets information about the row that is highlighted for feedback. + + + + + + Return location for the path of the highlighted row, or %NULL. + + + + Return location for the drop position, or %NULL + + + + + + Returns whether or not the tree allows to start interactive searching +by typing in text. + + whether or not to let the user search interactively + + + + + Returns whether or not tree lines are drawn in @tree_view. +otherwise. + + %TRUE if tree lines are drawn in @tree_view, %FALSE + + + + + Returns the column that is the current expander column. +This column has the expander arrow drawn next to it. + + The expander column. + + + + + Returns whether fixed height mode is turned on for @tree_view. + + %TRUE if @tree_view is in fixed height mode + + + + + Returns which grid lines are enabled in @tree_view. +are enabled. + + a #GtkTreeViewGridLines value indicating which grid lines + + + + + Gets the #GtkAdjustment currently being used for the horizontal aspect. +if none is currently being used. + + A #GtkAdjustment object, or %NULL + + + + + Returns whether all header columns are clickable. + + %TRUE if all header columns are clickable, otherwise %FALSE + + + + + Returns %TRUE if the headers on the @tree_view are visible. + + Whether the headers are visible or not. + + + + + Returns whether hover expansion mode is turned on for @tree_view. + + %TRUE if @tree_view is in hover expansion mode + + + + + Returns whether hover selection mode is turned on for @tree_view. + + %TRUE if @tree_view is in hover selection mode + + + + + Returns the amount, in pixels, of extra indentation for child levels +in @tree_view. + + the amount of extra indentation for child levels in + + + + + Returns the model the #GtkTreeView is based on. Returns %NULL if the +model is unset. + + A #GtkTreeModel, or %NULL if none is currently being used. + + Finds the path at the point (@x, @y), relative to bin_window coordinates (please see gtk_tree_view_get_bin_window()). That is, @x and @y are relative to an events coordinates. @x and @y must come from an event on the @tree_view only where <literal>event->window == @@ -71407,989 +64796,163 @@ gtk_cell_renderer_render()). This function is only meaningful if if @tree_view is not realized or does not have a model. For converting widget coordinates (eg. the ones you get from GtkWidget::query-tooltip), please see -gtk_tree_view_convert_widget_to_bin_window_coords()."> +gtk_tree_view_convert_widget_to_bin_window_coords(). - + %TRUE if a row exists at that coordinate. + - + The x position to be identified (relative to bin_window). + - + The y position to be identified (relative to bin_window). + + allow-none="1"> + A pointer to a #GtkTreePath pointer to be filled in, or %NULL + allow-none="1"> + A pointer to a #GtkTreeViewColumn pointer to be filled in, or %NULL - + allow-none="1"> + A pointer where the X coordinate relative to the cell can be placed, or %NULL + - + allow-none="1"> + A pointer where the Y coordinate relative to the cell can be placed, or %NULL + - + + Retrieves whether the user can reorder the tree via drag-and-drop. See +gtk_tree_view_set_reorderable(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the tree can be reordered. + - + version="2.6" + introspectable="0"> + Returns the current row separator function. + + the current row separator function. - - - - - - - - - - - - - - - - - - - + Returns whether rubber banding is turned on for @tree_view. If the +selection mode is #GTK_SELECTION_MULTIPLE, rubber banding will allow the +user to select multiple rows by dragging the mouse. + + %TRUE if rubber banding in @tree_view is enabled. + - + + + + + + Gets the column searched on by the interactive search code. + + the column the interactive search code searches in. + + + + + Returns the #GtkEntry which is currently in use as interactive search +entry for @tree_view. In case the built-in entry is being used, %NULL +will be returned. - - - - - - - - - - - + the entry currently in use as search entry. + - - - + + Returns the compare function currently in use. + + the currently used compare function for the search code. + - - - - - - - - + + Returns the positioning function currently in use. + + the currently used function for positioning the search dialog. + + + + + Gets the #GtkTreeSelection associated with @tree_view. + + A #GtkTreeSelection object. + - - - - - + Returns whether or not expanders are drawn in @tree_view. +otherwise. - + %TRUE if expanders are drawn in @tree_view, %FALSE + - + Returns the column of @tree_view's model which is being used for +displaying tooltips on @tree_view's rows. +used, or -1 if this is disabled. - + the index of the tooltip column that is currently being + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This function is supposed to be used in a #GtkWidget::query-tooltip signal handler for #GtkTreeView. The @x, @y and @keyboard_tip values which are received in the signal handler, should be passed to this function without modification. @@ -72397,325 +64960,1275 @@ The return value indicates whether there is a tree view row at the given coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard tooltips the row returned will be the cursor row. When %TRUE, then any of that row and the corresponding model. @x and @y will always be converted -to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE." - version="2.12"> +to be relative to @tree_view's bin_window if @keyboard_tooltip is %FALSE. - + whether or not the given tooltip context points to a row. + - - + + the x coordinate (relative to widget coordinates) + - - + + the y coordinate (relative to widget coordinates) + - + whether this is a keyboard tooltip or not + + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + a pointer to receive a #GtkTreeModel or %NULL + direction="out" + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + a pointer to receive a #GtkTreePath or %NULL + a pointer to receive a #GtkTreeIter or %NULL + + + + + + Gets the #GtkAdjustment currently being used for the vertical aspect. +if none is currently being used. + + A #GtkAdjustment object, or %NULL + + + + + Sets @start_path and @end_path to be the first and last visible path. +Note that there may be invisible paths in between. +The paths should be freed with gtk_tree_path_free() after use. + + %TRUE, if valid paths were placed in @start_path and @end_path. + + + + + Return location for start of region, or %NULL. + + + + Return location for end of region, or %NULL. + + + + + + Fills @visible_rect with the currently-visible region of the +buffer, in tree coordinates. Convert to bin_window coordinates with +gtk_tree_view_convert_tree_to_bin_window_coords(). +Tree coordinates start at 0,0 for row 0 of the tree, and cover the entire +scrollable area of the tree. + + + + + + rectangle to fill + + + + + + This inserts the @column into the @tree_view at @position. If @position is +-1, then the column is inserted at the end. If @tree_view has +"fixed_height" mode enabled, then @column must have its "sizing" property +set to be GTK_TREE_VIEW_COLUMN_FIXED. + + The number of columns in @tree_view after insertion. + + + + + The #GtkTreeViewColumn to be inserted. + + + + The position to insert @column in. + + + + + + Creates a new #GtkTreeViewColumn and inserts it into the @tree_view at +the end. The column is initialized with the attributes given. If @tree_view +has "fixed_height" mode enabled, then the new column will have its sizing +property set to be GTK_TREE_VIEW_COLUMN_FIXED. + + The number of columns in @tree_view after insertion. + + + + + The position to insert the new column in. + + + + The title to set the header to. + + + + The #GtkCellRenderer. + + + + + + + + + + Convenience function that inserts a new column into the #GtkTreeView +with the given cell renderer and a #GtkCellDataFunc to set cell renderer +attributes (normally using data from the model). See also +gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start(). +If @tree_view has "fixed_height" mode enabled, then the new column will have its +"sizing" property set to be GTK_TREE_VIEW_COLUMN_FIXED. + + number of columns in the tree view post-insert + + + + + Position to insert, -1 for append + + + + column title + + + + cell renderer for column + + + + function to set attributes of cell renderer + + + + data for @func + + + + destroy notifier for @data + + + + + + Returns whether a rubber banding operation is currently being done +in @tree_view. +done in @tree_view. + + %TRUE if a rubber banding operation is currently being + + + + + Calls @func on all expanded rows. + + + + + + A function to be called + + + + User data to be passed to the function. + + + + + + Moves @column to be after to @base_column. If @base_column is %NULL, then + + + + + + The #GtkTreeViewColumn to be moved. + + + + The #GtkTreeViewColumn to be moved relative to, or %NULL. + + + + + + Removes @column from @tree_view. + + The number of columns in @tree_view after removing. + + + + + The #GtkTreeViewColumn to remove. + + + + + + Activates the cell determined by @path and @column. + + + + + + The #GtkTreePath to be activated. + + + + The #GtkTreeViewColumn to be activated. + + + + + + Returns %TRUE if the node pointed to by @path is expanded in @tree_view. + + %TRUE if #path is expanded. + + + + + A #GtkTreePath to test expansion state. + + + + + + Moves the alignments of @tree_view to the position specified by @column and +if @path is %NULL no vertical scrolling occurs. At a minimum, one of @column +or @path need to be non-%NULL. @row_align determines where the row is +placed, and @col_align determines where @column is placed. Both are expected +to be between 0.0 and 1.0. 0.0 means left/top alignment, 1.0 means +right/bottom alignment, 0.5 means center. +If @use_align is %FALSE, then the alignment arguments are ignored, and the +tree does the minimum amount of work to scroll the cell onto the screen. +This means that the cell will be scrolled to the edge closest to its current +position. If the cell is currently visible on the screen, nothing is done. +This function only works if the model is set, and @path is a valid row on the +model. If the model changes before the @tree_view is realized, the centered +path will be modified to reflect this change. + + + + + + The path of the row to move to, or %NULL. + + + + The #GtkTreeViewColumn to move horizontally to, or %NULL. + + + + whether to use alignment arguments, or %FALSE. + + + + The vertical alignment of the row specified by @path. + + + + The horizontal alignment of the column specified by @column. + + + + + + Scrolls the tree view such that the top-left corner of the visible +area is @tree_x, @tree_y, where @tree_x and @tree_y are specified +in tree coordinates. The @tree_view must be realized before +this function is called. If it isn't, you probably want to be +using gtk_tree_view_scroll_to_cell(). +If either @tree_x or @tree_y are -1, then that direction isn't scrolled. + + + + + + X coordinate of new top-left pixel of visible area, or -1 + + + + Y coordinate of new top-left pixel of visible area, or -1 + + + + + + Sets a user function for determining where a column may be dropped when +dragged. This function is called on every column pair in turn at the +beginning of a column drag to determine where a drop can take place. The +dragged, the two #GtkTreeViewColumn s determining the drop spot, and +are %NULL, then they indicate an edge. If @func is set to be %NULL, then +dropped everywhere. + + + + + - + scope="notified" + closure="1" + destroy="2"> + A function to determine which columns are reorderable, or %NULL. + + + + User data to be passed to @func, or %NULL + + + + Destroy notifier for @user_data, or %NULL + + + + + + Sets the current keyboard focus to be at @path, and selects it. This is +useful when you want to focus the user's attention on a particular row. If +it. Additionally, if @focus_column is specified, and @start_editing is +%TRUE, then editing should be started in the specified cell. +This function is often followed by @gtk_widget_grab_focus (@tree_view) +in order to give keyboard focus to the widget. Please note that editing +can only happen when the widget is realized. +If @path is invalid for @model, the current cursor (if any) will be unset +and the function will return without failing. + + + + + + A #GtkTreePath + + + + A #GtkTreeViewColumn, or %NULL + + + + %TRUE if the specified cell should start being edited. + + + + + + Sets the current keyboard focus to be at @path, and selects it. This is +useful when you want to focus the user's attention on a particular row. If +it. If @focus_column and @focus_cell are not %NULL, and @focus_column +contains 2 or more editable or activatable cells, then focus is given to +the cell specified by @focus_cell. Additionally, if @focus_column is +specified, and @start_editing is %TRUE, then editing should be started in +the specified cell. This function is often followed by +widget. Please note that editing can only happen when the widget is +realized. +If @path is invalid for @model, the current cursor (if any) will be unset +and the function will return without failing. + + + + + + A #GtkTreePath + + + + A #GtkTreeViewColumn, or %NULL + + + + A #GtkCellRenderer, or %NULL + + + + %TRUE if the specified cell should start being edited. + + + + + + This function should almost never be used. It is meant for private use by +ATK for determining the number of visible children that are removed when the +user collapses a row, or a row is deleted. + + + + + + Function to be called when a view row is destroyed, or %NULL + + + + User data to be passed to @func, or %NULL + + + + Destroy notifier for @data, or %NULL + + + + + + Sets the row that is highlighted for feedback. + + + + + + The path of the row to highlight, or %NULL. + + + + Specifies whether to drop before, after or into the row + + + + + + If @enable_search is set, then the user can type in text to search through +the tree interactively (this is sometimes called "typeahead find"). +Note that even if this is %FALSE, the user can still initiate a search +using the "start-interactive-search" key binding. + + + + + + %TRUE, if the user can search interactively + + + + + + Sets whether to draw lines interconnecting the expanders in @tree_view. +This does not have any visible effects for lists. + + + + + + %TRUE to enable tree line drawing, %FALSE otherwise. + + + + + + Sets the column to draw the expander arrow at. It must be in @tree_view. +If @column is %NULL, then the expander arrow is always at the first +visible column. +If you do not want expander arrow to appear in your tree, set the +expander column to a hidden column. + + + + + + %NULL, or the column to draw the expander arrow at. + + + + + + Enables or disables the fixed height mode of @tree_view. +Fixed height mode speeds up #GtkTreeView by assuming that all +rows have the same height. +Only enable this option if all rows are the same height and all +columns are of type %GTK_TREE_VIEW_COLUMN_FIXED. + + + + + + %TRUE to enable fixed height mode + + + + + + Sets which grid lines to draw in @tree_view. + + + + + + a #GtkTreeViewGridLines value indicating which grid lines to enable. + + + + + + Sets the #GtkAdjustment for the current horizontal aspect. + + + + + + The #GtkAdjustment to set, or %NULL + + + + + + Allow the column title buttons to be clicked. + + + + + + %TRUE if the columns are clickable. + + + + + + Sets the visibility state of the headers. + + + + + + %TRUE if the headers are visible + + + + + + Enables of disables the hover expansion mode of @tree_view. +Hover expansion makes rows expand or collapse if the pointer +moves over them. + + + + + + %TRUE to enable hover selection mode + + + + + + Enables of disables the hover selection mode of @tree_view. +Hover selection makes the selected row follow the pointer. +Currently, this works only for the selection modes +%GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE. + + + + + + %TRUE to enable hover selection mode + + + + + + Sets the amount of extra indentation for child levels to use in @tree_view +in addition to the default indentation. The value should be specified in +pixels, a value of 0 disables this feature and in this case only the default +indentation will be used. +This does not have any visible effects for lists. + + + + + + the amount, in pixels, of extra indentation in @tree_view. + + + + + + Sets the model for a #GtkTreeView. If the @tree_view already has a model +set, it will remove it before setting the new model. If @model is %NULL, +then it will unset the old model. + + + + + + The model. + + + + + + This function is a convenience function to allow you to reorder +models that support the #GtkDragSourceIface and the +#GtkDragDestIface. Both #GtkTreeStore and #GtkListStore support +these. If @reorderable is %TRUE, then the user can reorder the +model by dragging and dropping rows. The developer can listen to +these changes by connecting to the model's row_inserted and +row_deleted signals. The reordering is implemented by setting up +the tree view as a drag source and destination. Therefore, drag and +drop can not be used in a reorderable view for any other purpose. +This function does not give you any degree of control over the order -- any +reordering is allowed. If more control is needed, you should probably +handle drag and drop manually. + + + + + + %TRUE, if the tree can be reordered. + + + + + + Sets the row separator function, which is used to determine +whether a row should be drawn as a separator. If the row separator +function is %NULL, no separators are drawn. This is the default value. + + + + + + a #GtkTreeViewRowSeparatorFunc + + + + user data to pass to @func, or %NULL + + + + destroy notifier for @data, or %NULL + + + + + + Enables or disables rubber banding in @tree_view. If the selection mode +is #GTK_SELECTION_MULTIPLE, rubber banding will allow the user to select +multiple rows by dragging the mouse. + + + + + + %TRUE to enable rubber banding + + + + + + + + + + + + + + + + Sets @column as the column where the interactive search code should +search in for the current model. +If the search column is set, users can use the "start-interactive-search" +key binding to bring up search popup. The enable-search property controls +whether simply typing text will also start an interactive search. +Note that @column refers to a column of the current model. The search +column is reset to -1 when the model is changed. + + + + + + the column of the model to search in, or -1 to disable searching + + + + + + Sets the entry which the interactive search code will use for this +in our interface at all time at a fixed position. Passing %NULL for +entry again. + + + + + + the entry the interactive search code of @tree_view should use or %NULL + + + + + + Sets the compare function for the interactive search capabilities; note +that somewhat like strcmp() returning 0 for equality +#GtkTreeViewSearchEqualFunc returns %FALSE on matches. + + + + + + the compare function to use during the search + + + + user data to pass to @search_equal_func, or %NULL + + + + Destroy notifier for @search_user_data, or %NULL + + + + + + Sets the function to use when positioning the search dialog. + + + + + + the function to use to position the search dialog, or %NULL to use the default search position function + + + + user data to pass to @func, or %NULL + + + + Destroy notifier for @data, or %NULL + + + + + + Sets whether to draw and enable expanders and indent child rows in +and there will be no way to expand and collapse rows by default. Also +note that hiding the expanders will disable the default indentation. You +can set a custom indentation in this case using +gtk_tree_view_set_level_indentation(). +This does not have any visible effects for lists. + + + + + + %TRUE to enable expander drawing, %FALSE otherwise. + + + + + + Sets the tip area of @tooltip to the area @path, @column and @cell have +in common. For example if @path is %NULL and @column is set, the tip +area will be set to the full area covered by @column. See also +gtk_tooltip_set_tip_area(). +Note that if @path is not specified and @cell is set and part of a column +containing the expander, the tooltip might not show and hide at the correct +position. In such cases @path must be set to the current node under the +mouse cursor for this function to operate correctly. +See also gtk_tree_view_set_tooltip_column() for a simpler alternative. + + + + + + a #GtkTooltip + + + + a #GtkTreePath or %NULL + + + + a #GtkTreeViewColumn or %NULL + + + + a #GtkCellRenderer or %NULL + + If you only plan to have simple (text-only) tooltips on full rows, you can use this function to have #GtkTreeView handle these automatically -for you. @column should be set to the column in @tree_view's model +for you. @column should be set to the column in @tree_view's model containing the tooltip texts, or -1 to disable this feature. When enabled, #GtkWidget::has-tooltip will be set to %TRUE and Note that the signal handler sets the text with gtk_tooltip_set_markup(), -so &amp;, &lt;, etc have to be escaped in the text." - version="2.12"> +so &amp;, &lt;, etc have to be escaped in the text. - + an integer, which is a valid column number for @tree_view's model + - + Sets the tip area of @tooltip to be the area covered by the row at @path. +See also gtk_tree_view_set_tooltip_column() for a simpler alternative. +See also gtk_tooltip_set_tip_area(). - + + + + + a #GtkTooltip + + + + a #GtkTreePath + + + + + + Sets the #GtkAdjustment for the current vertical aspect. + + + + + + The #GtkAdjustment to set, or %NULL + + + + + + Undoes the effect of +gtk_tree_view_enable_model_drag_dest(). Calling this method sets +#GtkTreeView:reorderable to %FALSE. + + - - + + Undoes the effect of +gtk_tree_view_enable_model_drag_source(). Calling this method sets +#GtkTreeView:reorderable to %FALSE. + + + + + + - - + + - - + + - - + + - + transfer-ownership="none"> + Setting the ::fixed-height-mode property to %TRUE speeds up +#GtkTreeView by assuming that all rows have the same height. +Only enable this option if all rows are the same height. +Please see gtk_tree_view_set_fixed_height_mode() for more +information on this option. + - - + + - - + + - - + + + Enables or disables the hover expansion mode of @tree_view. +Hover expansion makes rows expand or collapse if the pointer moves over them. This mode is primarily intended for treeviews in popups, e.g. -in #GtkComboBox or #GtkEntryCompletion."> - +in #GtkComboBox or #GtkEntryCompletion. + + Enables or disables the hover selection mode of @tree_view. Hover selection makes the selected row follow the pointer. -Currently, this works only for the selection modes +Currently, this works only for the selection modes %GTK_SELECTION_SINGLE and %GTK_SELECTION_BROWSE. This mode is primarily intended for treeviews in popups, e.g. -in #GtkComboBox or #GtkEntryCompletion."> - +in #GtkComboBox or #GtkEntryCompletion. + - + transfer-ownership="none"> + Extra indentation for each level. + - - + + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + %TRUE if the view has expanders. + - - + + - - + + - + - - - + + The number of columns of the treeview has changed. + + - - - + + The position of the cursor (focused cell) has changed. + + - - + + - + - + - + - - + + - + - + - + The "row-activated" signal is emitted when the method +gtk_tree_view_row_activated() is called or the user double clicks +a treeview row. It is also emitted when a non-editable row is Enter is pressed. -For selection handling refer to the <link linkend="TreeWidget">tree -widget conceptual overview</link> as well as #GtkTreeSelection."> - - +For selection handling refer to the <link linkend="TreeWidget">tree +widget conceptual overview</link> as well as #GtkTreeSelection. + + - - + + the #GtkTreePath for the activated row + - - + + the #GtkTreeViewColumn in which the activation occurred + - - - + + The given row has been collapsed (child nodes are hidden). + + - - + + the tree iter of the collapsed row + - - + + a tree path that points to the row + - - - + + The given row has been expanded (child nodes are shown). + + - - + + the tree iter of the expanded row + - - + + a tree path that points to the row + - - + + - - + + - - + + - + - - + + - + - + - - + + - - - + + The given row is about to be collapsed (hide its children nodes). Use this +signal if you need to control the collapsibility of individual rows. + + %FALSE to allow collapsing, %TRUE to reject + - - + + the tree iter of the row to collapse + - - + + a tree path that points to the row + - - - + + The given row is about to be expanded (show its children nodes). Use this +signal if you need to control the expandability of individual rows. + + %FALSE to allow expansion, %TRUE to reject + - - + + the tree iter of the row to expand + - - + + a tree path that points to the row + - - + + - - + + @@ -72726,8 +66239,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72745,7 +66257,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72763,9 +66275,9 @@ signal if you need to control the expandability of individual rows."> - + - + @@ -72781,9 +66293,9 @@ signal if you need to control the expandability of individual rows."> - + - + @@ -72799,7 +66311,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72817,7 +66329,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72835,7 +66347,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72847,7 +66359,7 @@ signal if you need to control the expandability of individual rows."> - + @@ -72859,9 +66371,9 @@ signal if you need to control the expandability of individual rows."> - + - + @@ -72871,15 +66383,15 @@ signal if you need to control the expandability of individual rows."> - + - + - + @@ -72889,9 +66401,9 @@ signal if you need to control the expandability of individual rows."> - + - + @@ -72901,24 +66413,24 @@ signal if you need to control the expandability of individual rows."> - + - + - + - + - + @@ -72928,31 +66440,30 @@ signal if you need to control the expandability of individual rows."> - + - + - + - + - + - + - + @@ -72962,10 +66473,9 @@ signal if you need to control the expandability of individual rows."> - + - + @@ -72974,36 +66484,36 @@ signal if you need to control the expandability of individual rows."> - - + + - - + + - - + + - - + + - - + + @@ -73011,6 +66521,7 @@ signal if you need to control the expandability of individual rows."> glib:type-struct="TreeViewColumnClass"> - - + + Creates a new #GtkTreeViewColumn. + + A newly created #GtkTreeViewColumn. + Creates a new #GtkTreeViewColumn with a number of default values. This is equivalent to calling gtk_tree_view_column_set_title(), gtk_tree_view_column_pack_start(), and gtk_tree_view_column_set_attributes() on the newly created #GtkTreeViewColumn. -Here's a simple example: +Here's a simple example: |[ enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS }; ... { GtkTreeViewColumn *column; GtkCellRenderer *renderer = gtk_cell_renderer_text_new (); -column = gtk_tree_view_column_new_with_attributes ("Title", +column = gtk_tree_view_column_new_with_attributes ("Title", renderer, -"text", TEXT_COLUMN, -"foreground", COLOR_COLUMN, +"text", TEXT_COLUMN, +"foreground", COLOR_COLUMN, NULL); } -]|"> - +]| + + A newly created #GtkTreeViewColumn. + The title to set the header to. + The #GtkCellRenderer. @@ -73061,91 +66576,394 @@ NULL); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds an attribute mapping to the list in @tree_column. The @column is the column of the model to get a value from, and the @attribute is the parameter on @cell_renderer to be set from the value. So for example if column 2 of the model contains strings, you could have the -"text" attribute of a #GtkCellRendererText get its values from -column 2."> +"text" attribute of a #GtkCellRendererText get its values from +column 2. + the #GtkCellRenderer to set attributes on + An attribute on the renderer - + The column position on the model to get the attribute from. + + + + + + Obtains the horizontal position and size of a cell in a column. If the +cell is not found in the column, @start_pos and @width are not changed and +%FALSE is returned. + + %TRUE if @cell belongs to @tree_column. + + + + + a #GtkCellRenderer + + + + return location for the horizontal position of @cell within + + + + return location for the width of @cell, may be %NULL + + + + + + Obtains the width and height needed to render the column. This is used +primarily by the #GtkTreeView. + + + + + + The area a cell in the column will be allocated, or %NULL + + + + location to return x offset of a cell relative to @cell_area, or %NULL + + + + location to return y offset of a cell relative to @cell_area, or %NULL + + + + location to return width needed to render a cell, or %NULL + + + + location to return height needed to render a cell, or %NULL + + + + + + Returns %TRUE if any of the cells packed into the @tree_column are visible. +For this to be meaningful, you must first initialize the cells with +gtk_tree_view_column_cell_set_cell_data() + + %TRUE, if any of the cells packed into the @tree_column are currently visible + + + + + Sets the cell renderer based on the @tree_model and @iter. That is, for +every attribute mapping in @tree_column, it will get a value from the set +column on the @iter, and use that value to set the attribute on the cell +renderer. This is used primarily by the #GtkTreeView. + + + + + + The #GtkTreeModel to to get the cell renderers attributes from. + + + + The #GtkTreeIter to to get the cell renderer's attributes from. + + + + %TRUE, if the row has children + + + + %TRUE, if the row has visible children + + + + + + Unsets all the mappings on all renderers on the @tree_column. + + + + + + Clears all existing attributes previously set with +gtk_tree_view_column_set_attributes(). + + + + + + a #GtkCellRenderer to clear the attribute mapping on. + + + + + + Emits the "clicked" signal on the column. This function will only work if + + + + + + Sets the current keyboard focus to be at @cell, if the column contains +2 or more editable and activatable cells. + + + + + + A #GtkCellRenderer + + + + + + Returns the current x alignment of @tree_column. This value can range +between 0.0 and 1.0. + + The current alignent of @tree_column. + + + + + Returns %TRUE if the user can click on the header for the column. + + %TRUE if user can click the column header. + + + + + Return %TRUE if the column expands to take any available space. + + %TRUE, if the column expands + + + + + Gets the fixed width of the column. This value is only meaning may not be +the actual width of the column on the screen, just what is requested. + + the fixed width of the column + + + + + Returns the maximum width in pixels of the @tree_column, or -1 if no maximum +width is set. + + The maximum width of the @tree_column. + + + + + Returns the minimum width in pixels of the @tree_column, or -1 if no minimum +width is set. + + The minimum width of the @tree_column. + + + + + Returns %TRUE if the @tree_column can be reordered by the user. + + %TRUE if the @tree_column can be reordered by the user. + + + + + Returns %TRUE if the @tree_column can be resized by the end user. + + %TRUE, if the @tree_column can be resized. + + + + + Returns the current type of @tree_column. + + The type of @tree_column. + + + + + Gets the logical @sort_column_id that the model sorts on when this +column is selected for sorting. +See gtk_tree_view_column_set_sort_column_id(). +this column can't be used for sorting. + + the current @sort_column_id for this column, or -1 if + + + + + Gets the value set by gtk_tree_view_column_set_sort_indicator(). + + whether the sort indicator arrow is displayed + + + + + Gets the value set by gtk_tree_view_column_set_sort_order(). + + the sort order the sort indicator is indicating + + + + + Returns the spacing of @tree_column. + + the spacing of @tree_column. + + + + + Returns the title of the widget. +modified or freed. + + the title of the column. This string should not be + + + + + Returns the #GtkTreeView wherein @tree_column has been inserted. +If @column is currently not inserted in any tree view, %NULL is +returned. +been inserted if any, %NULL otherwise. + + The tree view wherein @column has + + + + + Returns %TRUE if @tree_column is visible. +the tree will show the column. + + whether the column is visible or not. If it is visible, then + + + + + Returns the #GtkWidget in the button on the column header. +If a custom widget has not been set then %NULL is returned. +header, or %NULL + + The #GtkWidget in the column + + + + + Returns the current size of @tree_column in pixels. + + The current width of @tree_column. + + + + + Adds the @cell to end of the column. If @expand is %FALSE, then the @cell +is allocated no more space than it needs. Any unused space is divided +evenly between cells for which @expand is %TRUE. + + + + + + The #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @tree_column. + + + + + + Packs the @cell into the beginning of the column. If @expand is %FALSE, then +the @cell is allocated no more space than it needs. Any unused space is divided +evenly between cells for which @expand is %TRUE. + + + + + + The #GtkCellRenderer. + + + + %TRUE if @cell is to be given extra space allocated to @tree_column. + + + + + + Flags the column, and the cell renderers added to this column, to have +their sizes renegotiated. + + + + + + Sets the alignment of the title or custom widget inside the column header. +The alignment determines its location inside the button -- 0.0 for left, 0.5 +for center, 1.0 for right. + + + + + + The alignment, which is between [0.0 and 1.0] inclusive. + + Sets the attributes in the list as the attributes of @tree_column. The attributes should be in attribute/column order, as in gtk_tree_view_column_add_attribute(). All existing attributes -are removed, and replaced with the new attributes."> +are removed, and replaced with the new attributes. + the #GtkCellRenderer we're setting the attributes of @@ -73155,600 +66973,318 @@ are removed, and replaced with the new attributes."> + Sets the #GtkTreeViewColumnFunc to use for the column. This function is used instead of the standard attributes mapping for -setting the column value, and should set the value of @tree_column's +setting the column value, and should set the value of @tree_column's cell renderer as appropriate. @func may be %NULL to remove an -older one."> +older one. + A #GtkCellRenderer + closure="2" + destroy="3"> + The #GtkTreeViewColumnFunc to use. - + The user data for @func. + - + + The destroy notification for @func_data - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + c:identifier="gtk_tree_view_column_set_clickable"> + Sets the header to be active if @active is %TRUE. When the header is active, +then it can take keyboard focus, and can be clicked. - + %TRUE if the header is active. + - - - - - - + + Sets the column to take available extra space. This space is shared equally +amongst all columns that have the expand set to %TRUE. If no column has this +option set, then the last column gets all extra space. By default, every +column is created with this %FALSE. - - + + %TRUE if the column should take available extra space, %FALSE if not + - - - - - - + + Sets the size of the column in pixels. This is meaningful only if the sizing +type is #GTK_TREE_VIEW_COLUMN_FIXED. The size of the column is clamped to +the min/max width for the column. Please note that the min/max width of the +column doesn't actually affect the "fixed_width" property of the widget, just +the actual size when displayed. - - + + The size to set @tree_column to. Must be greater than 0. + - + + Sets the maximum width of the @tree_column. If @max_width is -1, then the +maximum width is unset. Note, the column can actually be wider than max +width if it's the last column in a view. In this case, the column expands to +fill any extra space. - + + + + The maximum width of the column in pixels, or -1. + + + + + + Sets the minimum width of the @tree_column. If @min_width is -1, then the +minimum width is unset. + + + + + + The minimum width of the column in pixels, or -1. + + + + c:identifier="gtk_tree_view_column_set_reorderable"> + If @reorderable is %TRUE, then the column can be reordered by the end user +dragging the header. - + %TRUE, if the column can be reordered. + - + + If @resizable is %TRUE, then the user can explicitly resize the column by +grabbing the outer edge of the column button. If resizable is %TRUE and +sizing mode of the column is #GTK_TREE_VIEW_COLUMN_AUTOSIZE, then the sizing +mode is changed to #GTK_TREE_VIEW_COLUMN_GROW_ONLY. - + + + + %TRUE, if the column can be resized + + + + + + Sets the growth behavior of @tree_column to @type. + + + + + + The #GtkTreeViewColumnSizing. + + + + c:identifier="gtk_tree_view_column_set_sort_column_id"> + Sets the logical @sort_column_id that this column sorts on when this column +is selected for sorting. Doing so makes the column header clickable. - + The @sort_column_id of the model to sort on. + - - - - - + Call this function with a @setting of %TRUE to display an arrow in the header button indicating the column is sorted. Call gtk_tree_view_column_set_sort_order() to change the direction of -the arrow."> +the arrow. - + %TRUE to display an indicator that the column is sorted + - - - - - + Changes the appearance of the sort indicator. This <emphasis>does not</emphasis> actually sort the model. Use gtk_tree_view_column_set_sort_column_id() if you want automatic sorting support. This function is primarily for custom sorting behavior, and should be used in conjunction with gtk_tree_sortable_set_sort_column() to do -that. For custom models, the mechanism will vary. +that. For custom models, the mechanism will vary. The sort indicator changes direction to indicate normal sort or reverse sort. -Note that you must have the sort indicator enabled to see anything when -calling this function; see gtk_tree_view_column_set_sort_indicator()."> +Note that you must have the sort indicator enabled to see anything when +calling this function; see gtk_tree_view_column_set_sort_indicator(). + sort order that the sort indicator should indicate - - - - - - + + Sets the spacing field of @tree_column, which is the number of pixels to +place between cell renderers packed into it. - - - - - - - - - - - + + distance between cell renderers in pixels. + - + + Sets the title of the @tree_column. If a custom widget has been set, then +this value is ignored. - - - - - - - - - - - - - - + + The title of the @tree_column. + - - - - - - + + Sets the visibility of @tree_column. - - + + %TRUE if the @tree_column is visible. + - - - - - - - - - - - - - - - - - + + Sets the widget in the header to be @widget. If widget is %NULL, then the +header button is set with a #GtkLabel set to the title of @tree_column. + + + A child #GtkWidget, or %NULL. + + + - - - - - - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + transfer-ownership="none"> + Logical sort column ID this column sorts on when selected for sorting. Setting the sort column ID makes the column header +clickable. Set to %-1 to make the column unsortable. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -73775,92 +67311,94 @@ clickable. Set to %-1 to make the column unsortable."> - + - + - + - + - + - + - + - + - + - + - + - + - + + + - + - + - + - + - + - + - + - + - + - + - + - + - - + + @@ -73871,7 +67409,7 @@ clickable. Set to %-1 to make the column unsortable."> - + @@ -73882,29 +67420,29 @@ clickable. Set to %-1 to make the column unsortable."> - - + + - - + + - - + + - - + + @@ -73913,7 +67451,7 @@ clickable. Set to %-1 to make the column unsortable."> - + @@ -73929,7 +67467,7 @@ clickable. Set to %-1 to make the column unsortable."> - + @@ -74004,29 +67542,16 @@ clickable. Set to %-1 to make the column unsortable."> - + - - - - - + - + @@ -74036,21 +67561,21 @@ clickable. Set to %-1 to make the column unsortable."> - + - + - + @@ -74059,7 +67584,7 @@ clickable. Set to %-1 to make the column unsortable."> - + @@ -74076,345 +67601,354 @@ clickable. Set to %-1 to make the column unsortable."> - + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Creates a new ui manager object. + a new ui manager object. - - - - - - - - - - - - + + Looks up an action by following a path. See gtk_ui_manager_get_widget() +for more information about paths. +or %NULL if no widget was found. + + the action whose proxy widget is found by following the path, + a path - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Looks up a widget by following a path. +The path consists of the names specified in the XML description of the UI. +separated by '/'. Elements which don't have a name or action attribute in +the XML (e.g. &lt;popup&gt;) can be addressed by their XML element name +(e.g. "popup"). The root element ("/ui") can be omitted in the path. Note that the widget found by following a path that ends in a &lt;menu&gt; -element is the menuitem to which the menu is attached, not the menu itself. -Also note that the widgets constructed by a ui manager are not tied to -the lifecycle of the ui manager. If you add the widgets returned by this +element is the menuitem to which the menu is attached, not the menu itmanager. +Also note that the widgets constructed by a ui manager are not tied to +the lifecycle of the ui manager. If you add the widgets returned by this function to some container or explicitly ref them, they will survive the destruction of the ui manager. -was found." - version="2.4"> - +was found. + + the widget found by following the path, or %NULL if no widget + a path - - - - - - + + + Adds a UI element to the current contents of @manager. +If @type is %GTK_UI_MANAGER_AUTO, GTK+ inserts a menuitem, toolitem or +separator if such an element can be inserted at the place determined by +the place determined by @path. +If @path points to a menuitem or toolitem, the new element will be inserted +before or after this item, depending on @top. + + - + + the merge id for the merged UI, see gtk_ui_manager_new_merge_id() + + + + a path + + + + the name for the added UI element + + + + the name of the action to be proxied, or %NULL to add a separator + + + + the type of UI element to add. + + if %TRUE, the UI element is added before its siblings, otherwise it is added after its siblings. + + - - - + + Parses a file containing a <link linkend="XML-UI">UI definition</link> and +merges it with the current contents of @manager. +to unmerge the UI with gtk_ui_manager_remove_ui(). If an error occurred, +the return value is 0. + + The merge id for the merged UI. The merge id can be used + - + + the name of the file to parse + Parses a string containing a <link linkend="XML-UI">UI definition</link> and +merges it with the current contents of @manager. An enclosing &lt;ui&gt; +element is added if it is missing. +to unmerge the UI with gtk_ui_manager_remove_ui(). If an error occurred, +the return value is 0. - + The merge id for the merged UI. The merge id can be used + + the string to parse - + the length of @buffer (may be -1 if @buffer is nul-terminated) + - + + Makes sure that all pending updates to the UI have been completed. +This may occasionally be necessary, since #GtkUIManager updates the +UI in an idle function. A typical example where this function is +useful is to enforce that the menubar and toolbar have been added to +the main window before showing it: +|[ +gtk_container_add (GTK_CONTAINER (window), vbox); +g_signal_connect (merge, "add-widget", +G_CALLBACK (add_widget), vbox); +gtk_ui_manager_add_ui_from_file (merge, "my-menus"); +gtk_ui_manager_add_ui_from_file (merge, "my-toolbars"); +gtk_ui_manager_ensure_update (merge); +gtk_widget_show (window); +]| - + + + + + Returns the #GtkAccelGroup associated with @manager. + + the #GtkAccelGroup. + + + + + Looks up an action by following a path. See gtk_ui_manager_get_widget() +for more information about paths. +or %NULL if no widget was found. + + the action whose proxy widget is found by following the path, + - + + a path - + Returns the list of action groups associated with @manager. +action groups. The list is owned by GTK+ +and should not be modified. + + a #GList of + + + + + + + Returns whether menus generated by this #GtkUIManager +will have tearoff menu items. + + whether tearoff menu items are added + + + + + Obtains a list of all toplevel widgets of the requested types. +all toplevel widgets of the requested types. Free the returned list with g_slist_free(). + + a newly-allocated #GSList of + + + + + + + specifies the types of toplevel widgets to include. Allowed types are #GTK_UI_MANAGER_MENUBAR, #GTK_UI_MANAGER_TOOLBAR and #GTK_UI_MANAGER_POPUP. + + + + + + Creates a <link linkend="XML-UI">UI definition</link> of the merged UI. +the merged UI. + + A newly allocated string containing an XML representation of + + + + + Looks up a widget by following a path. +The path consists of the names specified in the XML description of the UI. +separated by '/'. Elements which don't have a name or action attribute in +the XML (e.g. &lt;popup&gt;) can be addressed by their XML element name +(e.g. "popup"). The root element ("/ui") can be omitted in the path. +Note that the widget found by following a path that ends in a &lt;menu&gt; +element is the menuitem to which the menu is attached, not the menu itmanager. +Also note that the widgets constructed by a ui manager are not tied to +the lifecycle of the ui manager. If you add the widgets returned by this +function to some container or explicitly ref them, they will survive the +destruction of the ui manager. +was found. + + the widget found by following the path, or %NULL if no widget + + + + + a path + + + + + + Inserts an action group into the list of action groups associated +with @manager. Actions in earlier groups hide actions with the same +name in later groups. - - + + the action group to be inserted + - - + + the position at which the group will be inserted. + - - - - - - - - - - - + + + + Returns an unused merge id, suitable for use with +gtk_ui_manager_add_ui(). + + an unused merge id. + + + + + Removes an action group from the list of action groups associated +with @manager. + + + + + + the action group to be removed + + Unmerges the part of @manager<!-- -->s content identified by @merge_id. - + a merge id as returned by gtk_ui_manager_add_ui_from_string() + - - - - - - + Sets the "add_tearoffs" property, which controls whether menus +generated by this #GtkUIManager will have tearoff menu items. +Note that this only affects regular menus. Generated popup +menus never have tearoff menu items. - - - - - + + + whether tearoff menu items are added + + + - + transfer-ownership="none"> + The "add-tearoffs" property controls whether generated menus +have tearoff menu items. +Note that this only affects regular menus. Generated popup +menus never have tearoff menu items. + - - + + @@ -74422,90 +67956,91 @@ menus never have tearoff menu items."> - - - + + The ::actions-changed signal is emitted whenever the set of actions +changes. + + - - - + + The ::add-widget signal is emitted for each generated menubar and toolbar. +It is not emitted for generated popup menus, which can be obtained by +gtk_ui_manager_get_widget(). + + - - + + the added widget + - + The ::connect-proxy signal is emitted after connecting a proxy to +an action in the group. This is intended for simple customizations for which a custom action class would be too clumsy, e.g. showing tooltips for menuitems in the -statusbar." - version="2.4"> - - +statusbar. + + - - + + the action + - - + + the proxy + - - - + + The ::disconnect-proxy signal is emitted after disconnecting a proxy +from an action in the group. + + - - + + the action + - - + + the proxy + - + The ::post-activate signal is emitted just after the @action is activated. This is intended for applications to get notification -just after any action is activated." - version="2.4"> - - +just after any action is activated. + + - - + + the action + - + The ::pre-activate signal is emitted just before the @action is activated. This is intended for applications to get notification -just before any action is activated." - version="2.4"> - - +just before any action is activated. + + - - + + the action + @@ -74517,12 +68052,12 @@ just before any action is activated." - + - + @@ -74532,24 +68067,24 @@ just before any action is activated." - + - + - + - + @@ -74562,12 +68097,12 @@ just before any action is activated." - + - + @@ -74580,12 +68115,12 @@ just before any action is activated." - + - + @@ -74595,12 +68130,12 @@ just before any action is activated." - + - + @@ -74610,8 +68145,9 @@ just before any action is activated." - - + + + the widget found by following the path, or %NULL if no widget @@ -74619,14 +68155,16 @@ just before any action is activated." + a path - - + + + the action whose proxy widget is found by following the path, @@ -74634,20 +68172,21 @@ just before any action is activated." + a path - - + + - - + + @@ -74703,7 +68242,7 @@ just before any action is activated." c:identifier="GTK_UI_MANAGER_POPUP_WITH_ACCELS" glib:nick="popup-with-accels"/> - + - - - + + + Creates a new #GtkVBox. + + a new #GtkVBox. + - + %TRUE if all children are to be given equal space allotments. + - + the number of pixels to place by default between children. + @@ -74776,6 +68319,7 @@ just before any action is activated." + - - + Creates a new vertical button box. + + a new button box #GtkWidget. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -74835,6 +68348,7 @@ just before any action is activated." + - - + Create a new #GtkVPaned + + the new #GtkVPaned + @@ -74860,6 +68377,7 @@ just before any action is activated." + - - + Creates a new vertical ruler + + a new #GtkVRuler. + @@ -74885,51 +68406,56 @@ just before any action is activated." + The #GtkVScale struct contains private data only, and +should be accessed using the functions below. - - - + + + Creates a new #GtkVScale. + + a new #GtkVScale. + + the #GtkAdjustment which sets the range of the scale. + Creates a new vertical scale widget that lets the user input a number between @min and @max (including @min and @max) with the -increment @step. @step must be nonzero; it's the distance the +increment @step. @step must be nonzero; it's the distance the slider moves when using the arrow keys to adjust the scale value. Note that the way in which the precision is derived works best if @step is a power of ten. If the resulting precision is not suitable for your -needs, use gtk_scale_set_digits() to correct it."> - - +needs, use gtk_scale_set_digits() to correct it. + + a new #GtkVScale + - + minimum value + - + maximum value + - - + + step increment (tick size) used with keyboard shortcuts + @@ -74945,27 +68471,29 @@ needs, use gtk_scale_set_digits() to correct it."> + The #GtkVScrollbar struct contains private data and should be accessed +using the functions below. - - - + + + Creates a new vertical scrollbar. + + the new #GtkVScrollbar + + allow-none="1"> + the #GtkAdjustment to use, or %NULL to create a new adjustment @@ -74982,21 +68510,23 @@ using the functions below." + The #GtkVSeparator struct contains private data only, and +should be accessed using the functions below. - - - + + + Creates a new #GtkVSeparator. + + a new #GtkVSeparator. + @@ -75011,6 +68541,7 @@ should be accessed using the functions below." - - - + + + Creates a new #GtkViewport with the given adjustments. + + a new #GtkViewport. + + horizontal adjustment. + vertical adjustment. + + Gets the bin window of the #GtkViewport. + + a #GdkWindow + + + - + c:identifier="gtk_viewport_get_hadjustment"> + Returns the horizontal adjustment of the viewport. + + the horizontal adjustment of @viewport. + + Gets the shadow type of the #GtkViewport. See +gtk_viewport_set_shadow_type(). + + the shadow type + + + - + c:identifier="gtk_viewport_get_vadjustment"> + Returns the vertical adjustment of the viewport. + + the vertical adjustment of @viewport. - + + Gets the view window of the #GtkViewport. - + a #GdkWindow + - - - - - - + + Sets the horizontal adjustment of the viewport. + allow-none="1"> + a #GtkAdjustment. @@ -75088,59 +68636,52 @@ should be accessed using the functions below." - - - + + Sets the vertical adjustment of the viewport. + + + + + a #GtkAdjustment. + + + - - - - - - - + + - - + + - - + + - - - - - - - - - - - - - - + + - - + + - + - + @@ -75152,8 +68693,7 @@ gtk_viewport_set_shadow_type()."> - + @@ -75171,36 +68711,23 @@ gtk_viewport_set_shadow_type()."> - - - - - + + - + + - - + + @@ -75213,29 +68740,29 @@ gtk_viewport_set_shadow_type()."> - - + + - - + + - - + + - - + + @@ -75243,6 +68770,7 @@ gtk_viewport_set_shadow_type()."> glib:type-struct="WidgetClass"> - + + This is a convenience function for creating a widget and setting its properties in one go. For example you might write: -<literal>gtk_widget_new (GTK_TYPE_LABEL, "label", "Hello World", "xalign", +<literal>gtk_widget_new (GTK_TYPE_LABEL, "label", "Hello World", "xalign", 0.0, NULL)</literal> to create a left-aligned label. Equivalent to -g_object_new(), but returns a widget so you don't have to -cast the object yourself."> - +g_object_new(), but returns a widget so you don't have to +cast the object yourself. + + a new #GtkWidget of type @widget_type + type ID of the widget to create + name of first property to set @@ -75276,505 +68806,122 @@ cast the object yourself."> - + + Obtains the default colormap used to create widgets. - + default widget colormap + - - - - - - + + Obtains the current default reading direction. See +gtk_widget_set_default_direction(). + + the current default direction. + + + + + Returns the default style used by all widgets initially. +by GTK+ and should not be modified or freed. + + the default style. This #GtkStyle object is owned + + + + + Obtains the visual of the default colormap. Not really useful; +used to be useful before gdk_colormap_get_visual() existed. + + visual of the default colormap + + + + + Removes a colormap pushed with gtk_widget_push_colormap(). + c:identifier="gtk_widget_pop_composite_child"> + Cancels the effect of a previous call to gtk_widget_push_composite_child(). - + + Pushes @cmap onto a global stack of colormaps; the topmost +colormap on the stack will be used to create all widgets. +Remove @cmap with gtk_widget_pop_colormap(). There's little +reason to use this function. + + + + + + a #GdkColormap + + + + + + Makes all newly-created widgets as composite children until +the corresponding gtk_widget_pop_composite_child() call. +A composite child is a child that's an implementation detail of the +container it's inside and should not be visible to people using the +container. Composite children aren't treated differently by GTK (but +see gtk_container_foreach() vs. gtk_container_forall()), but e.g. GUI +builders might want to treat them in a different way. +Here is a simple example: +|[ +gtk_widget_push_composite_child (); +scrolled_window->hscrollbar = gtk_hscrollbar_new (hadjustment); +gtk_widget_set_composite_name (scrolled_window->hscrollbar, "hscrollbar"); +gtk_widget_pop_composite_child (); +gtk_widget_set_parent (scrolled_window->hscrollbar, +GTK_WIDGET (scrolled_window)); +g_object_ref (scrolled_window->hscrollbar); +]| + Sets the default colormap to use when creating widgets. gtk_widget_push_colormap() is a better function to use if -you only want to affect a few widgets, rather than all widgets."> +you only want to affect a few widgets, rather than all widgets. + a #GdkColormap - - - - - - - - - - - - - - - + c:identifier="gtk_widget_set_default_direction"> + Sets the default reading direction for widgets where the +direction has not been explicitly set by gtk_widget_set_direction(). + the new default direction. This cannot be %GTK_TEXT_DIR_NONE. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -75783,32 +68930,77 @@ and position to their child widgets."> - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + Returns the accessible object that describes the widget to an +assistive technology. +If no accessibility library is loaded (i.e. no ATK implementation library is +loaded via <envar>GTK_MODULES</envar> or via another application library, +such as libgnome), then this #AtkObject instance may be a no-op. Likewise, +if no class-specific #AtkObject implementation is available for the widget +instance in question, it will inherit an #AtkObject implementation from the +first ancestor class for which such an implementation is defined. +The documentation of the <ulink url="http://developer.gnome.org/doc/API/2.0/atk/index.html">ATK</ulink> +library contains more information about accessible objects and their uses. + + the #AtkObject associated with @widget + + + + + Recursively hides a widget and any child widgets. + + + + + + Recursively shows a widget, and any child widgets (if the widget is +a container). + + + + + + For widgets that can be "activated" (buttons, menu items, etc.) +this function activates them. Activation is what happens when you +press Enter on a widget during key navigation. If @widget isn't +activatable, the function returns %FALSE. + + %TRUE if the widget was activatable + + @@ -75822,7 +69014,7 @@ gtk_widget_size_request()."> - + @@ -75832,871 +69024,79 @@ gtk_widget_size_request()."> - - - - - - - - - - - - - - - - - + + Adds the device events in the bitfield @events to the event mask for - - + + a #GdkDevice + - - + + an event mask, see #GdkEventMask + - - - + + Adds the events in the bitfield @events to the event mask for + + + + + an event mask, see #GdkEventMask + + + + + + Adds a widget to the list of mnemonic labels for +this widget. (See gtk_widget_list_mnemonic_labels()). Note the +list of mnemonic labels for the widget is cleared when the +widget is destroyed, so the caller must make sure to update +its internal state at this point as well, by using a connection +to the #GtkWidget::destroy signal or a weak notifier. + + + + + + a #GtkWidget that acts as a mnemonic label for @widget + + + + Determines whether an accelerator that activates the signal identified by @signal_id can currently be activated. This is done by emitting the #GtkWidget::can-activate-accel -signal on @widget; if the signal isn't overridden by a +signal on @widget; if the signal isn't overridden by a handler or in a derived widget, then the default check is that the widget must be sensitive, and the widget and all -its ancestors mapped." - version="2.4"> +its ancestors mapped. - + %TRUE if the accelerator can be activated. + - + the ID of a signal installed on @widget + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This function is used by custom widget implementations; if you're +writing an app, you'd use gtk_widget_grab_focus() to move the focus to a particular widget, and gtk_container_set_focus_chain() to change the focus tab order. So you may want to investigate those functions instead. @@ -76711,419 +69111,761 @@ moving in @direction left the focus on a focusable location inside that widget, and %FALSE if moving in @direction moved the focus outside the widget. If returning %TRUE, widgets normally call gtk_widget_grab_focus() to place the focus accordingly; -if returning %FALSE, they don't modify the current focus location. -This function replaces gtk_container_focus() from GTK+ 1.2. -It was necessary to check that the child was visible, sensitive, -and focusable before calling gtk_container_focus(). -gtk_widget_child_focus() returns %FALSE if the widget is not -currently in a focusable state, so there's no need for those checks."> +if returning %FALSE, they don't modify the current focus location. - + %TRUE if focus ended up inside @widget + + direction of focus movement - + + Emits a #GtkWidget::child-notify signal for the +<link linkend="child-properties">child property</link> @child_property +on @widget. +This is the analogue of g_object_notify() for child properties. - + - - + + the name of a child property installed on the class of @widget<!-- -->'s parent + + + Same as gtk_widget_path(), but always uses the name of a widget's type, +never uses a custom name set with gtk_widget_set_name(). + + + + + + location to store the length of the class path, or %NULL + + + + location to store the class path as an allocated string, or %NULL + + + + location to store the reverse class path as an allocated string, or %NULL + + + + + + Creates a new #PangoContext with the appropriate font map, +font description, and base direction for drawing text for +this widget. See also gtk_widget_get_pango_context(). + + the new #PangoContext + + + + + Creates a new #PangoLayout with the appropriate font map, +font description, and base direction for drawing text for +this widget. +If you keep a #PangoLayout created in this way around, in order to +notify the layout of changes to the base direction or font of this +widget, you must call pango_layout_context_changed() in response to +the #GtkWidget::style-set and #GtkWidget::direction-changed signals +for the widget. + + the new #PangoLayout + + + + + text to set on the layout (can be %NULL) + + + + + + Destroys a widget. Equivalent to gtk_object_destroy(), except that +you don't have to cast the widget to #GtkObject. When a widget is +destroyed, it will break any references it holds to other objects. +If the widget is inside a container, the widget will be removed +from the container. If the widget is a toplevel (derived from +#GtkWindow), it will be removed from the list of toplevels, and the +reference GTK+ holds to it will be removed. Removing a +widget from its container or the list of toplevels results in the +widget being finalized, unless you've added additional references +to the widget with g_object_ref(). +In most cases, only toplevel widgets (windows) require explicit +destruction, because when you destroy a toplevel its children will +be destroyed as well. + + + + + + This function sets *@widget_pointer to %NULL if @widget_pointer != +%NULL. It's intended to be used as a callback connected to the +"destroy" signal of a widget. You connect gtk_widget_destroyed() +as a signal handler, and pass the address of your widget variable +as user data. Then when the widget is destroyed, the variable will +be set to %NULL. Useful for example to avoid multiple copies +of the same dialog. + + + + + + address of a variable that contains @widget + + + + + + Returns %TRUE if @device has been shadowed by a GTK+ +device grab on another widget, so it would stop sending +events to @widget. This may be used in the +#GtkWidget::grab-notify signal to check for specific +devices. See gtk_device_grab_add(). +by another #GtkWidget than @widget. + + %TRUE if there is an ongoing grab on @device + + + + + a #GdkDevice + + + + + + Ensures that @widget has a style (@widget->style). Not a very useful +function; most of the time, if you want the style, the widget is +realized, and realized widgets are guaranteed to have a style +already. + + + + + Notifies the user about an input-related error on this widget. If the #GtkSettings:gtk-error-bell setting is %TRUE, it calls gdk_window_beep(), otherwise it does nothing. Note that the effect of gdk_window_beep() can be configured in many ways, depending on the windowing backend and the desktop environment -or window manager that is used." - version="2.12"> +or window manager that is used. - + + Rarely-used function. This function is used to emit +the event signals on a widget (those signals should never +be emitted without using this function to do so). +If you want to synthesize an event though, don't use this function; +instead, use gtk_main_do_event() so the event will behave as if +it were in the event queue. Don't synthesize expose events; instead, +use gdk_window_invalidate_rect() to invalidate a region of the +window. +the event was handled) + + return from the event signal emission (%TRUE if + + + + + a #GdkEvent + + + + + + Stops emission of #GtkWidget::child-notify signals on @widget. The +signals are queued until gtk_widget_thaw_child_notify() is called +on @widget. +This is the analogue of g_object_freeze_notify() for child properties. + + + + + + Returns the accessible object that describes the widget to an +assistive technology. +If no accessibility library is loaded (i.e. no ATK implementation library is +loaded via <envar>GTK_MODULES</envar> or via another application library, +such as libgnome), then this #AtkObject instance may be a no-op. Likewise, +if no class-specific #AtkObject implementation is available for the widget +instance in question, it will inherit an #AtkObject implementation from the +first ancestor class for which such an implementation is defined. +The documentation of the <ulink url="http://developer.gnome.org/doc/API/2.0/atk/index.html">ATK</ulink> +library contains more information about accessible objects and their uses. + + the #AtkObject associated with @widget + + + + + Retrieves the widget's allocation. +be its "adjusted" allocation, that is, the widget's parent +container typically calls gtk_widget_size_allocate() with an +allocation, and that allocation is then adjusted (to handle margin +and alignment for example) before assignment to the widget. +gtk_widget_get_allocation() returns the adjusted allocation that +was actually assigned to the widget. The adjusted allocation is +guaranteed to be completely contained within the +gtk_widget_size_allocate() allocation, however. So a #GtkContainer +is guaranteed that its children stay inside the assigned bounds, +but not that they have exactly the bounds the container assigned. +There is no way to get the original allocation assigned by +gtk_widget_size_allocate(), since it isn't stored; if a container +implementation needs that information it will have to track it itself. - - - - - + + a pointer to a #GtkAllocation to copy to + + + Gets the first ancestor of @widget with type @widget_type. For example, +<literal>gtk_widget_get_ancestor (widget, GTK_TYPE_BOX)</literal> gets +the first #GtkBox that's an ancestor of @widget. No reference will be +added to the returned widget; it should not be unreferenced. See note +about checking for a toplevel #GtkWindow in the docs for +gtk_widget_get_toplevel(). +Note that unlike gtk_widget_is_ancestor(), gtk_widget_get_ancestor() +considers @widget to be an ancestor of itself. + + the ancestor widget, or %NULL if not found + + + + + ancestor type + + + + + + Determines whether the application intends to draw on the widget in +an #GtkWidget::expose-event handler. +See gtk_widget_set_app_paintable() + + %TRUE if the widget is app paintable + + + + + Determines whether @widget can be a default widget. See +gtk_widget_set_can_default(). + + %TRUE if @widget can be a default widget, %FALSE otherwise + + + + + Determines whether @widget can own the input focus. See +gtk_widget_set_can_focus(). + + %TRUE if @widget can own the input focus, %FALSE otherwise + + + + + This function is only for use in widget implementations. Obtains +geometry on the widget (e.g. with gtk_widget_set_size_request()), +in which case it returns that geometry instead of the widget's +requisition. +This function differs from gtk_widget_size_request() in that +it retrieves the last size request value from @widget->requisition, +while gtk_widget_size_request() actually calls the "size_request" method +on @widget to compute the size request and fill in @widget->requisition, +and only then returns @widget->requisition. +Because this function does not call the "size_request" method, it +can only be used when you know that @widget->requisition is +up-to-date, that is, gtk_widget_size_request() has been called +since the last time a resize was queued. In general, only container +implementations have this information; applications should use +gtk_widget_size_request(). + + + + + + a #GtkRequisition to be filled in + + + + + + Gets the value set with gtk_widget_set_child_visible(). +If you feel a need to use this function, your code probably +needs reorganization. +This function is only useful for container implementations and +never should be called by an application. + + %TRUE if the widget is mapped with the parent. + + + + + Returns the clipboard object for the given selection to +be used with @widget. @widget must have a #GdkDisplay +associated with it, so must be attached to a toplevel +window. +clipboard already exists, a new one will +be created. Once a clipboard object has +been created, it is persistent for all time. + + the appropriate clipboard object. If no + + + + + a #GdkAtom which identifies the clipboard to use. %GDK_SELECTION_CLIPBOARD gives the default clipboard. Another common value is %GDK_SELECTION_PRIMARY, which gives the primary X selection. + + + + + + Gets the colormap that will be used to render @widget. No reference will +be added to the returned colormap; it should not be unreferenced. + + the colormap used by @widget + + + + + Obtains the composite name of a widget. +a composite child. The string should be freed when it is no +longer needed. + + the composite name of @widget, or %NULL if @widget is not + + + + + Returns the events mask for the widget corresponding to an specific device. These +are the events that the widget will receive when @device operates on it. + + device event mask for @widget + + + + + a #GdkDevice + + + + + + Gets the reading direction for a particular widget. See +gtk_widget_set_direction(). + + the reading direction for the widget. + + + + + Get the #GdkDisplay for the toplevel window associated with +this widget. This function can only be called after the widget +has been added to a widget hierarchy with a #GtkWindow at the top. +In general, you should only create display specific +resources when a widget has been realized, and you should +free those resources when the widget is unrealized. + + the #GdkDisplay for the toplevel for this widget. + + + + + Determines whether the widget is double buffered. +See gtk_widget_set_double_buffered() + + %TRUE if the widget is double buffered + + + + + Returns the event mask for the widget (a bitfield containing flags +from the #GdkEventMask enumeration). These are the events that the widget +will receive. + + event mask for @widget + + + + + Retrieves the extension events the widget will receive; see +gdk_input_set_extension_events(). + + extension events for @widget + + + + + Gets the value of the #GtkWidget:halign property. + + the horizontal alignment of @widget + + + + + Returns the current value of the has-tooltip property. See +GtkWidget:has-tooltip for more information. + + current value of has-tooltip on @widget. + + + + + Determines whether @widget has a #GdkWindow of its own. See +gtk_widget_set_has_window(). + + %TRUE if @widget has a window, %FALSE otherwise + + + + + Whether the widget is mapped. + + %TRUE if the widget is mapped, %FALSE otherwise. + + + + + Gets the value of the #GtkWidget:margin-bottom property. + + The bottom margin of @widget + + + + + Gets the value of the #GtkWidget:margin-left property. + + The left margin of @widget + + + + + Gets the value of the #GtkWidget:margin-right property. + + The left margin of @widget + + + + + Gets the value of the #GtkWidget:margin-top property. + + The top margin of @widget + + + + + Returns the current modifier style for the widget. (As set by +gtk_widget_modify_style().) If no style has previously set, a new +#GtkRcStyle will be created with all values unset, and set as the +modifier style for the widget. If you make changes to this rc +style, you must call gtk_widget_modify_style(), passing in the +returned rc style, to make sure that your changes take effect. +normally end up destroying it, because gtk_widget_modify_style() copies +the passed-in style and sets the copy as the new modifier style, +thus dropping any reference to the old modifier style. Add a reference +to the modifier style if you want to keep it alive. +owned by the widget. If you want to keep a pointer to value this +around, you must add a refcount using g_object_ref(). + + the modifier style for the widget. This rc style is + + + + + Retrieves the name of a widget. See gtk_widget_set_name() for the +significance of widget names. +should not be modified or freed + + name of the widget. This string is owned by GTK+ and + + + + + Returns the current value of the GtkWidget:no-show-all property, +which determines whether calls to gtk_widget_show_all() and +gtk_widget_hide_all() will affect this widget. + + the current value of the "no-show-all" property. + + + + + Gets a #PangoContext with the appropriate font map, font description, +and base direction for this widget. Unlike the context returned +by gtk_widget_create_pango_context(), this context is owned by +the widget (it can be used until the screen for the widget changes +or the widget is removed from its toplevel), and will be updated to +match any changes to the widget's attributes. +If you create and keep a #PangoLayout using this context, you must +deal with changes to the context by calling pango_layout_context_changed() +on the layout in response to the #GtkWidget::style-set and +#GtkWidget::direction-changed signals for the widget. + + the #PangoContext for the widget. + + + + + Returns the parent container of @widget. + + the parent container of @widget, or %NULL + + + + + Gets @widget's parent window. + + the parent window of @widget. + + + + + Obtains the location of the mouse pointer in widget coordinates. +Widget coordinates are a bit odd; for historical reasons, they are +defined as @widget->window coordinates for widgets that are not +#GTK_NO_WINDOW widgets, and are relative to @widget->allocation.x, + + + + + + return location for the X coordinate, or %NULL + + + + return location for the Y coordinate, or %NULL + + + + + + Determines whether @widget is realized. + + %TRUE if @widget is realized, %FALSE otherwise + + + + + Determines whether @widget is alyways treated as default widget +withing its toplevel when it has the focus, even if another widget +is the default. +See gtk_widget_set_receives_default(). +%FALSE otherwise + + %TRUE if @widget acts as default widget when focussed, + + + + + Retrieves the widget's requisition. +This function should only be used by widget implementations in +order to figure whether the widget's requisition has actually +changed after some internal state change (so that they can call +gtk_widget_queue_resize() instead of gtk_widget_queue_draw()). +Normally, gtk_widget_size_request() should be used. +removed, If you need to cache sizes across requests and allocations, +add an explicit cache to the widget in question instead. + + + + + + a pointer to a #GtkRequisition to copy to + + + + + + Get the root window where this widget is located. This function can +only be called after the widget has been added to a widget +hierarchy with #GtkWindow at the top. +The root window is useful for such purposes as creating a popup +#GdkWindow associated with the window. In general, you should only +create display specific resources when a widget has been realized, +and you should free those resources when the widget is unrealized. + + the #GdkWindow root window for the toplevel for this widget. + + + + + Get the #GdkScreen from the toplevel window associated with +this widget. This function can only be called after the widget +has been added to a widget hierarchy with a #GtkWindow +at the top. +In general, you should only create screen specific +resources when a widget has been realized, and you should +free those resources when the widget is unrealized. + + the #GdkScreen for the toplevel for this widget. + + + + + Returns the widget's sensitivity (in the sense of returning +the value that has been set using gtk_widget_set_sensitive()). +The effective sensitivity of a widget is however determined by both its +own and its parent widget's sensitivity. See gtk_widget_is_sensitive(). + + %TRUE if the widget is sensitive + + + + + Gets the settings object holding the settings (global property +settings, RC file information, etc) used for this widget. +Note that this function can only be called when the #GtkWidget +is attached to a toplevel, since the settings object is specific +to a particular #GdkScreen. + + the relevant #GtkSettings object + + + + Gets the size request that was explicitly set for the widget using gtk_widget_set_size_request(). A value of -1 stored in @width or and the natural requisition of the widget will be used intead. See gtk_widget_set_size_request(). To get the size a widget will -actually use, call gtk_widget_size_request() instead of -this function."> +actually request, call gtk_size_request_get_size() instead of +this function. - + allow-none="1"> + return location for width, or %NULL + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + allow-none="1"> + return location for height, or %NULL + + Create a #GdkPixmap of the contents of the widget and its children. Works even if the widget is obscured. The depth and visual of the resulting pixmap is dependent on the widget being snapshot and likely differs from those of a target widget displaying the pixmap. The function gdk_pixbuf_get_from_drawable() can be used to convert the pixmap to a visual independant representation. -The snapshot area used by this function is the @widget's allocation plus +The snapshot area used by this function is the @widget's allocation plus any extra space occupied by additional windows belonging to this widget (such as the arrows of a spin button). Thus, the resulting snapshot pixmap is possibly larger than the allocation. @@ -77138,214 +69880,570 @@ If non-%NULL, @clip_rect will contain the exact widget-relative snapshot coordinates upon return. A @clip_rect of <literal>{ -1, -1, 0, 0 }</literal> can be used to preserve the auto-grown snapshot area and use @clip_rect as a pure output parameter. -The returned pixmap can be %NULL, if the resulting @clip_area was empty." - version="2.14"> - +The returned pixmap can be %NULL, if the resulting @clip_area was empty. + + #GdkPixmap snapshot of the widget - + + a #GdkRectangle or %NULL - - - + + Returns the widget's state. See gtk_widget_set_state(). + + the state of @widget. + - + + Simply an accessor function that returns @widget->style. + + the widget's #GtkStyle + + + + + Returns %TRUE if @widget is multiple pointer aware. See +gtk_widget_set_support_multidevice() for more information. + + %TRUE is @widget is multidevice aware. + + + + + Gets the contents of the tooltip for @widget. +returned string with g_free() when done. + + the tooltip text, or %NULL. You should free the + + + + + Gets the contents of the tooltip for @widget. +returned string with g_free() when done. + + the tooltip text, or %NULL. You should free the + + + + + Returns the #GtkWindow of the current tooltip. This can be the +GtkWindow created by default, or the custom tooltip window set +using gtk_widget_set_tooltip_window(). + + The #GtkWindow of the current tooltip. + + + + + This function returns the topmost widget in the container hierarchy +returned as the topmost widget. No reference will be added to the +returned widget; it should not be unreferenced. +Note the difference in behavior vs. gtk_widget_get_ancestor(); +<literal>gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW)</literal> +would return +%NULL if @widget wasn't inside a toplevel window, and if the +window was inside a #GtkWindow-derived widget which was in turn +inside the toplevel #GtkWindow. While the second case may +seem unlikely, it actually happens when a #GtkPlug is embedded +inside a #GtkSocket within the same application. +To reliably find the toplevel #GtkWindow, use +gtk_widget_get_toplevel() and check if the %TOPLEVEL flags +is set on the result. +|[ +GtkWidget *toplevel = gtk_widget_get_toplevel (widget); +if (gtk_widget_is_toplevel (toplevel)) +{ +/&ast; Perform action on toplevel. &ast;/ +} +]| +if there's no ancestor. + + the topmost ancestor of @widget, or @widget itself + + + + + Gets the value of the #GtkWidget:valign property. + + the vertical alignment of @widget + + + + + Determines whether the widget is visible. Note that this doesn't +take into account whether the widget's parent is also visible +or the widget is obscured in any way. +See gtk_widget_set_visible(). + + %TRUE if the widget is visible + + + + + Gets the visual that will be used to render @widget. + + the visual for @widget + + + + + Returns the widget's window if it is realized, %NULL otherwise + + @widget's window. + + + + + Causes @widget to become the default widget. @widget must have the +%GTK_CAN_DEFAULT flag set; typically you have to set this flag +yourself by calling <literal>gtk_widget_set_can_default (@widget, +%TRUE)</literal>. The default widget is activated when +the user presses Enter in a window. Default widgets must be +activatable, that is, gtk_widget_activate() should affect them. Note +that #GtkEntry widgets require the "activates-default" property +set to %TRUE before they activate the default widget when Enter +is pressed and the #GtkEntry is focused. - - - - - - - - - - - + + Causes @widget to have the keyboard focus for the #GtkWindow it's +inside. @widget must be a focusable widget, such as a #GtkEntry; +something like #GtkFrame won't work. +More precisely, it must have the %GTK_CAN_FOCUS flag set. Use +gtk_widget_set_can_focus() to modify that flag. +The widget also needs to be realized and mapped. This is indicated by the +related signals. Grabbing the focus immediately after creating the widget +will likely fail and cause critical warnings. - - - - - - - - - + + Determines whether @widget is the current default widget within its +toplevel. See gtk_widget_set_can_default(). +its toplevel, %FALSE otherwise - + %TRUE if @widget is the current default widget within + - - - - - - + + Determines if the widget has the global input focus. See +gtk_widget_is_focus() for the difference between having the global +input focus, and only having the focus within a toplevel. - + %TRUE if the widget has the global input focus. + - - - - - - - - - - - - - - - - - - + Determines whether the widget is currently grabbing events, so it +is the only widget receiving input events (keyboard and mouse). +See also gtk_grab_add(). + + %TRUE if the widget is in the grab_widgets stack + + + + + Determines if the widget style has been looked up through the rc mechanism. +mechanism, %FALSE otherwise. + + %TRUE if the widget has been looked up through the rc + + + + + Checks whether there is a #GdkScreen is associated with +this widget. All toplevel widgets have an associated +screen, and all widgets added into a hierarchy with a toplevel +window at the top. +with the widget. + + %TRUE if there is a #GdkScreen associcated + + + + + Reverses the effects of gtk_widget_show(), causing the widget to be +hidden (invisible to the user). + + + + + + Recursively hides a widget and any child widgets. + + + + + + Utility function; intended to be connected to the #GtkWidget::delete-event signal on a #GtkWindow. The function calls gtk_widget_hide() on its argument, then returns %TRUE. If connected to ::delete-event, the result is that clicking the close button for a window (on the window frame, top right corner usually) will hide but not destroy the window. By default, GTK+ destroys windows when ::delete-event -is received."> +is received. - + %TRUE + - - - - - - - - - - - + + Sets an input shape for this widget's GDK window. This allows for +windows which react to mouse click in a nonrectangular region, see +gdk_window_input_shape_combine_mask() for more information. - - + allow-none="1"> + shape to be added, or %NULL to remove an existing shape + + + + X position of shape mask with respect to @window + + + + Y position of shape mask with respect to @window + - + + Computes the intersection of a @widget's area and @area, storing +the intersection in @intersection, and returns %TRUE if there was +an intersection. @intersection may be %NULL if you're only +interested in whether there was an intersection. + + %TRUE if there was an intersection + + + + + a rectangle + + + + rectangle to store intersection of @widget and @area + + + + + + Determines whether @widget is somewhere inside @ancestor, possibly with +intermediate containers. +grandchild, great grandchild, etc. + + %TRUE if @ancestor contains @widget as a child, + + + + + another #GtkWidget + + + + + + Whether @widget can rely on having its alpha channel +drawn correctly. On X11 this function returns whether a +compositing manager is running for @widget's screen. +Please note that the semantics of this call will change +in the future if used on a widget that has a composited +window in its hierarchy (as set by gdk_window_set_composited()). +channel being drawn correctly. + + %TRUE if the widget can rely on its alpha + + + + + Determines whether @widget can be drawn to. A widget can be drawn +to if it is mapped and visible. + + %TRUE if @widget is drawable, %FALSE otherwise + + + + + Determines if the widget is the focus widget within its +toplevel. (This does not mean that the %HAS_FOCUS flag is +necessarily set; %HAS_FOCUS will only be set if the +toplevel widget additionally has the global input focus.) + + %TRUE if the widget is the focus widget. + + + + + Returns the widget's effective sensitivity, which means +it is sensitive itself and also its parent widget is sensntive + + %TRUE if the widget is effectively sensitive + + + + + Determines whether @widget is a toplevel widget. Currently only +#GtkWindow and #GtkInvisible are toplevel widgets. Toplevel +widgets have no parent widget. + + %TRUE if @widget is a toplevel, %FALSE otherwise + + + + + This function should be called whenever keyboard navigation within +a single widget hits a boundary. The function emits the +#GtkWidget::keynav-failed signal on the widget and its return +value should be interpreted in a way similar to the return value of +gtk_widget_child_focus(): +When %TRUE is returned, stay in the widget, the failed keyboard +navigation is Ok and/or there is nowhere we can/should move the +focus to. +When %FALSE is returned, the caller should continue with keyboard +navigation outside the widget, e.g. by calling +gtk_widget_child_focus() on the widget's toplevel. +The default ::keynav-failed handler returns %TRUE for +%GTK_DIR_TAB_FORWARD and %GTK_DIR_TAB_BACKWARD. For the other +values of #GtkDirectionType, it looks at the +#GtkSettings:gtk-keynav-cursor-only setting and returns %FALSE +if the setting is %TRUE. This way the entire user interface +becomes cursor-navigatable on input devices such as mobile phones +which only have cursor keys but no tab key. +Whenever the default handler returns %TRUE, it also calls +gtk_widget_error_bell() to notify the user of the failed keyboard +navigation. +A use case for providing an own implementation of ::keynav-failed +(either by connecting to it or by overriding it) would be a row of +#GtkEntry widgets where the user should be able to navigate the +entire row with the cursor keys, as e.g. known from user interfaces +that require entering license keys. +if the emitting widget should try to handle the keyboard +navigation attempt in its parent container(s). + + %TRUE if stopping keyboard navigation is fine, %FALSE + + + + + direction of focus movement + + + + + + Lists the closures used by @widget for accelerator group connections +with gtk_accel_group_connect_by_path() or gtk_accel_group_connect(). +The closures can be used to monitor accelerator changes on @widget, +by connecting to the @GtkAccelGroup::accel-changed signal of the +#GtkAccelGroup of a closure which can be found out with +gtk_accel_group_from_accel_closure(). +a newly allocated #GList of closures + + + + + + + + Returns a newly allocated list of the widgets, normally labels, for +which this widget is the target of a mnemonic (see for example, +gtk_label_set_mnemonic_widget()). +The widgets in the list are not individually referenced. If you +want to iterate through the list and perform actions involving +callbacks that might destroy the widgets, you +<emphasis>must</emphasis> call <literal>g_list_foreach (result, +(GFunc)g_object_ref, NULL)</literal> first, and then unref all the +widgets afterwards. +mnemonic labels; free this list +with g_list_free() when you are done with it. + + the list of + + + + + + + This function is only for use in widget implementations. Causes +a widget to be mapped if it isn't already. - - - + + Emits the #GtkWidget::mnemonic-activate signal. +The default handler for this signal activates the @widget if +is %TRUE. + + %TRUE if the signal has been handled + + + + %TRUE if there are other widgets with the same mnemonic + + + - + Sets the base color for a widget in a particular state. +All other style values are left untouched. The base color +is the background color used along with the text color +(see gtk_widget_modify_text()) for widgets such as #GtkEntry +and #GtkTextView. See also gtk_widget_modify_style(). +Note that "no window" widgets (which have the %GTK_NO_WINDOW flag set) +draw on their parent container's window and thus may not draw any +background themselves. This is the case for e.g. #GtkLabel. To modify +the background of such widgets, you have to set the base color on their +parent; if you want to set the background of a rectangular area around +a label, try placing the label in a #GtkEventBox widget and setting +the base color on that. + + + + + + the state for which to set the base color + + + + the color to assign (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_base(). + + + + + + Sets the background color for a widget in a particular state. +All other style values are left untouched. See also +gtk_widget_modify_style(). +Note that "no window" widgets (which have the %GTK_NO_WINDOW flag set) +draw on their parent container's window and thus may not draw any +background themselves. This is the case for e.g. #GtkLabel. To modify +the background of such widgets, you have to set the background color +on their parent; if you want to set the background of a rectangular +area around a label, try placing the label in a #GtkEventBox widget +and setting the background color on that. + + + + + + the state for which to set the background color + + + + the color to assign (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_bg(). + + + + + + Sets the cursor color to use in a widget, overriding the +#GtkWidget:cursor-color and #GtkWidget:secondary-cursor-color +style properties. All other style values are left untouched. +See also gtk_widget_modify_style(). + + + + + + the color to use for primary cursor (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_cursor(). + + + + the color to use for secondary cursor (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_cursor(). + + + + + + Sets the foreground color for a widget in a particular state. +All other style values are left untouched. See also +gtk_widget_modify_style(). + + + + + + the state for which to set the foreground color + + + + the color to assign (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_fg(). + + + + + + Sets the font to use for a widget. All other style values are left +untouched. See also gtk_widget_modify_style(). + + + + + + the font description to use, or %NULL to undo the effect of previous calls to gtk_widget_modify_font(). + + + + + + Modifies style values on the widget. Modifications made using this technique take precedence over style values set via an RC file, however, they will be overriden if a style is explicitely set on the widget using gtk_widget_set_style(). The #GtkRcStyle structure @@ -77360,219 +70458,243 @@ make your modifications to the returned style, then call gtk_widget_modify_style() with that style. On the other hand, if you first call gtk_widget_modify_style(), subsequent calls to such functions gtk_widget_modify_fg() will have a cumulative -effect with the initial modifications."> +effect with the initial modifications. + the #GtkRcStyle holding the style modifications - - - - - - + Sets a symbolic color for a widget. All other style values are left untouched. See also -gtk_widget_modify_style()."> +gtk_widget_modify_style(). - - + + the name of the symbolic color to modify + + the color to assign (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_symbolic_color(). - - - - - - - - - - - - - - + Sets the text color for a widget in a particular state. All other style values are left untouched. The text color is the foreground color used along with the base color (see gtk_widget_modify_base()) for widgets such as #GtkEntry and #GtkTextView. See also -gtk_widget_modify_style()."> +gtk_widget_modify_style(). + the state for which to set the text color + the color to assign (does not need to be allocated), or %NULL to undo the effect of previous calls to of gtk_widget_modify_text(). - + + Obtains the full path to @widget. The path is simply the name of a +widget and all its parents in the container hierarchy, separated by +periods. The name of a widget comes from +gtk_widget_get_name(). Paths are used to apply styles to a widget +in gtkrc configuration files. Widget names are the type of the +widget by default (e.g. "GtkButton") or can be set to an +application-specific value with gtk_widget_set_name(). By setting +the name of a widget, you allow users or theme authors to apply +styles to that specific widget in their gtkrc +file. @path_reversed_p fills in the path in reverse order, +i.e. starting with @widget's name instead of starting with the name +of @widget's outermost ancestor. - - + + location to store length of the path, or %NULL + - - + + location to store allocated path string, or %NULL + + + + location to store allocated reverse path string, or %NULL + - + + Equivalent to calling gtk_widget_queue_draw_area() for the +entire area of a widget. + + + + + + Invalidates the rectangular area of @widget defined by @x, @y, +widget's window and all its child windows. Once the main loop +becomes idle (after the current batch of events has been processed, +roughly), the window will receive expose events for the union of +all regions that have been invalidated. +Normally you would only use this function in widget +implementations. You might also use it, or +gdk_window_invalidate_rect() directly, to schedule a redraw of a +#GtkDrawingArea or some portion thereof. +Frequently you can just call gdk_window_invalidate_rect() or +gdk_window_invalidate_region() instead of this function. Those +functions will invalidate only a single window, instead of the +widget and all its children. +The advantage of adding to the invalidated region compared to +simply drawing immediately is efficiency; using an invalid region +ensures that you only have to redraw one time. - - + + x coordinate of upper-left corner of rectangle to redraw + - - + + y coordinate of upper-left corner of rectangle to redraw + + + + width of region to draw + + + + height of region to draw + - + + This function is only for use in widget implementations. +Flags a widget to have its size renegotiated; should +be called when a widget for some reason has a new size request. +For example, when you change the text in a #GtkLabel, #GtkLabel +queues a resize to ensure there's enough space for the new text. - - - - - - + + This function works like gtk_widget_queue_resize(), +except that the widget is not invalidated. + + + + + + Creates the GDK (windowing system) resources associated with a +widget. For example, @widget->window will be created when a widget +is realized. Normally realization happens implicitly; if you show +a widget and all its parent containers, then the widget will be +realized and mapped automatically. +Realizing a widget requires all +the widget's parent widgets to be realized; calling +gtk_widget_realize() realizes the widget's parents in addition to +when you realize it, bad things will happen. +This function is primarily used in widget implementations, and +isn't very useful otherwise. Many times when you think you might +need it, a better approach is to connect to a signal that will be +called after the widget is realized automatically, such as +GtkWidget::expose-event. Or simply g_signal_connect () to the +GtkWidget::realize signal. + + + + + + Computes the intersection of a @widget's area and @region, returning +the intersection. The result may be empty, use cairo_region_is_empty() to +check. - - - - - - - - - - - + A newly allocated region holding the intersection of @widget and @region. The coordinates of the return value are relative to @widget->window for %NO_WINDOW widgets, and relative to the parent window of @widget->window for widgets with their own window. + - - + + a #cairo_region_t, in the same coordinate system as for %NO_WINDOW widgets; relative to the parent window of @widget->window for widgets with their own window. + - + Removes an accelerator from @widget, previously installed with +gtk_widget_add_accelerator(). + + whether an accelerator was installed and could be removed + + + + + accel group for this widget + + + + GDK keyval of the accelerator + + + + modifier key combination of the accelerator + + + + + + Removes a widget from the list of mnemonic labels for +this widget. (See gtk_widget_list_mnemonic_labels()). The widget +must have previously been added to the list with +gtk_widget_add_mnemonic_label(). + + + + + + a #GtkWidget that was previously set as a mnemnic label for + + + + + + A convenience function that uses the theme engine and RC file settings for @widget to look up @stock_id and render it to a pixbuf. @stock_id should be a stock icon ID such as #GTK_STOCK_OPEN or #GTK_STOCK_OK. @size should be a size @@ -77581,92 +70703,310 @@ identifies the widget or code doing the rendering, so that theme engines can special-case rendering for that widget or code. The pixels in the returned #GdkPixbuf are shared with the rest of the application and should not be modified. The pixbuf should be freed -after use with g_object_unref()."> +after use with g_object_unref(). +stock ID wasn't known + a new pixbuf, or %NULL if the + a stock ID - - + + a stock size. A size of (GtkIconSize)-1 means render at the size of the source and don't scale (if there are multiple source sizes, GTK+ picks one of the available sizes). + - + + render detail to pass to theme engine + + Moves a widget from one #GtkContainer to another, handling reference +count issues to avoid destroying the widget. + + + + + + a #GtkContainer to move the widget into + + + + + + Reset the styles of @widget and all descendents, so when +they are looked up again, they get the correct values +for the currently loaded RC file settings. +This function is not useful for applications. + + + + + + Recursively resets the shape on this widget and its descendants. + + + + + + Very rarely-used function. This function is used to emit +an expose event signals on a widget. This function is not +normally used directly. The only time it is used is when +propagating an expose event to a child %NO_WINDOW widget, and +that is normally done using gtk_container_propagate_expose(). +If you want to force an area of a window to be redrawn, +use gdk_window_invalidate_rect() or gdk_window_invalidate_region(). +To cause the redraw to be done immediately, follow that call +with a call to gdk_window_process_updates(). +the event was handled) + + return from the event signal emission (%TRUE if + + + + + a expose #GdkEvent + + + + + + Sends the focus change @event to @widget +This function is not meant to be used by applications. The only time it +should be used is when it is necessary for a #GtkWidget to assign focus +to a widget that is semantically owned by the first widget even though +it's not a direct child - for instance, a search entry in a floating +window similar to the quick search in #GtkTreeView. +An example of its usage is: +|[ +GdkEvent *fevent = gdk_event_new (GDK_FOCUS_CHANGE); +fevent->focus_change.type = GDK_FOCUS_CHANGE; +fevent->focus_change.in = TRUE; +fevent->focus_change.window = gtk_widget_get_window (widget); +if (fevent->focus_change.window != NULL) +g_object_ref (fevent->focus_change.window); +gtk_widget_send_focus_change (widget, fevent); +gdk_event_free (event); +]| +if the event was handled, and %FALSE otherwise + + the return value from the event signal emission: %TRUE + + + + + a #GdkEvent of type GDK_FOCUS_CHANGE + + + + + + Given an accelerator group, @accel_group, and an accelerator path, +key binding that is defined for @accel_path is pressed, @widget +will be activated. This removes any accelerators (for any +accelerator group) installed by previous calls to +gtk_widget_set_accel_path(). Associating accelerators with +paths allows them to be modified by the user and the modifications +to be saved for future use. (See gtk_accel_map_save().) +This function is a low level function that would most likely +be used by a menu creation system like #GtkUIManager. If you +use #GtkUIManager, setting up accelerator paths will be done +automatically. +Even when you you aren't using #GtkUIManager, if you only want to +set up accelerators on menu items gtk_menu_item_set_accel_path() +provides a somewhat more convenient interface. +Note that @accel_path string will be stored in a #GQuark. Therefore, if you +pass a static string, you can save some memory by interning it first with +g_intern_static_string(). + + + + + + path used to look up the accelerator + + + + a #GtkAccelGroup. + + + + + + Sets the widget's allocation. This should not be used +directly, but from within a widget's size_allocate method. +The allocation set should be the "adjusted" or actual +allocation. If you're implementing a #GtkContainer, you want to use +gtk_widget_size_allocate() instead of gtk_widget_set_allocation(). +The GtkWidgetClass::adjust_size_allocation virtual method adjusts the +allocation inside gtk_widget_size_allocate() to create an adjusted +allocation. + + + + + + a pointer to a #GtkAllocation to copy from + + + + + + Sets whether the application intends to draw on the widget in +an #GtkWidget::expose-event handler. +This is a hint to the widget and does not affect the behavior of +the GTK+ core; many widgets ignore this flag entirely. For widgets +that do pay attention to the flag, such as #GtkEventBox and #GtkWindow, +the effect is to suppress default themed drawing of the widget's +background. (Children of the widget will still be drawn.) The application +is then entirely responsible for drawing the widget background. +Note that the background is still drawn when the widget is mapped. +If this is not suitable (e.g. because you want to make a transparent +window using an RGBA visual), you can work around this by doing: +|[ +gtk_widget_realize (window); +gdk_window_set_back_pixmap (window->window, NULL, FALSE); +gtk_widget_show (window); +]| + + + + + + %TRUE if the application will paint on the widget + + + + + + Specifies whether @widget can be a default widget. See +gtk_widget_grab_default() for details about the meaning of +"default". + + + + + + whether or not @widget can be a default widget. + + + + + + Specifies whether @widget can own the input focus. See +gtk_widget_grab_focus() for actually setting the input focus on a +widget. + + + + + + whether or not @widget can own the input focus. + + + + + + Sets whether @widget should be mapped along with its when its parent +is mapped and @widget has been shown with gtk_widget_show(). +The child visibility can be set for widget before it is added to +a container with gtk_widget_set_parent(), to avoid mapping +children unnecessary before immediately unmapping them. However +it will be reset to its default state of %TRUE when the widget +is removed from a container. +Note that changing the child visibility of a widget does not +queue a resize on the widget. Most of the time, the size of +a widget is computed from all visible children, whether or +not they are mapped. If this is not the case, the container +can queue a resize itself. +This function is only useful for container implementations and +never should be called by an application. + + + + + + if %TRUE, @widget should be mapped along with its parent. + + + + + + Sets the colormap for the widget to the given value. Widget must not +have been previously realized. This probably should only be used +from an <function>init()</function> function (i.e. from the constructor +for the widget). + + + + + + a colormap + + + + + c:identifier="gtk_widget_set_composite_name"> + Sets a widgets composite name. The widget must be +a composite child of its parent; see gtk_widget_push_composite_child(). + the name to set - - - - - - - - - - - + + Sets the device event mask (see #GdkEventMask) for a widget. The event +mask determines which events a widget will receive from @device. Keep +in mind that different widgets have different default event masks, and by +changing the event mask you may disrupt a widget's functionality, +so be careful. This function must be called while a widget is +unrealized. Consider gtk_widget_add_device_events() for widgets that are +already realized, or if you want to preserve the existing event +mask. This function can't be used with #GTK_NO_WINDOW widgets; +to get events on those widgets, place them inside a #GtkEventBox +and receive events on the event box. - - + + a #GdkDevice + - - + + event mask + - - - - - - - - - - - - - - - + Sets the reading direction on a particular widget. This direction controls the primary direction for widgets containing text, and also the direction in which the children of a container are packed. The ability to set the direction is present in order @@ -77676,707 +71016,1205 @@ let the default reading direction present, except for containers where the containers are arranged in an order that is explicitely visual rather than logical (such as buttons for text justification). If the direction is set to %GTK_TEXT_DIR_NONE, then the value -set by gtk_widget_set_default_direction() will be used."> +set by gtk_widget_set_default_direction() will be used. + the new direction - - - - - - - - - - - + + Widgets are double buffered by default; you can use this function +to turn off the buffering. "Double buffered" simply means that +gdk_window_begin_paint_region() and gdk_window_end_paint() are called +automatically around expose events sent to the +widget. gdk_window_begin_paint() diverts all drawing to a widget's +window to an offscreen buffer, and gdk_window_end_paint() draws the +buffer to the screen. The result is that users see the window +update in one smooth step, and don't see individual graphics +primitives being rendered. +In very simple terms, double buffered widgets don't flicker, +so you would only use this function to turn off double buffering +if you had special needs and really knew what you were doing. +expose events, since even the clearing to the background color or +pixmap will not happen automatically (as it is done in +gdk_window_begin_paint()). - - - - - - - - + + %TRUE to double-buffer a widget + - + + Sets the event mask (see #GdkEventMask) for a widget. The event +mask determines which events a widget will receive. Keep in mind +that different widgets have different default event masks, and by +changing the event mask you may disrupt a widget's functionality, +so be careful. This function must be called while a widget is +unrealized. Consider gtk_widget_add_events() for widgets that are +already realized, or if you want to preserve the existing event +mask. This function can't be used with #GTK_NO_WINDOW widgets; +to get events on those widgets, place them inside a #GtkEventBox +and receive events on the event box. - - - - - - - - + + event mask + - - - - - - + + Sets the extension events mask to @mode. See #GdkExtensionMode +and gdk_input_set_extension_events(). - - - - - - - - + + bitfield of extension events to receive + - + + Sets the horizontal alignment of @widget. +See the #GtkWidget:halign property. - - - - - - - - + + the horizontal alignment + - - - - - - - - + Sets the has-tooltip property on @widget to @has_tooltip. See +GtkWidget:has-tooltip for more information. + + + + + + whether or not @widget has a tooltip. + + + + + + Specifies whether @widget has a #GdkWindow of its own. Note that +all realized widgets have a non-%NULL "window" pointer +(gtk_widget_get_window() never returns a %NULL window when a widget +is realized), but for many of them it's actually the #GdkWindow of +one of its parent widgets. Widgets that do not create a %window for +themselves in GtkWidget::realize() must announce this by +calling this function with @has_window = %FALSE. +This function should only be called by widget implementations, +and they should call it in their init() function. + + + + + + whether or not @widget has a window. + + + + + + Marks the widget as being realized. +This function should only ever be called in a derived widget's +"map" or "unmap" implementation. + + + + + + %TRUE to mark the widget as mapped + + + + + + Sets the bottom margin of @widget. +See the #GtkWidget:margin-bottom property. + + + + + + the bottom margin + + + + + + Sets the left margin of @widget. +See the #GtkWidget:margin-left property. + + + + + + the left margin + + + + + + Sets the right margin of @widget. +See the #GtkWidget:margin-right property. + + + + + + the right margin + + + + + + Sets the top margin of @widget. +See the #GtkWidget:margin-top property. + + + + + + the top margin + + + + + + Widgets can be named, which allows you to refer to them from a +gtkrc file. You can apply a style to widgets with a particular name +in the gtkrc file. See the documentation for gtkrc files (on the +same page as the docs for #GtkRcStyle). +Note that widget names are separated by periods in paths (see +gtk_widget_path()), so names with embedded periods may cause confusion. + + + + + + name for the widget + + + + + + Sets the #GtkWidget:no-show-all property, which determines whether +calls to gtk_widget_show_all() and gtk_widget_hide_all() will affect +this widget. +This is mostly for use in constructing widget hierarchies with externally +controlled visibility, see #GtkUIManager. - + + the new value for the "no-show-all" property + + + + + + This function is useful only when implementing subclasses of +#GtkContainer. +Sets the container as the parent of @widget, and takes care of +some details such as updating the state and style of the child +to reflect its new location. The opposite function is +gtk_widget_unparent(). + + + + + + parent container - + + Sets a non default parent window for @widget. - - + + the new parent window. + + + + + + Marks the widget as being realized. +This function should only ever be called in a derived widget's +"realize" or "unrealize" implementation. + + + + + + %TRUE to mark the widget as realized + + + + + + Specifies whether @widget will be treated as the default widget +within its toplevel when it has the focus, even if another widget +is the default. +See gtk_widget_grab_default() for details about the meaning of +"default". + + + + + + whether or not @widget can be a default widget. + + + + + + Sets whether the entire widget is queued for drawing when its size +allocation changes. By default, this setting is %TRUE and +the entire widget is redrawn on every size change. If your widget +leaves the upper left unchanged when made bigger, turning this +setting off will improve performance. +Note that for %NO_WINDOW widgets setting this flag to %FALSE turns +its position changes; this is to allow containers that don't draw +anything to avoid excess invalidations. If you set this flag on a +%NO_WINDOW widget that <emphasis>does</emphasis> draw on @widget->window, +you are responsible for invalidating both the old and new allocation +of the widget when the widget is moved and responsible for invalidating +regions newly when the widget increases size. + + + + + + if %TRUE, the entire widget will be redrawn when it is allocated to a new size. Otherwise, only the new portion of the widget will be redrawn. + + + + + + For widgets that support scrolling, sets the scroll adjustments and +returns %TRUE. For widgets that don't support scrolling, does +nothing and returns %FALSE. Widgets that don't support scrolling +can be scrolled by placing them in a #GtkViewport, which does +support scrolling. + + %TRUE if the widget supports scrolling + + + + + an adjustment for horizontal scrolling, or %NULL + + + + an adjustment for vertical scrolling, or %NULL + + + + + + Sets the sensitivity of a widget. A widget is sensitive if the user +can interact with it. Insensitive widgets are "grayed out" and the +user can't interact with them. Insensitive widgets are known as +"inactive", "disabled", or "ghosted" in some other toolkits. + + + + + + %TRUE to make the widget sensitive + + + + + + Sets the minimum size of a widget; that is, the widget's size +request will be @width by @height. You can use this function to +force a widget to be either larger or smaller than it normally +would be. +In most cases, gtk_window_set_default_size() is a better choice for +toplevel windows than this function; setting the default size will +still allow users to shrink the window. Setting the size request +will force them to leave the window at least as large as the size +request. When dealing with window sizes, +gtk_window_set_geometry_hints() can be a useful function as well. +Note the inherent danger of setting any fixed size - themes, +translations into other languages, different fonts, and user action +can all change the appropriate size for a given widget. So, it's +basically impossible to hardcode a size that will always be +correct. +The size request of a widget is the smallest size a widget can +accept while still functioning well and drawing itself correctly. +However in some strange cases a widget may be allocated less than +its requested size, and in many cases a widget may be allocated more +space than it requested. +If the size request in a given direction is -1 (unset), then +the "natural" size request of the widget will be used instead. +Widgets can't actually be allocated a size less than 1 by 1, but +you can pass 0,0 to this function to mean "as small as possible." +The size request set here does not include any margin from the +#GtkWidget properties margin-left, margin-right, margin-top, and +margin-bottom, but it does include pretty much all other padding +or border properties set by any subclass of #GtkWidget. + + + + + + width @widget should request, or -1 to unset + + + + height @widget should request, or -1 to unset + + + + + + This function is for use in widget implementations. Sets the state +of a widget (insensitive, prelighted, etc.) Usually you should set +the state using wrapper functions such as gtk_widget_set_sensitive(). + + + + + + new state for @widget + + + + + + Sets the #GtkStyle for a widget (@widget->style). You probably don't +want to use this function; it interacts badly with themes, because +themes work by replacing the #GtkStyle. Instead, use +gtk_widget_modify_style(). + + + + + + a #GtkStyle, or %NULL to remove the effect of a previous gtk_widget_set_style() and go back to the default style + + + + + + Enables or disables multiple pointer awareness. If this setting is %TRUE, +that if custom #GdkWindow<!-- -->s are created in #GtkWidget::realize, +gdk_window_set_support_multidevice() will have to be called manually on them. + + + + + + %TRUE to support input from multiple devices. + + + + + + Sets @markup as the contents of the tooltip, which is marked up with +the <link linkend="PangoMarkupFormat">Pango text markup language</link>. +This function will take care of setting GtkWidget:has-tooltip to %TRUE +and of the default handler for the GtkWidget::query-tooltip signal. +See also the GtkWidget:tooltip-markup property and +gtk_tooltip_set_markup(). + + + + + + the contents of the tooltip for @widget, or %NULL + + + + + + Sets @text as the contents of the tooltip. This function will take +care of setting GtkWidget:has-tooltip to %TRUE and of the default +handler for the GtkWidget::query-tooltip signal. +See also the GtkWidget:tooltip-text property and gtk_tooltip_set_text(). + + + + + + the contents of the tooltip for @widget + + Replaces the default, usually yellow, window used for displaying tooltips with @custom_window. GTK+ will take care of showing and hiding @custom_window at the right moment, to behave likewise as the default tooltip window. If @custom_window is %NULL, the default tooltip window will be used. If the custom window should have the default theming it needs to -have the name "gtk-tooltip", see gtk_widget_set_name()." - version="2.12"> +have the name "gtk-tooltip", see gtk_widget_set_name(). + allow-none="1"> + a #GtkWindow, or %NULL - - - + + Sets the vertical alignment of @widget. +See the #GtkWidget:valign property. + + + + + the vertical alignment + + + + + + Sets the visibility state of @widget. Note that setting this to +%TRUE doesn't mean the widget is actually viewable, see +gtk_widget_get_visible(). +This function simply calls gtk_widget_show() or gtk_widget_hide() +but is nicer to use when the visibility of the widget depends on +some condition. + + + + + + whether the widget should be shown or not + + + + + + Sets a widget's window. This function should only be used in a +widget's GtkWidget::realize() implementation. The %window passed is +usually either new window created with gdk_window_new(), or the +window of its parent widget as returned by +gtk_widget_get_parent_window(). +Widgets must indicate whether they will create their own #GdkWindow +by calling gtk_widget_set_has_window(). This is usually done in the +widget's init() function. +<note><para>This function does not add any reference to @window.</para></note> + + + + + + a #GdkWindow + + + + + + Sets a shape for this widget's GDK window. This allows for +transparent windows etc., see gdk_window_shape_combine_mask() +for more information. + + + + + + shape to be added, or %NULL to remove an existing shape + + + + X position of shape mask with respect to @window + + + + Y position of shape mask with respect to @window + + + + + + Flags a widget to be displayed. Any widget that isn't shown will +not appear on the screen. If you want to show all the widgets in a +container, it's easier to call gtk_widget_show_all() on the +container, instead of individually showing the widgets. +Remember that you have to show the containers containing a widget, +in addition to the widget itself, before it will appear onscreen. +When a toplevel container is shown, it is immediately realized and +mapped; other shown widgets are realized and mapped when their +toplevel container is realized and mapped. + + + + + + Recursively shows a widget, and any child widgets (if the widget is +a container). + + + + + + Shows a widget. If the widget is an unmapped toplevel widget +(i.e. a #GtkWindow that has not yet been shown), enter the main +loop and wait for the window to actually be mapped. Be careful; +because the main loop is running, anything can happen during +this function. + + + + + + This function is only used by #GtkContainer subclasses, to assign a size +and position to their child widgets. +In this function, the allocation may be adjusted. It will be forced +to a 1x1 minimum size, and the adjust_size_allocation virtual +method on the child will be used to adjust the allocation. Standard +adjustments include removing the widget's margins, and applying the +widget's #GtkWidget:halign and #GtkWidget:valign properties. + + + + + + position and size to be allocated to @widget + + + + + + This function is typically used when implementing a #GtkContainer +subclass. Obtains the preferred size of a widget. The container +uses this information to arrange its child widgets and decide what +size allocations to give them with gtk_widget_size_allocate(). +You can also call this function from an application, with some +caveats. Most notably, getting a size request requires the widget +to be associated with a screen, because font information may be +needed. Multihead-aware applications should keep this in mind. +Also remember that the size request is not necessarily the size +a widget will actually be allocated. + + + + + + a #GtkRequisition to be filled in + + + + + + This function attaches the widget's #GtkStyle to the widget's +#GdkWindow. It is a replacement for +<programlisting> +widget->style = gtk_style_attach (widget->style, widget->window); +</programlisting> +and should only ever be called in a derived widget's "realize" +implementation which does not chain up to its parent class' +"realize" implementation, because one of the parent classes +(finally #GtkWidget) would attach the style itself. + + + + + + Gets the values of a multiple style properties of @widget. + + + + + + the name of the first property to get + + + + + + + + + + Gets the value of a style property of @widget. + + + + + + the name of a style property + + + + location to return the property value + + + + + + Non-vararg variant of gtk_widget_style_get(). Used primarily by language +bindings. + + + + + + the name of the first property to get + + + + a <type>va_list</type> of pairs of property names and locations to return the property values, starting with the location for @first_property_name. + + + + + + Reverts the effect of a previous call to gtk_widget_freeze_child_notify(). +This causes all queued #GtkWidget::child-notify signals on @widget to be +emitted. + + + + + + Translate coordinates relative to @src_widget's allocation to coordinates +relative to @dest_widget's allocations. In order to perform this +operation, both widgets must be realized, and must share a common +toplevel. +was no common ancestor. In this case, nothing is stored in +*@dest_x and *@dest_y. Otherwise %TRUE. + + %FALSE if either widget was not realized, or there + + + + + a #GtkWidget + + + + X position relative to @src_widget + + + + Y position relative to @src_widget + + + + location to store X position relative to @dest_widget + + + + location to store Y position relative to @dest_widget + + + + Triggers a tooltip query on the display where the toplevel of @widget is located. See gtk_tooltip_trigger_tooltip_query() for more -information." - version="2.12"> +information. - + + This function is only for use in widget implementations. Causes +a widget to be unmapped if it's currently mapped. - - - - - - - - - - - + + This function is only for use in widget implementations. +Should be called by implementations of the remove method +on #GtkContainer, to dissociate a child from the container. - - - - - - - - - - - + + This function is only useful in widget implementations. +Causes a widget to be unrealized (frees all GDK resources +associated with the widget, such as @widget->window). - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + How to distribute horizontal space if widget gets extra space, see #GtkAlign + - - + + + + + + Enables or disables the emission of #GtkWidget::query-tooltip on @widget. A value of %TRUE indicates that @widget can have a tooltip, in this case the widget will be queried using #GtkWidget::query-tooltip to determine whether it will provide a tooltip or not. Note that setting this property to %TRUE for the first time will change the event masks of the GdkWindows of this widget to include leave-notify and motion-notify events. This cannot and will not be undone when the -property is set to %FALSE again."> - +property is set to %FALSE again. + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + + + + + + + + + + + + + + Sets the text of tooltip to be the given string, which is marked up +with the <link linkend="PangoMarkupFormat">Pango text markup language</link>. Also see gtk_tooltip_set_markup(). This is a convenience property which will take care of getting the will automatically be set to %TRUE and there will be taken care of -#GtkWidget::query-tooltip in the default signal handler."> - +#GtkWidget::query-tooltip in the default signal handler. + + Sets the text of tooltip to be the given string. Also see gtk_tooltip_set_text(). This is a convenience property which will take care of getting the will automatically be set to %TRUE and there will be taken care of -#GtkWidget::query-tooltip in the default signal handler."> - +#GtkWidget::query-tooltip in the default signal handler. + - - + + How to distribute vertical space if widget gets extra space, see #GtkAlign + - - + + - - + + + + + The widget's window if it is realized, %NULL otherwise. + - - + + - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - + The ::button-press-event signal will be emitted when a button (typically from a mouse) is pressed. -To receive this signal, the #GdkWindow associated to the +To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_BUTTON_PRESS_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - + the #GdkEventButton which triggered this signal. + - - - + + The ::button-release-event signal will be emitted when a button +(typically from a mouse) is released. +To receive this signal, the #GdkWindow associated to the +widget needs to enable the #GDK_BUTTON_RELEASE_MASK mask. +This signal will be sent to the grab widget if there is one. +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventButton which triggered this signal. + - + Determines whether an accelerator that activates the signal +identified by @signal_id can currently be activated. +This signal is present to allow applications and derived +widgets to override the default #GtkWidget handling +for determining whether an accelerator can be activated. + + %TRUE if the signal can be activated. + + + + + the ID of a signal installed on @widget + + + + + + The ::child-notify signal is emitted for each +<link linkend="child-properties">child property</link> that has +changed on an object. The signal's detail holds the property name. + + + + + + the #GParamSpec of the changed child property + + + + + + The ::client-event will be emitted when the @widget's window +receives a message (via a ClientMessage event) from another +application. +the event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for + + + + + the #GdkEventClient which triggered this signal. + + + + + + The ::composited-changed signal is emitted when the composited +status of @widget<!-- -->s screen changes. +See gdk_screen_is_composited(). + + + + + + + + + + + + + + + + Emitted when a redirected window belonging to @widget gets drawn into. +The region/area members of the event shows what area of the redirected +drawable was drawn into. +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + + + + + the #GdkEventExpose event + + + + + + The ::delete-event signal is emitted if a user requests that a toplevel window is closed. The default handler for this signal destroys the window. Connecting gtk_widget_hide_on_delete() to this signal will cause the window to be hidden instead, so that it can later be shown again without reconstructing it. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the event which triggered this signal + - + The ::destroy-event signal is emitted when a #GdkWindow is destroyed. +You rarely get this signal, because most widgets disconnect themselves +from their window before they destroy it, so no widget owns the window at destroy time. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the event which triggered this signal + - - - + + The ::direction-changed signal is emitted when the text direction +of a widget changes. + + - - + + the previous text direction of @widget + - + The ::drag-begin signal is emitted on the drag source when a drag is +started. A typical reason to connect to this signal is to set up a custom drag icon with gtk_drag_source_set_icon(). Note that some widgets set up a drag icon in the default handler of this signal, so you may have to use g_signal_connect_after() to -override what the default handler did."> - - +override what the default handler did. + + - - + + the drag context + - - - + + The ::drag-data-delete signal is emitted on the drag source when a drag +with the action %GDK_ACTION_MOVE is successfully completed. The signal +handler is responsible for deleting the data that has been dropped. What +"delete" means depends on the context of the drag operation. + + - - + + the drag context + - - - + + The ::drag-data-get signal is emitted on the drag source when the drop +site requests the data which is dragged. It is the responsibility of +the signal handler to fill @data with the data in the format which +is indicated by @info. See gtk_selection_data_set() and +gtk_selection_data_set_text(). + + - - + + the drag context + - - + + the #GtkSelectionData to be filled with the dragged data + - - + + the info that has been registered with the target in the #GtkTargetList + - - + + the timestamp at which the data was requested + - + The ::drag-data-received signal is emitted on the drop site when the +dragged data has been received. If the data was received in order to +determine whether the drop will be accepted, the handler is expected +to call gdk_drag_status() and <emphasis>not</emphasis> finish the drag. +If the data was received in response to a #GtkWidget::drag-drop signal +(and this is the last target to be received), the handler for this +signal is expected to process the received data and then call +gtk_drag_finish(), setting the @success parameter depending on whether +the data was processed successfully. +The handler may inspect and modify @drag_context->action before calling +gtk_drag_finish(), e.g. to implement %GDK_ACTION_ASK as shown in the following example: |[ -void +void drag_data_received (GtkWidget *widget, GdkDragContext *drag_context, gint x, @@ -78387,16 +72225,16 @@ guint time) { if ((data->length >= 0) && (data->format == 8)) { -if (drag_context->action == GDK_ACTION_ASK) +if (drag_context->action == GDK_ACTION_ASK) { GtkWidget *dialog; gint response; dialog = gtk_message_dialog_new (NULL, -GTK_DIALOG_MODAL | +GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT, GTK_MESSAGE_INFO, GTK_BUTTONS_YES_NO, -"Move the data ?\n"); +"Move the data ?\n"); response = gtk_dialog_run (GTK_DIALOG (dialog)); gtk_widget_destroy (dialog); if (response == GTK_RESPONSE_YES) @@ -78409,118 +72247,134 @@ return; } gtk_drag_finish (drag_context, FALSE, FALSE, time); } -]|"> - - +]| + + - - + + the drag context + - - + + where the drop happened + - - + + where the drop happened + - - + + the received data + - - + + the info that has been registered with the target in the #GtkTargetList + - - + + the timestamp at which the data was received + - - - + + The ::drag-drop signal is emitted on the drop site when the user drops +the data onto the widget. The signal handler must determine whether +the cursor position is in a drop zone or not. If it is not in a drop +zone, it returns %FALSE and no further processing is necessary. +Otherwise, the handler returns %TRUE. In this case, the handler must +ensure that gtk_drag_finish() is called to let the source know that +the drop is done. The call to gtk_drag_finish() can be done either +directly or in a #GtkWidget::drag-data-received handler which gets +triggered by calling gtk_drag_get_data() to receive the data for one +or more of the supported targets. + + whether the cursor position is in a drop zone + - - + + the drag context + - - + + the x coordinate of the current cursor position + - - + + the y coordinate of the current cursor position + - - + + the timestamp of the motion event + - - - + + The ::drag-end signal is emitted on the drag source when a drag is +finished. A typical reason to connect to this signal is to undo +things done in #GtkWidget::drag-begin. + + - - + + the drag context + - + The ::drag-failed signal is emitted on the drag source when a drag has failed. The signal handler may hook custom code to handle a failed DND operation based on the type of error, it returns %TRUE is the failure has -been already handled (not showing the default "drag operation failed" -animation), otherwise it returns %FALSE." - version="2.12"> - - +been already handled (not showing the default "drag operation failed" +animation), otherwise it returns %FALSE. + + %TRUE if the failed drag operation has been already handled. + - - + + the drag context + - - + + the result of the drag operation + - - - + + The ::drag-leave signal is emitted on the drop site when the cursor +leaves the widget. A typical reason to connect to this signal is to +undo things done in #GtkWidget::drag-motion, e.g. undo highlighting +with gtk_drag_unhighlight() + + - - + + the drag context + - - + + the timestamp of the motion event + - + The drag-motion signal is emitted on the drop site when the user moves the cursor over the widget during a drag. The signal handler must determine whether the cursor position is in a drop zone or not. If it is not in a drop zone, it returns %FALSE and no further processing is necessary. Otherwise, the handler returns %TRUE. In this case, the handler is responsible for providing the necessary information for displaying feedback to the user, by calling gdk_drag_status(). -If the decision whether the drop will be accepted or rejected can't be +If the decision whether the drop will be accepted or rejected can't be made based solely on the cursor position and the type of the data, the handler may inspect the dragged data by calling gtk_drag_get_data() and defer the gdk_drag_status() call to the #GtkWidget::drag-data-received @@ -78530,7 +72384,7 @@ when using the drag-motion signal that way. Also note that there is no drag-enter signal. The drag receiver has to keep track of whether he has received any drag-motion signals since the last #GtkWidget::drag-leave and if not, treat the drag-motion signal as -an "enter" signal. Upon an "enter", the handler will typically highlight +an "enter" signal. Upon an "enter", the handler will typically highlight the drop site with gtk_drag_highlight(). |[ static void @@ -78542,7 +72396,7 @@ guint time) { GdkAtom target; PrivateData *private_data = GET_PRIVATE_DATA (widget); -if (!private_data->drag_highlight) +if (!private_data->drag_highlight) { private_data->drag_highlight = 1; gtk_drag_highlight (widget); @@ -78550,7 +72404,7 @@ gtk_drag_highlight (widget); target = gtk_drag_dest_find_target (widget, context, NULL); if (target == GDK_NONE) gdk_drag_status (context, 0, time); -else +else { private_data->pending_status = context->suggested_action; gtk_drag_get_data (widget, context, target, time); @@ -78567,16 +72421,16 @@ guint info, guint time) { PrivateData *private_data = GET_PRIVATE_DATA (widget); -if (private_data->suggested_action) +if (private_data->suggested_action) { private_data->suggested_action = 0; /&ast; We are getting this data due to a request in drag_motion, * rather than due to a request in drag_drop, so we are just -* supposed to call gdk_drag_status (), not actually paste in +* supposed to call gdk_drag_status (), not actually paste in * the data. &ast;/ str = gtk_selection_data_get_text (selection_data); -if (!data_is_acceptable (str)) +if (!data_is_acceptable (str)) gdk_drag_status (context, 0, time); else gdk_drag_status (context, private_data->suggested_action, time); @@ -78586,650 +72440,661 @@ else /&ast; accept the drop &ast;/ } } -]|"> - - +]| + + whether the cursor position is in a drop zone + - - + + the drag context + - - + + the x coordinate of the current cursor position + - - + + the y coordinate of the current cursor position + - - + + the timestamp of the motion event + - + The ::enter-notify-event will be emitted when the pointer enters +the @widget's window. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_ENTER_NOTIFY_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventCrossing which triggered this signal. + - + The GTK+ main loop will emit three signals for each GDK event delivered +signal that matches the type of event delivered (e.g. +#GtkWidget::key-press-event) and finally a generic #GtkWidget::event-after signal. and to cancel the emission of the second specific ::event signal. -%FALSE to propagate the event further and to allow the emission of +%FALSE to propagate the event further and to allow the emission of the second signal. The ::event-after signal is emitted regardless of -the return value."> - - +the return value. + + %TRUE to stop other handlers from being invoked for the event + - - + + the #GdkEvent which triggered this signal + - - - + + After the emission of the #GtkWidget::event signal and (optionally) +the second more specific signal, ::event-after will be emitted +regardless of the previous two signals handlers return values. + + - - + + the #GdkEvent which triggered this signal + - + The ::expose-event signal is emitted when an area of a previously obscured #GdkWindow is made visible and needs to be redrawn. -#GTK_NO_WINDOW widgets will get a synthesized event from their parent +#GTK_NO_WINDOW widgets will get a synthesized event from their parent widget. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_EXPOSURE_MASK mask. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventExpose which triggered this signal. + - - + + %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further. + - - + + %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further. + - - + + - + - - + + - + - + Emitted when a pointer or keyboard grab on a window belonging +to @widget gets broken. +On X11, this happens when the grab window becomes unviewable +(i.e. it or one of its ancestors is unmapped), or if the same application grabs the pointer or keyboard again. -the event. %FALSE to propagate the event further." - version="2.8"> - - +the event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for + - - + + the #GdkEventGrabBroken event + - - + + - + The ::grab-notify signal is emitted when a widget becomes +shadowed by a GTK+ grab (not a pointer or keyboard grab) on +another widget, or when it becomes unshadowed due to a grab being removed. -A widget is shadowed by a gtk_grab_add() when the topmost -grab widget in the grab stack of its window group is not -its ancestor."> - - +A widget is shadowed by a gtk_grab_add() when the topmost +grab widget in the grab stack of its window group is not +its ancestor. + + - - + + %FALSE if the widget becomes shadowed, %TRUE if it becomes unshadowed + - - + + - + The ::hierarchy-changed signal is emitted when the anchored state of a widget changes. A widget is <firstterm>anchored</firstterm> when its toplevel ancestor is a #GtkWindow. This signal is emitted when -a widget changes from un-anchored to anchored or vice-versa."> - - +a widget changes from un-anchored to anchored or vice-versa. + + - - + + the previous toplevel ancestor, or %NULL if the widget was previously unanchored + - + The ::key-press-event signal is emitted when a key is pressed. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_KEY_PRESS_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventKey which triggered this signal. + - + The ::key-release-event signal is emitted when a key is pressed. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_KEY_RELEASE_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventKey which triggered this signal. + - + Gets emitted if keyboard navigation fails. See gtk_widget_keynav_failed() for details. if the emitting widget should try to handle the keyboard -navigation attempt in its parent container(s)." - version="2.12"> - - +navigation attempt in its parent container(s). + + %TRUE if stopping keyboard navigation is fine, %FALSE + - - + + the direction of movement + - + The ::leave-notify-event will be emitted when the pointer leaves +the @widget's window. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_LEAVE_NOTIFY_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventCrossing which triggered this signal. + - - + + - - + + - + - - + + - - + + - + The ::motion-notify-event signal is emitted when the pointer moves +over the widget's #GdkWindow. +To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_POINTER_MOTION_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventMotion which triggered this signal. + - - + + - - + + - - - + + The ::no-expose-event will be emitted when the @widget's window is +drawn as a copy of another #GdkDrawable which was completely unobscured. +If the source window was partially obscured #GdkEventExpose events will +be generated for those areas. +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventNoExpose which triggered this signal. + - - - + + The ::parent-set signal is emitted when a new parent +has been set on a widget. + + - - + + the previous parent, or %NULL if the widget just got its initial parent. + - - + + - - + + - + - - + + - + - - + + - + - + Emitted when #GtkWidget:has-tooltip is %TRUE and the #GtkSettings:gtk-tooltip-timeout +has expired with the cursor hovering "above" @widget; or emitted when @widget got focus in keyboard mode. Using the given coordinates, the signal handler should determine whether a tooltip should be shown for @widget. If this is the case %TRUE should be returned, %FALSE otherwise. Note that if should not be used. The signal handler is free to manipulate @tooltip with the therefore -destined function calls." - version="2.12"> - - +destined function calls. + + %TRUE if @tooltip should be shown right now, %FALSE otherwise. + - - + + the x coordinate of the cursor position where the request has been emitted, relative to @widget->window + - - + + the y coordinate of the cursor position where the request has been emitted, relative to @widget->window + - - + + %TRUE if the tooltip was trigged using the keyboard + - - + + a #GtkTooltip + - - + + - - - + + The ::screen-changed signal gets emitted when the +screen of a widget has changed. + + - - + + the previous screen, or %NULL if the widget was not associated with a screen before + - + The ::scroll-event signal is emitted when a button in the 4 to 7 +range is pressed. Wheel mice are usually configured to generate button press events for buttons 4 and 5 when the wheel is turned. To receive this signal, the #GdkWindow associated to the widget needs to enable the #GDK_BUTTON_PRESS_MASK mask. This signal will be sent to the grab widget if there is one. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventScroll which triggered this signal. + - - + + - + - - + + - - + + - - + + - - + + - - + + %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further. + - - + + %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further. + - - + + - - + + - - + + - - + + - + - - + + - - + + - - + + - - - + + + - - + + - - + + - - + + - - - + + The ::state-changed signal is emitted when the widget state changes. +See gtk_widget_get_state(). + + - - + + the previous state + - - - + + The ::style-set signal is emitted when a new style has been set +on a widget. Note that style-modifying functions like +gtk_widget_modify_base() also cause this signal to be emitted. + + - - + + the previous style, or %NULL if the widget just got its initial style + - - + + - - + + - + - - + + - + The ::visibility-notify-event will be emitted when the @widget's window is obscured or unobscured. To receive this signal the #GdkWindow associated to the widget needs to enable the #GDK_VISIBILITY_NOTIFY_MASK mask. -%FALSE to propagate the event further."> - - +%FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the event. + - - + + the #GdkEventVisibility which triggered this signal. + - + The ::window-state-event will be emitted when the state of the toplevel window associated to the @widget changes. -To receive this signal the #GdkWindow associated to the widget -needs to enable the #GDK_STRUCTURE_MASK mask. GDK will enable +To receive this signal the #GdkWindow associated to the widget +needs to enable the #GDK_STRUCTURE_MASK mask. GDK will enable this mask automatically for all new windows. -event. %FALSE to propagate the event further."> - - +event. %FALSE to propagate the event further. + + %TRUE to stop other handlers from being invoked for the + - - + + the #GdkEventWindowState which triggered this signal. + - - - - - - - + - + - - + + - - + + + + + + glib:is-gtype-struct-for="Widget"> - + - + - + @@ -79238,7 +73103,7 @@ Implementation of this signal is optional."> - + @@ -79247,7 +73112,7 @@ Implementation of this signal is optional."> - + @@ -79259,7 +73124,7 @@ Implementation of this signal is optional."> - + @@ -79271,7 +73136,7 @@ Implementation of this signal is optional."> - + @@ -79283,7 +73148,7 @@ Implementation of this signal is optional."> - + @@ -79295,7 +73160,7 @@ Implementation of this signal is optional."> - + @@ -79307,7 +73172,7 @@ Implementation of this signal is optional."> - + @@ -79319,7 +73184,7 @@ Implementation of this signal is optional."> - + @@ -79331,7 +73196,7 @@ Implementation of this signal is optional."> - + @@ -79343,7 +73208,7 @@ Implementation of this signal is optional."> - + @@ -79358,7 +73223,7 @@ Implementation of this signal is optional."> - + @@ -79373,7 +73238,7 @@ Implementation of this signal is optional."> - + @@ -79388,7 +73253,7 @@ Implementation of this signal is optional."> - + @@ -79403,7 +73268,7 @@ Implementation of this signal is optional."> - + @@ -79418,7 +73283,7 @@ Implementation of this signal is optional."> - + @@ -79433,7 +73298,7 @@ Implementation of this signal is optional."> - + @@ -79448,7 +73313,7 @@ Implementation of this signal is optional."> - + @@ -79457,13 +73322,13 @@ Implementation of this signal is optional."> - + - + @@ -79478,22 +73343,22 @@ Implementation of this signal is optional."> - + - + - + - + @@ -79505,9 +73370,9 @@ Implementation of this signal is optional."> - + - + @@ -79520,9 +73385,9 @@ Implementation of this signal is optional."> - + - + @@ -79535,9 +73400,9 @@ Implementation of this signal is optional."> - + - + @@ -79550,9 +73415,9 @@ Implementation of this signal is optional."> - + - + @@ -79565,9 +73430,9 @@ Implementation of this signal is optional."> - + - + @@ -79580,9 +73445,9 @@ Implementation of this signal is optional."> - + - + @@ -79595,9 +73460,9 @@ Implementation of this signal is optional."> - + - + @@ -79610,9 +73475,9 @@ Implementation of this signal is optional."> - + - + @@ -79625,9 +73490,9 @@ Implementation of this signal is optional."> - + - + @@ -79640,9 +73505,9 @@ Implementation of this signal is optional."> - + - + @@ -79655,9 +73520,9 @@ Implementation of this signal is optional."> - + - + @@ -79670,9 +73535,9 @@ Implementation of this signal is optional."> - + - + @@ -79685,9 +73550,9 @@ Implementation of this signal is optional."> - + - + @@ -79700,9 +73565,9 @@ Implementation of this signal is optional."> - + - + @@ -79715,9 +73580,9 @@ Implementation of this signal is optional."> - + - + @@ -79730,9 +73595,9 @@ Implementation of this signal is optional."> - + - + @@ -79745,9 +73610,9 @@ Implementation of this signal is optional."> - + - + @@ -79760,9 +73625,9 @@ Implementation of this signal is optional."> - + - + @@ -79775,9 +73640,9 @@ Implementation of this signal is optional."> - + - + @@ -79790,9 +73655,9 @@ Implementation of this signal is optional."> - + - + @@ -79805,10 +73670,9 @@ Implementation of this signal is optional."> - + - + @@ -79821,10 +73685,9 @@ Implementation of this signal is optional."> - + - + @@ -79837,9 +73700,9 @@ Implementation of this signal is optional."> - + - + @@ -79852,9 +73715,9 @@ Implementation of this signal is optional."> - + - + @@ -79867,10 +73730,9 @@ Implementation of this signal is optional."> - + - + @@ -79883,9 +73745,9 @@ Implementation of this signal is optional."> - + - + @@ -79898,9 +73760,9 @@ Implementation of this signal is optional."> - + - + @@ -79913,9 +73775,9 @@ Implementation of this signal is optional."> - + - + @@ -79928,7 +73790,7 @@ Implementation of this signal is optional."> - + @@ -79940,16 +73802,16 @@ Implementation of this signal is optional."> - + - + - + @@ -79961,13 +73823,13 @@ Implementation of this signal is optional."> - + - + @@ -79982,7 +73844,7 @@ Implementation of this signal is optional."> - + @@ -79997,7 +73859,7 @@ Implementation of this signal is optional."> - + @@ -80012,16 +73874,16 @@ Implementation of this signal is optional."> - + - + - + @@ -80036,7 +73898,7 @@ Implementation of this signal is optional."> - + @@ -80048,15 +73910,15 @@ Implementation of this signal is optional."> - + - + - + @@ -80066,21 +73928,21 @@ Implementation of this signal is optional."> - + - + - + - + - + @@ -80090,19 +73952,19 @@ Implementation of this signal is optional."> - + - + - + - + @@ -80114,27 +73976,27 @@ Implementation of this signal is optional."> - + - + - + - + - + - + @@ -80144,9 +74006,9 @@ Implementation of this signal is optional."> - + - + @@ -80159,8 +74021,9 @@ Implementation of this signal is optional."> - - + + + the #AtkObject associated with @widget @@ -80171,7 +74034,7 @@ Implementation of this signal is optional."> - + @@ -80186,24 +74049,24 @@ Implementation of this signal is optional."> - + - + - + - + - + @@ -80216,7 +74079,7 @@ Implementation of this signal is optional."> - + @@ -80228,22 +74091,22 @@ Implementation of this signal is optional."> - + - + - + - + - + @@ -80251,125 +74114,171 @@ Implementation of this signal is optional."> - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Finds a style property of a widget class by name. + + the #GParamSpec of the style property or %NULL if @class has no style property with that name. + + + + + the name of the style property to find + + + + + c:identifier="gtk_widget_class_install_style_property"> + Installs a style property on a widget class. The parser for the +style property is determined by the value type of @pspec. + the #GParamSpec for the property + introspectable="0"> + Installs a style property on a widget class. + the #GParamSpec for the style property - + + the parser for the style property - - - - - - - - - - - + version="2.2" + introspectable="0"> + Returns all style properties of a widget class. + + an newly allocated array of #GParamSpec*. The array must be freed with g_free(). - - + + location to return the number of style properties found + + Tells about certain properties of the widget. - + + + - + - + - + + Creates a new #GtkWindow, which is a toplevel window that can contain other widgets. Nearly always, the type of the window should -be #GTK_WINDOW_TOPLEVEL. If you're implementing something like a +be #GTK_WINDOW_TOPLEVEL. If you're implementing something like a popup menu from scratch (which is a bad idea, just use #GtkMenu), you might use #GTK_WINDOW_POPUP. #GTK_WINDOW_POPUP is not for -dialogs, though in some other toolkits dialogs are called "popups". +dialogs, though in some other toolkits dialogs are called "popups". In GTK+, #GTK_WINDOW_POPUP means a pop-up menu or pop-up tooltip. On X11, popup windows are not controlled by the <link -linkend="gtk-X11-arch">window manager</link>. +linkend="gtk-X11-arch">window manager</link>. If you simply want an undecorated window (no window borders), use -gtk_window_set_decorated(), don't use #GTK_WINDOW_POPUP."> - - +gtk_window_set_decorated(), don't use #GTK_WINDOW_POPUP. + + a new #GtkWindow. + + type of window - - - - - - - - - - + Gets the value set by gtk_window_set_default_icon_list(). The list is a copy and should be freed with g_list_free(), but the pixbufs in the list have not had their reference count -incremented."> - - +incremented. + + copy of default icon list + + + - - - - - - - - - - - - - - - - - - - - + Returns the fallback icon name for windows that has been set with gtk_window_set_default_icon_name(). The returned string is owned by GTK+ and should not be modified. It is only valid until the next call to -gtk_window_set_default_icon_name()." - version="2.16"> +gtk_window_set_default_icon_name(). + the fallback icon name for windows - - - + + Returns a list of all existing toplevel windows. The widgets +in the list are not individually referenced. If you want +to iterate through the list and perform actions involving +callbacks that might destroy the widgets, you <emphasis>must</emphasis> call +<literal>g_list_foreach (result, (GFunc)g_object_ref, NULL)</literal> first, and +then unref all the widgets afterwards. + + list of toplevel widgets + + + - - - - - + By default, after showing the first #GtkWindow, GTK+ calls +gdk_notify_startup_complete(). Call this function to disable +the automatic startup notification. You might do this if your +first window is a splash screen, and you want to delay notification until after your real main window has been shown, for example. In that example, you would disable startup notification temporarily, show your splash screen, then re-enable it so that -showing the main window would automatically result in notification." - version="2.2"> +showing the main window would automatically result in notification. - + %TRUE to automatically do startup notification + - - - - - + + Sets an icon to be used as fallback for windows that haven't +had gtk_window_set_icon() called on them from a pixbuf. + + + + + the icon + + + + + + Sets an icon to be used as fallback for windows that haven't +had gtk_window_set_icon_list() called on them from a file +on disk. Warns on failure if @err is %NULL. + + %TRUE if setting the icon succeeded. + + + + + location of icon file + + + + + + Sets an icon list to be used as fallback for windows that haven't +had gtk_window_set_icon_list() called on them to set up a +window-specific icon list. This function allows you to set up the +icon for all windows in your app at once. +See gtk_window_set_icon_list() for more details. + + + + + + a list of #GdkPixbuf + + + + + + + + Sets an icon to be used as fallback for windows that haven't +had gtk_window_set_icon_list() called on them from a named +themed icon, see gtk_window_set_icon_name(). + + + + + + the name of the themed icon + + + @@ -80629,1385 +74554,518 @@ then unref all the widgets afterwards."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Activates the default widget for the window, unless the current +focused widget has been configured to receive the default action (see gtk_widget_set_receives_default()), in which case the -focused widget is activated."> +focused widget is activated. - + %TRUE if a widget got activated. + - + + Activates the current focused widget within the window. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if a widget got activated. + + Activates mnemonics and accelerators for this #GtkWindow. This is normally called by the default ::key_press_event handler for toplevel windows, however in some cases it may be useful to call this directly when -overriding the standard key handling for a toplevel window." - version="2.4"> +overriding the standard key handling for a toplevel window. - + %TRUE if a mnemonic or accelerator was found and activated. + + a #GdkEventKey - + + Associate @accel_group with @window, such that calling +gtk_accel_groups_activate() on @window will activate accelerators +in @accel_group. - + - - + + a #GtkAccelGroup + - - - - - - + + + + + + + + Adds a mnemonic to this window. + + + + + + the mnemonic + + + + the widget that gets activated by the mnemonic + + + + + + Starts moving a window. This function is used if an application has +window movement grips. When GDK can support it, the window movement +will be done using the standard mechanism for the <link +linkend="gtk-X11-arch">window manager</link> or windowing +system. Otherwise, GDK will try to emulate window movement, +potentially not all that well, depending on the windowing system. + + + + + + mouse button that initiated the drag + + + + X position where the user clicked to initiate the drag, in root window coordinates + + + + Y position where the user clicked to initiate the drag + + - + timestamp from the click event that initiated the drag + - + + Starts resizing a window. This function is used if an application +has window resizing controls. When GDK can support it, the resize +will be done using the standard mechanism for the <link +linkend="gtk-X11-arch">window manager</link> or windowing +system. Otherwise, GDK will try to emulate window resizing, +potentially not all that well, depending on the windowing system. + + + position of the resize control + + + + mouse button that initiated the drag + + + + X position where the user clicked to initiate the drag, in root window coordinates + + + + Y position where the user clicked to initiate the drag + + + + timestamp from the click event that initiated the drag + + + - + Asks to deiconify (i.e. unminimize) the specified @window. Note +that you shouldn't assume the window is definitely deiconified afterward, because other entities (e.g. the user or <link -linkend="gtk-X11-arch">window manager</link>) could iconify it +linkend="gtk-X11-arch">window manager</link>) could iconify it again before your code which assumes deiconification gets to run. -You can track iconification via the "window-state-event" signal -on #GtkWidget."> - - - - - - - - - - - - - - - - - - - - +You can track iconification via the "window-state-event" signal +on #GtkWidget. + Asks to place @window in the fullscreen state. Note that you +shouldn't assume the window is definitely full screen afterward, because other entities (e.g. the user or <link -linkend="gtk-X11-arch">window manager</link>) could unfullscreen it +linkend="gtk-X11-arch">window manager</link>) could unfullscreen it again, and not all window managers honor requests to fullscreen windows. But normally the window will end up fullscreen. Just -don't write code that crashes if not. -You can track the fullscreen state via the "window-state-event" signal -on #GtkWidget." - version="2.2"> +don't write code that crashes if not. +You can track the fullscreen state via the "window-state-event" signal +on #GtkWidget. - - - - - - + Gets the value set by gtk_window_set_accept_focus(). - + %TRUE if window should receive the input focus + - - - - - - + + Returns whether the window has been set to have decorations +such as a title bar via gtk_window_set_decorated(). - + %TRUE if the window has been set to have decorations + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the default size of the window. A value of -1 for the width or height indicates that a default size has not been explicitly set -for that dimension, so the "natural" size of the window will be -used."> +for that dimension, so the "natural" size of the window will be +used. - + allow-none="1"> + location to store the default width, or %NULL + - + allow-none="1"> + location to store the default height, or %NULL + - + + Returns the default widget for @window. See gtk_window_set_default() +for more details. + + the default widget, or %NULL if there is none. + + + + + Returns whether the window has been set to have a close button +via gtk_window_set_deletable(). + + %TRUE if the window has been set to have a close button + + + + + Returns whether the window will be destroyed with its transient parent. See +gtk_window_set_destroy_with_parent (). + + %TRUE if the window will be destroyed with its transient parent. + + + + + Retrieves the current focused widget within the window. +Note that this is the widget that would have the focus +if the toplevel window focused; if the toplevel window +is not focused then <literal>gtk_widget_has_focus (widget)</literal> will +not be %TRUE for the widget. + + the currently focused widget, or %NULL if there is none. + + + + + Gets the value set by gtk_window_set_focus_on_map(). +mapped. + + %TRUE if window should receive the input focus when + + + + + (Note: this is a special-purpose function intended for the +framebuffer port; see gtk_window_set_has_frame(). It will not +return the size of the window border drawn by the <link +linkend="gtk-X11-arch">window manager</link>, which is the normal +case when using a windowing system. See +gdk_window_get_frame_extents() to get the standard window border +extents.) +Retrieves the dimensions of the frame window for this toplevel. +See gtk_window_set_has_frame(), gtk_window_set_frame_dimensions(). - - + + location to store the width of the frame at the left, or %NULL + - - + + location to store the height of the frame at the top, or %NULL + + + + location to store the width of the frame at the returns, or %NULL + + + + location to store the height of the frame at the bottom, or %NULL + - + Gets the value set by gtk_window_set_gravity(). + + window gravity + + + + + Returns the group for @window or the default group, if +window group. + + the #GtkWindowGroup for a window or the default group + + + + + Accessor for whether the window has a frame window exterior to +via gtk_window_set_has_frame(). + + %TRUE if a frame has been added to the window + + + + + Gets the value set by gtk_window_set_icon() (or if you've +called gtk_window_set_icon_list(), gets the first icon in +the icon list). + + icon for window + + + + + Retrieves the list of icons set by gtk_window_set_icon_list(). +The list is copied, but the reference count on each +member won't be incremented. + + copy of window's icon list + + + + + + + Returns the name of the themed icon for the window, +see gtk_window_set_icon_name(). +no themed icon + + the icon name or %NULL if the window has + + + + + Returns the mnemonic modifier for this window. See +gtk_window_set_mnemonic_modifier(). +mnemonics on this window. + + the modifier mask used to activate + + + + + Gets the value of the #GtkWindow:mnemonics-visible property. +in this window. + + %TRUE if mnemonics are supposed to be visible + + + + + Returns whether the window is modal. See gtk_window_set_modal(). +establishes a grab when shown + + %TRUE if the window is set to be modal and + + + + + Fetches the requested opacity for this window. See +gtk_window_set_opacity(). + + the requested opacity for this window. + + + + + This function returns the position you need to pass to +gtk_window_move() to keep @window in its current position. This +means that the meaning of the returned value varies with window +gravity. See gtk_window_move() for more details. +If you haven't changed the window gravity, its gravity will be +#GDK_GRAVITY_NORTH_WEST. This means that gtk_window_get_position() +gets the position of the top-left corner of the window manager +frame for the window. gtk_window_move() sets the position of this +same top-left corner. +gtk_window_get_position() is not 100% reliable because the X Window System +does not specify a way to obtain the geometry of the +decorations placed on a window by the window manager. +Thus GTK+ is using a "best guess" that works with most +window managers. +Moreover, nearly all window managers are historically broken with +respect to their handling of window gravity. So moving a window to +its current position as returned by gtk_window_get_position() tends +to result in moving the window slightly. Window managers are +slowly getting better over time. +If a window has gravity #GDK_GRAVITY_STATIC the window manager +frame is not relevant, and thus gtk_window_get_position() will +always produce accurate results. However you can't use static +gravity to do things like place a window in a corner of the screen, +because static gravity ignores the window manager decorations. +If you are saving and restoring your application's window +positions, you should know that it's impossible for applications to +do this without getting it somewhat wrong because applications do +not have sufficient knowledge of window manager state. The Correct +Mechanism is to support the session management protocol (see the +"GnomeClient" object in the GNOME libraries for example) and allow +the window manager to save your window sizes and positions. + + + + + + return location for X coordinate of gravity-determined reference point + + + + return location for Y coordinate of gravity-determined reference point + + + + + + Gets the value set by gtk_window_set_resizable(). + + %TRUE if the user can resize the window + + + + + Returns the role of the window. See gtk_window_set_role() for +further explanation. +returned is owned by the widget and must not be modified +or freed. + + the role of the window if set, or %NULL. The + + + + + Returns the #GdkScreen associated with @window. + + a #GdkScreen. + + + + + Obtains the current size of @window. If @window is not onscreen, it returns the size GTK+ will suggest to the <link -linkend="gtk-X11-arch">window manager</link> for the initial window +linkend="gtk-X11-arch">window manager</link> for the initial window size (but this is not reliably the same as the size the window manager will actually select). The size obtained by gtk_window_get_size() is the last size received in a #GdkEventConfigure, that is, GTK+ uses its locally-stored size, rather than querying the X server for the size. As a result, if you call gtk_window_resize() then immediately call -gtk_window_get_size(), the size won't have taken effect yet. After +gtk_window_get_size(), the size won't have taken effect yet. After the window manager processes the resize request, GTK+ receives notification that the size has changed via a configure event, and the size of the window gets updated. because the size of the window may change between the time that you get the size and the time that you perform some action assuming that size is the current size. To avoid race conditions, connect to -"configure-event" on the window and adjust your size-dependent +"configure-event" on the window and adjust your size-dependent state to match the size delivered in the #GdkEventConfigure. size of the window manager decorations (aka the window frame or border). Those are not drawn by GTK+ and GTK+ has no reliable method of determining their size. the window onscreen, there may be a better way. The preferred -way is to simply set the window's semantic type with +way is to simply set the window's semantic type with gtk_window_set_type_hint(), which allows the window manager to e.g. center dialogs. Also, if you set the transient parent of dialogs with gtk_window_set_transient_for() window managers -will often center the dialog over its parent window. It's +will often center the dialog over its parent window. It's much preferred to let the window manager handle these things rather than doing it yourself, because all apps will behave consistently and according to user prefs if the window @@ -82015,32 +75073,181 @@ manager handles it. Also, the window manager can take the size of the window decorations/border into account, while your application cannot. In any case, if you insist on application-specified window -positioning, there's <emphasis>still</emphasis> a better way than +positioning, there's <emphasis>still</emphasis> a better way than doing it yourself - gtk_window_set_position() will frequently -handle the details for you."> +handle the details for you. - + allow-none="1"> + return location for width, or %NULL + - + allow-none="1"> + return location for height, or %NULL + - + Gets the value set by gtk_window_set_skip_pager_hint(). + + %TRUE if window shouldn't be in pager + + + + + Gets the value set by gtk_window_set_skip_taskbar_hint() + + %TRUE if window shouldn't be in taskbar + + + + + Retrieves the title of the window. See gtk_window_set_title(). +been set explicitely. The returned string is owned by the widget +and must not be modified or freed. + + the title of the window, or %NULL if none has + + + + + Fetches the transient parent for this window. See +gtk_window_set_transient_for(). +if no transient parent has been set. + + the transient parent for this window, or %NULL + + + + + Gets the type hint for this window. See gtk_window_set_type_hint(). + + the type hint for @window. + + + + + Gets the value set by gtk_window_set_urgency_hint() + + %TRUE if window is urgent + + + + + Gets the type of the window. See #GtkWindowType. + + the type of the window + + + + + Returns whether @window has an explicit window group. +Since 2.22 + + %TRUE if @window has an explicit window group. + + + + + Returns whether the input focus is within this GtkWindow. +For real toplevel windows, this is identical to gtk_window_is_active(), +but for embedded windows, like #GtkPlug, the results will differ. + + %TRUE if the input focus is within this GtkWindow + + + + + Asks to iconify (i.e. minimize) the specified @window. Note that +you shouldn't assume the window is definitely iconified afterward, +because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could deiconify it +again, or there may not be a window manager in which case +iconification isn't possible, etc. But normally the window will end +up iconified. Just don't write code that crashes if not. +It's permitted to call this function before showing a window, +in which case the window will be iconified before it ever appears +onscreen. +You can track iconification via the "window-state-event" signal +on #GtkWidget. + + + + + + Returns whether the window is part of the current active toplevel. +(That is, the toplevel window receiving keystrokes.) +The return value is %TRUE if the window is active toplevel +itself, but also if it is, say, a #GtkPlug embedded in the active toplevel. +You might use this function if you wanted to draw a widget +differently in an active window from a widget in an inactive window. +See gtk_window_has_toplevel_focus() + + %TRUE if the window part of the current active window. + + + + + Asks to maximize @window, so that it becomes full-screen. Note that +you shouldn't assume the window is definitely maximized afterward, +because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could unmaximize it +again, and not all window managers support maximization. But +normally the window will end up maximized. Just don't write code +that crashes if not. +It's permitted to call this function before showing a window, +in which case the window will be maximized when it appears onscreen +initially. +You can track maximization via the "window-state-event" signal +on #GtkWidget. + + + + + + Activates the targets associated with the mnemonic. + + %TRUE if the activation is done. + + + + + the mnemonic + + + + the modifiers + + + + + + Asks the <link linkend="gtk-X11-arch">window manager</link> to move this; most window managers ignore requests for initial window positions (instead using a user-defined placement algorithm) and honor requests after the window has already been shown. @@ -82063,72 +75270,28 @@ you would first set gravity to south east, then write: <literal>gtk_window_move (window, gdk_screen_width () - window_width, gdk_screen_height () - window_height)</literal> (note that this example does not take multi-head scenarios into account). -The Extended Window Manager Hints specification at <ulink -url="http://www.freedesktop.org/Standards/wm-spec"> -http://www.freedesktop.org/Standards/wm-spec</ulink> has a -nice table of gravities in the "implementation notes" section. -The gtk_window_get_position() documentation may also be relevant."> +The Extended Window Manager Hints specification at <ulink +url="http://www.freedesktop.org/Standards/wm-spec"> +http://www.freedesktop.org/Standards/wm-spec</ulink> has a +nice table of gravities in the "implementation notes" section. +The gtk_window_get_position() documentation may also be relevant. - + X coordinate to move window to + - + Y coordinate to move window to + - - - - - - - - - - - - - - + Parses a standard X Window System geometry string - see the +manual page for X (type 'man X') for details on this. gtk_window_parse_geometry() does work on all GTK+ ports including Win32 but is primarily intended for an X environment. If either a size or a position can be extracted from the @@ -82141,7 +75304,7 @@ indicating to the window manager that the size/position of the window was user-specified. This causes most window managers to honor the geometry. Note that for gtk_window_parse_geometry() to work as expected, it has -to be called when the window has its "final" size, i.e. after calling +to be called when the window has its "final" size, i.e. after calling gtk_widget_show_all() on the contents and gtk_window_set_geometry_hints() on the window. |[ @@ -82156,7 +75319,7 @@ main (int argc, char *argv[]) { GtkWidget *window, *vbox; GdkGeometry size_hints = { -100, 50, 0, 0, 100, 50, 10, 10, 0.0, 0.0, GDK_GRAVITY_NORTH_WEST +100, 50, 0, 0, 100, 50, 10, 10, 0.0, 0.0, GDK_GRAVITY_NORTH_WEST }; gtk_init (&argc, &argv); window = gtk_window_new (GTK_WINDOW_TOPLEVEL); @@ -82167,54 +75330,96 @@ gtk_widget_show_all (vbox); gtk_window_set_geometry_hints (GTK_WINDOW (window), window, &size_hints, -GDK_HINT_MIN_SIZE | -GDK_HINT_BASE_SIZE | +GDK_HINT_MIN_SIZE | +GDK_HINT_BASE_SIZE | GDK_HINT_RESIZE_INC); if (argc &gt; 1) { if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1])) -fprintf (stderr, "Failed to parse '%s'\n", argv[1]); +fprintf (stderr, "Failed to parse '%s'\n", argv[1]); } gtk_widget_show_all (window); gtk_main (); return 0; } -]|"> +]| - + %TRUE if string was parsed successfully + + geometry string - - - - - - + + Presents a window to the user. This may mean raising the window +in the stacking order, deiconifying it, moving it to the current +desktop, and/or giving it the keyboard focus, possibly dependent +on the user's platform, window manager, and preferences. +If @window is hidden, this function calls gtk_widget_show() +as well. +This function should be used when the user tries to open a window +that's already open. Say for example the preferences dialog is +currently open, and the user chooses Preferences from the menu +a second time; use gtk_window_present() to move the already-open dialog +where the user can see it. +If you are calling this function in response to a user interaction, +it is preferable to use gtk_window_present_with_time(). - - - + + Presents a window to the user in response to a user interaction. +If you need to present a window without a timestamp, use +gtk_window_present(). See gtk_window_present() for details. + + + + + the timestamp of the user interaction (typically a button or key press event) which triggered this call + + + + + + Propagate a key press or release event to the focus widget and +up the focus container chain until a widget handles @event. +This is normally called by the default ::key_press_event and +::key_release_event handlers for toplevel windows, +however in some cases it may be useful to call this directly when +overriding the standard key handling for a toplevel window. + + %TRUE if a widget in the focus chain handled the event. + + + + + a #GdkEventKey + + + + + + Reverses the effects of gtk_window_add_accel_group(). + + + + + + a #GtkAccelGroup + + + @@ -82227,298 +75432,978 @@ by GUI builders only."> - + + Removes a mnemonic from this window. - - + + the mnemonic + + + + the widget that gets activated by the mnemonic + + + Hides @window, then reshows it, resetting the +default size and position of the window. Used +by GUI builders only. + + + + + + Resizes the window as if the user had done so, obeying geometry +constraints. The default geometry constraint is that windows may +not be smaller than their size request; to override this +constraint, call gtk_widget_set_size_request() to set the window's +request to a smaller value. +If gtk_window_resize() is called before showing a window for the +first time, it overrides any default size set with +gtk_window_set_default_size(). +Windows may not be resized smaller than 1 by 1 pixels. + + + + + + width in pixels to resize the window to + + + + height in pixels to resize the window to + + + + + + Windows may set a hint asking the desktop environment not to receive +the input focus. This function sets this hint. + + + + + + %TRUE to let this window receive input focus + + + + + + By default, windows are decorated with a title bar, resize +controls, etc. Some <link linkend="gtk-X11-arch">window +managers</link> allow GTK+ to disable these decorations, creating a +borderless window. If you set the decorated property to %FALSE +using this function, GTK+ will do its best to convince the window +manager not to decorate the window. Depending on the system, this +function may not have any effect when called on a window that is +already visible, so you should call it before calling gtk_window_show(). +On Windows, this function always works, since there's no window manager +policy involved. + + + + + + %TRUE to decorate the window + + + + + + The default widget is the widget that's activated when the user +presses Enter in a dialog (for example). This function sets or +unsets the default widget for a #GtkWindow about. When setting +(rather than unsetting) the default widget it's generally easier to +call gtk_widget_grab_focus() on the widget. Before making a widget +the default widget, you must set the #GTK_CAN_DEFAULT flag on the +widget you'd like to make the default using GTK_WIDGET_SET_FLAGS(). + + + + + + widget to be the default, or %NULL to unset the default widget for the toplevel. + + + + + + Sets the default size of a window. If the window's "natural" size +(its size request) is larger than the default, the default will be +ignored. More generally, if the default size does not obey the +geometry hints for the window (gtk_window_set_geometry_hints() can +be used to set these explicitly), the default size will be clamped +to the nearest permitted size. +Unlike gtk_widget_set_size_request(), which sets a size request for +a widget and thus would keep users from shrinking the window, this +function only sets the initial size, just as if the user had +resized the window themselves. Users can still shrink the window +again as they normally would. Setting a default size of -1 means to +use the "natural" default size (the size request of the window). +For more control over a window's initial size and how resizing works, +investigate gtk_window_set_geometry_hints(). +For some uses, gtk_window_resize() is a more appropriate function. +gtk_window_resize() changes the current size of the window, rather +than the size to be used on initial display. gtk_window_resize() always +affects the window itself, not the geometry widget. +The default size of a window only affects the first time a window is +shown; if a window is hidden and re-shown, it will remember the size +it had prior to hiding, rather than using the default size. +Windows can't actually be 0x0 in size, they must be at least 1x1, but +passing 0 for @width and @height is OK, resulting in a 1x1 default size. + + + + + + width in pixels, or -1 to unset the default width + + + + height in pixels, or -1 to unset the default height + + + + + + By default, windows have a close button in the window frame. Some +<link linkend="gtk-X11-arch">window managers</link> allow GTK+ to +disable this button. If you set the deletable property to %FALSE +using this function, GTK+ will do its best to convince the window +manager not to show a close button. Depending on the system, this +function may not have any effect when called on a window that is +already visible, so you should call it before calling gtk_window_show(). +On Windows, this function always works, since there's no window manager +policy involved. + + + + + + %TRUE to decorate the window as deletable + + + + + + If @setting is %TRUE, then destroying the transient parent of @window +will also destroy @window itself. This is useful for dialogs that +shouldn't persist beyond the lifetime of the main window they're +associated with, for example. + + + + + + whether to destroy @window with its transient parent + + + + + + If @focus is not the current focus widget, and is focusable, sets +it as the focus widget for the window. If @focus is %NULL, unsets +the focus widget for this window. To set the focus to a particular +widget in the toplevel, it is usually more convenient to use +gtk_widget_grab_focus() instead of this function. + + + + + + widget to be the new focus widget, or %NULL to unset any focus widget for the toplevel window. + + + + + + Windows may set a hint asking the desktop environment not to receive +the input focus when the window is mapped. This function sets this +hint. + + + + + + %TRUE to let this window receive input focus on map + + + + + + (Note: this is a special-purpose function intended for the framebuffer +port; see gtk_window_set_has_frame(). It will have no effect on the +window border drawn by the window manager, which is the normal +case when using the X Window system.) +For windows with frames (see gtk_window_set_has_frame()) this function +can be used to change the size of the frame border. + + + + + + The width of the left border + + + + The height of the top border + + + + The width of the right border + + + + The height of the bottom border + + + + + + This function sets up hints about how a window can be resized by +the user. You can set a minimum and maximum size; allowed resize +increments (e.g. for xterm, you can only resize by the size of a +character); aspect ratios; and more. See the #GdkGeometry struct. + + + + + + widget the geometry hints will be applied to or %NULL + + + + struct containing geometry information or %NULL + + + + mask indicating which struct fields should be paid attention to + + + + + + Window gravity defines the meaning of coordinates passed to +gtk_window_move(). See gtk_window_move() and #GdkGravity for +more details. +The default window gravity is #GDK_GRAVITY_NORTH_WEST which will +typically "do what you mean." + + + + + + window gravity + + + + + + (Note: this is a special-purpose function for the framebuffer port, +that causes GTK+ to draw its own window border. For most applications, +you want gtk_window_set_decorated() instead, which tells the window +manager whether to draw the window border.) +If this function is called on a window with setting of %TRUE, before +it is realized or showed, it will have a "frame" window around +frame_event you can receive all events targeted at the frame. +This function is used by the linux-fb port to implement managed +windows, but it could conceivably be used by X-programs that +want to do their own window decorations. + + + + + + a boolean + + + + + + Sets up the icon representing a #GtkWindow. This icon is used when +the window is minimized (also known as iconified). Some window +managers or desktop environments may also place it in the window +frame, or display it in other contexts. +The icon should be provided in whatever size it was naturally +drawn; that is, don't scale the image before passing it to +GTK+. Scaling is postponed until the last minute, when the desired +final size is known, to allow best quality. +If you have your icon hand-drawn in multiple sizes, use +gtk_window_set_icon_list(). Then the best size will be used. +This function is equivalent to calling gtk_window_set_icon_list() +with a 1-element list. +See also gtk_window_set_default_icon_list() to set the icon +for all windows in your application in one go. + + + + + + icon image, or %NULL + + + + + + Sets the icon for @window. +Warns on failure if @err is %NULL. +This function is equivalent to calling gtk_window_set_icon() +with a pixbuf created by loading the image from @filename. + + %TRUE if setting the icon succeeded. + + + + + location of icon file + + + + + + Sets up the icon representing a #GtkWindow. The icon is used when +the window is minimized (also known as iconified). Some window +managers or desktop environments may also place it in the window +frame, or display it in other contexts. +gtk_window_set_icon_list() allows you to pass in the same icon in +several hand-drawn sizes. The list should contain the natural sizes +your icon is available in; that is, don't scale the image before +passing it to GTK+. Scaling is postponed until the last minute, +when the desired final size is known, to allow best quality. +By passing several sizes, you may improve the final image quality +of the icon, by reducing or eliminating automatic image scaling. +larger images (64x64, 128x128) if you have them. +See also gtk_window_set_default_icon_list() to set the icon +for all windows in your application in one go. +Note that transient windows (those who have been set transient for another +window using gtk_window_set_transient_for()) will inherit their +icon from their transient parent. So there's no need to explicitly +set the icon on transient windows. + + + + + + list of #GdkPixbuf + + + + + + + + Sets the icon for the window from a named themed icon. See +the docs for #GtkIconTheme for more details. +Note that this has nothing to do with the WM_ICON_NAME +property which is mentioned in the ICCCM. + + + + + + the name of the themed icon + + + + + + Asks to keep @window above, so that it stays on top. Note that +you shouldn't assume the window is definitely above afterward, +because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could not keep it above, +and not all window managers support keeping windows above. But +normally the window will end kept above. Just don't write code +that crashes if not. +It's permitted to call this function before showing a window, +in which case the window will be kept above when it appears onscreen +initially. +You can track the above state via the "window-state-event" signal +on #GtkWidget. +Note that, according to the <ulink +url="http://www.freedesktop.org/Standards/wm-spec">Extended Window +Manager Hints</ulink> specification, the above state is mainly meant +for user preferences and should not be used by applications e.g. for +drawing attention to their dialogs. + + + + + + whether to keep @window above other windows + + + + + + Asks to keep @window below, so that it stays in bottom. Note that +you shouldn't assume the window is definitely below afterward, +because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could not keep it below, +and not all window managers support putting windows below. But +normally the window will be kept below. Just don't write code +that crashes if not. +It's permitted to call this function before showing a window, +in which case the window will be kept below when it appears onscreen +initially. +You can track the below state via the "window-state-event" signal +on #GtkWidget. +Note that, according to the <ulink +url="http://www.freedesktop.org/Standards/wm-spec">Extended Window +Manager Hints</ulink> specification, the above state is mainly meant +for user preferences and should not be used by applications e.g. for +drawing attention to their dialogs. + + + + + + whether to keep @window below other windows + + + + + + Sets the mnemonic modifier for this window. + + + + + + the modifier mask used to activate mnemonics on this window. + + + + + + Sets the #GtkWindow:mnemonics-visible property. + + + + + + the new value + + + + + + Sets a window modal or non-modal. Modal windows prevent interaction +with other windows in the same application. To keep modal dialogs +on top of main application windows, use +gtk_window_set_transient_for() to make the dialog transient for the +parent; most <link linkend="gtk-X11-arch">window managers</link> +will then disallow lowering the dialog below the parent. + + + + + + whether the window is modal + + + + + + Request the windowing system to make @window partially transparent, +with opacity 0 being fully transparent and 1 fully opaque. (Values +of the opacity parameter are clamped to the [0,1] range.) On X11 +this has any effect only on X screens with a compositing manager +running. See gtk_widget_is_composited(). On Windows it should work +always. +Note that setting a window's opacity after the window has been +shown causes it to flicker once on Windows. + + + + + + desired opacity, between 0 and 1 + + + + + + Sets a position constraint for this window. If the old or new +constraint is %GTK_WIN_POS_CENTER_ALWAYS, this will also cause +the window to be repositioned to satisfy the new constraint. + + + + + + a position constraint. + + + + + + Sets whether the user can resize a window. Windows are user resizable +by default. + + + + + + %TRUE if the user can resize this window + + + + + + This function is only useful on X11, not with other GTK+ targets. +In combination with the window title, the window role allows a +<link linkend="gtk-X11-arch">window manager</link> to identify "the +same" window when an application is restarted. So for example you +might set the "toolbox" role on your app's toolbox window, so that +when the user restarts their session, the window manager can put +the toolbox back in the same place. +If a window already has a unique title, you don't need to set the +role, since the WM can use the title to identify the window when +restoring the session. + + + + + + unique identifier for the window to be used when restoring a session + + + + + + + + + + + + + + + + Windows may set a hint asking the desktop environment not to display +the window in the pager. This function sets this hint. +(A "pager" is any desktop navigation tool such as a workspace +switcher that displays a thumbnail representation of the windows +on the screen.) + + + + + + %TRUE to keep this window from appearing in the pager + + + + + + Windows may set a hint asking the desktop environment not to display +the window in the task bar. This function sets this hint. + + + + + + %TRUE to keep this window from appearing in the task bar + + + + + + Startup notification identifiers are used by desktop environment to +track application startup, to provide user feedback and other +features. This function changes the corresponding property on the +underlying GdkWindow. Normally, startup identifier is managed +automatically and you should only use this function in special cases +like transferring focus from other processes. You should use this +function before calling gtk_window_present() or any equivalent +function generating a window map event. +This function is only useful on X11, not with other GTK+ targets. + + + + + + a string with startup-notification identifier + + + + + + Sets the title of the #GtkWindow. The title of a window will be +displayed in its title bar; on the X Window System, the title bar +is rendered by the <link linkend="gtk-X11-arch">window +manager</link>, so exactly how the title appears to users may vary +according to a user's exact configuration. The title should help a +user distinguish this window from other windows they may have +open. A good title might include the application name and current +document filename, for example. + + + + + + title of the window + + + + + + Dialog windows should be set transient for the main application +window they were spawned from. This allows <link +linkend="gtk-X11-arch">window managers</link> to e.g. keep the +dialog on top of the main window, or center the dialog over the +main window. gtk_dialog_new_with_buttons() and other convenience +functions in GTK+ will sometimes call +gtk_window_set_transient_for() on your behalf. +Passing %NULL for @parent unsets the current transient window. +On Windows, this function puts the child window on top of the parent, +much as the window manager would have done on X. + + + + + + parent window, or %NULL + + + + + + By setting the type hint for the window, you allow the window +manager to decorate and handle the window in a way which is +suitable to the function of the window in your application. +This function should be called before the window becomes visible. +gtk_dialog_new_with_buttons() and other convenience functions in GTK+ +will sometimes call gtk_window_set_type_hint() on your behalf. + + + + + + the window type + + + + + + Windows may set a hint asking the desktop environment to draw +the users attention to the window. This function sets this hint. + + + + + + %TRUE to mark this window as urgent + + + + + + Don't use this function. It sets the X Window System "class" and +"name" hints for a window. According to the ICCCM, you should +always set these to the same value for all windows in an +application, and GTK+ sets them to that value by default, so calling +this function is sort of pointless. However, you may want to call +gtk_window_set_role() on each window in your application, for the +benefit of the session manager. Setting the role allows the window +manager to restore window positions when loading a saved session. + + + + + + window name hint + + + + window class hint + + + + + + Asks to stick @window, which means that it will appear on all user +desktops. Note that you shouldn't assume the window is definitely +stuck afterward, because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could unstick it +again, and some window managers do not support sticking +windows. But normally the window will end up stuck. Just don't +write code that crashes if not. +It's permitted to call this function before showing a window. +You can track stickiness via the "window-state-event" signal +on #GtkWidget. + + + + + + Asks to toggle off the fullscreen state for @window. Note that you +shouldn't assume the window is definitely not full screen +afterward, because other entities (e.g. the user or <link +linkend="gtk-X11-arch">window manager</link>) could fullscreen it +again, and not all window managers honor requests to unfullscreen +windows. But normally the window will end up restored to its normal +state. Just don't write code that crashes if not. +You can track the fullscreen state via the "window-state-event" signal +on #GtkWidget. + + + + + + Asks to unmaximize @window. Note that you shouldn't assume the +window is definitely unmaximized afterward, because other entities +(e.g. the user or <link linkend="gtk-X11-arch">window +manager</link>) could maximize it again, and not all window +managers honor requests to unmaximize. But normally the window will +end up unmaximized. Just don't write code that crashes if not. +You can track maximization via the "window-state-event" signal +on #GtkWidget. + + + + + + Asks to unstick @window, which means that it will appear on only +one of the user's desktops. Note that you shouldn't assume the +window is definitely unstuck afterward, because other entities +(e.g. the user or <link linkend="gtk-X11-arch">window +manager</link>) could stick it again. But normally the window will +end up stuck. Just don't write code that crashes if not. +You can track stickiness via the "window-state-event" signal +on #GtkWidget. + + + + - - - - - - - + transfer-ownership="none"> + Whether the window should receive the input focus. + - + transfer-ownership="none"> + Whether the window should be decorated by the window manager. + - - + + - - + + - + transfer-ownership="none"> + Whether the window frame should have a close button. + - - + + - + transfer-ownership="none"> + Whether the window should receive the input focus when mapped. + - + transfer-ownership="none"> + The window gravity of the window. See gtk_window_move() and #GdkGravity for +more details about window gravity. + - - + + - - + + - + transfer-ownership="none"> + The :icon-name property specifies the name of the themed icon to +use as the window icon. See #GtkIconTheme for more details. + - - + + - - + + - - + + - + transfer-ownership="none"> + The requested opacity of the window. See gtk_window_set_opacity() for +more details about window opacity. + - - + + - - + + - - + + - - + + - - + + + The :startup-id is a write-only property for setting window's startup notification identifier. See gtk_window_set_startup_id() -for more details."> - +for more details. + - - + + - + transfer-ownership="none"> + The transient parent of the window. See gtk_window_set_transient_for() for +more details about transient windows. + - - + + - - + + - - + + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The ::activate-default signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user activates the default widget -of @window."> - - +of @window. + + - + The ::activate-focus signal is a +<link linkend="keybinding-signals">keybinding signal</link> which gets emitted when the user activates the currently -focused widget of @window."> - - +focused widget of @window. + + - - + + - + - - - + + The ::keys-changed signal gets emitted when the set of accelerators +or mnemonics that are associated with @window changes. + + - - + + - + @@ -82530,7 +76415,7 @@ or mnemonics that are associated with @window changes."> - + @@ -82545,9 +76430,9 @@ or mnemonics that are associated with @window changes."> - + - + @@ -82560,7 +76445,7 @@ or mnemonics that are associated with @window changes."> - + @@ -82572,7 +76457,7 @@ or mnemonics that are associated with @window changes."> - + @@ -82584,7 +76469,7 @@ or mnemonics that are associated with @window changes."> - + @@ -82599,7 +76484,7 @@ or mnemonics that are associated with @window changes."> - + @@ -82610,92 +76495,125 @@ or mnemonics that are associated with @window changes."> - - + + - - + + - - + + - - + + - + - + + Creates a new #GtkWindowGroup object. Grabs added with +gtk_grab_add() only affect windows within the same #GtkWindowGroup. + a new #GtkWindowGroup. - + + Adds a window to a #GtkWindowGroup. + the #GtkWindow to add - - - + + Returns the current grab widget for @device, or %NULL if none. + + The grab widget, or %NULL + - - + + a #GdkDevice + + + Gets the current grab widget of the given group, +see gtk_grab_add(). + + the current grab widget of the group + + + - + Returns a list of the #GtkWindows that belong to @window_group. +windows inside the group. + + A newly-allocated list of + + Removes a window from a #GtkWindowGroup. + + + + + + the #GtkWindow to remove + + + + - + + + - - + + - - + + - - + + - - + + @@ -82742,16 +76660,16 @@ windows inside the group." - + - + - + @@ -82780,6 +76698,8 @@ windows inside the group." c:identifier="GTK_WIN_POS_CENTER_ON_PARENT" glib:nick="center-on-parent"/> + + + + Describes how an #GtkWrapBox positions its children. + + + + + + + + + + + Creates an #GtkWrapBox. + + A new #GtkWrapBox container + + + + + The #GtkWrapAllocationMode to use + + + + The horizontal #GtkWrapBoxSpreading policy to use + + + + The vertical #GtkWrapBoxSpreading policy to use + + + + The horizontal spacing to add between children + + + + The vertical spacing to add between children + + + + + + Gets the allocation mode. + + The #GtkWrapAllocationMode for @box. + + + + + Gets the horizontal spacing. + + The horizontal spacing. + + + + + Gets the horizontal spreading mode. + + The horizontal #GtkWrapBoxSpreading for @box. + + + + + Gets the minimum amount of children per line. + + The minimum amount of children per line. + + + + + Gets the natural amount of children per line. + + The natural amount of children per line. + + + + + Gets the vertical spacing. + + The vertical spacing. + + + + + Gets the vertical spreading mode. + + The vertical #GtkWrapBoxSpreading for @box. + + + + + Adds a child to an #GtkWrapBox with its packing options set + + + + + + the child #GtkWidget to add + + + + the position in the child list to insert, specify -1 to append to the list. + + + + The #GtkWrapBoxPacking options to use. + + + + + + Reorders the child @widget in @box's list of children. + + + + + + The child to reorder + + + + The new child position + + + + + + Sets the allocation mode for @box's children. + + + + + + The #GtkWrapAllocationMode to use. + + + + + + Sets the horizontal space to add between children. + + + + + + The spacing to use. + + + + + + Sets the horizontal spreading mode for @box's children. + + + + + + The #GtkWrapBoxSpreading to use. + + + + + + Sets the minimum amount of children to line up +in @box's orientation before wrapping. + + + + + + The minimum amount of children per line. + + + + + + Sets the natural length of items to request and +allocate space for in @box's orientation. +Setting the natural amount of children per line +limits the overall natural size request to be no more +than @n_children items long in the given orientation. + + + + + + The natural amount of children per line. + + + + + + Sets the vertical space to add between children. + + + + + + The spacing to use. + + + + + + Sets the vertical spreading mode for @box's children. + + + + + + The #GtkWrapBoxSpreading to use. + + + + + + The #GtkWrapAllocationMode to use. + + + + The amount of horizontal space between two children. + + + + The #GtkWrapBoxSpreading to used to define what is done with extra +space in a given orientation. + + + + The minimum number of children to allocate consecutively in the given orientation. +<note><para>Setting the minimum children per line ensures +that a reasonably small height will be requested +for the overall minimum width of the box.</para></note> + + + + The maximum amount of children to request space for consecutively in the given orientation. + + + + The amount of vertical space between two children. + + + + The #GtkWrapBoxSpreading to used to define what is done with extra +space in a given orientation. + + + + + + + + + + + + + + + + Specifies how widgets will expand vertically and +horizontally when placed inside a #GtkWrapBox. + + + + + + + Describes how a #GtkWrapBox deals with extra space in a given orientation when allocating children. + + + + + + Finds the first accelerator in any #GtkAccelGroup attached to @object that matches @accel_key and @accel_mods, and -activates that accelerator."> +activates that accelerator. - + %TRUE if an accelerator was activated and handled this keypress + + the #GObject, usually a #GtkWindow, on which to activate the accelerator. - + accelerator keyval from a key event + + keyboard state mask from a key event - + c:identifier="gtk_accel_groups_from_object"> + Gets a list of all accel groups which are attached to @object. + + a list of all accel groups which are attached to @object + a #GObject, usually a #GtkWindow + c:identifier="gtk_accelerator_get_default_mod_mask"> + Gets the value set by gtk_accelerator_set_default_mod_mask(). - + the default accelerator modifier mask + + Converts an accelerator keyval and modifier mask into a string +which can be used to represent the accelerator to the user. + a newly-allocated string representing the accelerator. - + accelerator keyval + + accelerator modifier mask - + Converts an accelerator keyval and modifier mask into a string parseable by gtk_accelerator_parse(). For example, if you pass in #GDK_q and #GDK_CONTROL_MASK, -this function returns "&lt;Control&gt;q". +this function returns "&lt;Control&gt;q". If you need to display accelerators in the user interface, -see gtk_accelerator_get_label()."> +see gtk_accelerator_get_label(). + a newly-allocated accelerator name - + accelerator keyval + + accelerator modifier mask - + Parses a string representing an accelerator. The +format looks like "&lt;Control&gt;a" or "&lt;Shift&gt;&lt;Alt&gt;F1" or +"&lt;Release&gt;z" (the last one is for key release). The parser is fairly liberal and allows lower or upper case, -and also abbreviations such as "&lt;Ctl&gt;" and "&lt;Ctrl&gt;". +and also abbreviations such as "&lt;Ctl&gt;" and "&lt;Ctrl&gt;". +Key names are parsed using gdk_keyval_from_name(). For character keys the +name is not the symbol, but the lowercase name, e.g. one would use +"&lt;Ctrl&gt;minus" instead of "&lt;Ctrl&gt;-". If the parse fails, @accelerator_key and @accelerator_mods will -be set to 0 (zero)."> +be set to 0 (zero). + string representing an accelerator - - + + return location for accelerator keyval + + return location for accelerator modifier mask + Sets the modifiers that will be considered significant for keyboard accelerators. The default mod mask is #GDK_CONTROL_MASK | -#GDK_SHIFT_MASK | #GDK_MOD1_MASK | #GDK_SUPER_MASK | -#GDK_HYPER_MASK | #GDK_META_MASK, that is, Control, Shift, Alt, -Super, Hyper and Meta. Other modifiers will by default be ignored +#GDK_SHIFT_MASK | #GDK_MOD1_MASK | #GDK_SUPER_MASK | +#GDK_HYPER_MASK | #GDK_META_MASK, that is, Control, Shift, Alt, +Super, Hyper and Meta. Other modifiers will by default be ignored by #GtkAccelGroup. You must include at least the three modifiers Control, Shift and Alt in any value you pass to this function. The default mod mask should be changed on application startup, -before using any accelerator groups."> +before using any accelerator groups. + accelerator modifier mask - + Determines whether a given keyval and modifier mask constitute a valid keyboard accelerator. For example, the #GDK_a keyval -plus #GDK_CONTROL_MASK is valid - this is a "Ctrl+a" accelerator. -But, you can't, for instance, use the #GDK_Control_L keyval -as an accelerator."> +plus #GDK_CONTROL_MASK is valid - this is a "Ctrl+a" accelerator. +But, you can't, for instance, use the #GDK_Control_L keyval +as an accelerator. - + %TRUE if the accelerator is valid + - + a GDK keyval + + modifier mask + Returns %TRUE if dialogs are expected to use an alternative button order on the screen @screen. See gtk_dialog_set_alternative_button_order() for more details -about alternative button order. +about alternative button order. If you need to use this function, you should probably connect to the ::notify:gtk-alternative-button-order signal on the -#GtkSettings object associated to @screen, in order to be -notified if the button order setting changes." - version="2.6"> +#GtkSettings object associated to @screen, in order to be +notified if the button order setting changes. - + Whether the alternative button order should be used + - + + a #GdkScreen, or %NULL to use the default screen + Override or install a new key binding for @keyval with @modifiers on emitted on the target widget, with @n_args @Varargs used as -arguments."> +arguments. + a #GtkBindingSet to install an entry for - + key value of binding to install + + key modifier of binding to install + signal to execute upon activation - + number of arguments to @signal_name + @@ -83014,169 +77297,181 @@ arguments."> + c:identifier="gtk_binding_entry_add_signall"> + Override or install a new key binding for @keyval with @modifiers on + a #GtkBindingSet to add a signal to - + key value + + key modifier + signal name to be bound - - - - - - - - - - - - - - - - - + list of #GtkBindingArg signal arguments + + + + c:identifier="gtk_binding_entry_remove"> + Remove a binding previously installed via +gtk_binding_entry_add_signal() on @binding_set. + a #GtkBindingSet to remove an entry of - + key value of binding to remove + + key modifier of binding to remove + Install a binding on @binding_set which causes key lookups +to be aborted, to prevent bindings from lower priority sets +to be activated. + a #GtkBindingSet to skip an entry of - + key value of binding to skip + + key modifier of binding to skip - - - - - - - - - - + This function returns the binding set named after the type name of the passed in class structure. New binding sets are created on -demand by this function."> - +demand by this function. + + the binding set corresponding to @object_class - + a valid #GtkObject class + + Find a binding set by its globally unique name. The @set_name can either be a name used for gtk_binding_set_new() or the type name of -a class used in gtk_binding_set_by_class()."> - +a class used in gtk_binding_set_by_class(). + + %NULL or the specified binding set + unique binding set name - + + GTK+ maintains a global list of binding sets. Each binding set has +a unique name which needs to be specified upon creation. + + new binding set + + + + + unique name of this binding set + + + + + + Find a key binding matching @keyval and @modifiers and activate the +binding on @object. - + %TRUE if a binding was found and activated + + object to activate when binding found - + key value of the binding + + key modifier of the binding + Looks up key bindings for @object to find one matching - + %TRUE if a matching key binding was found + + a #GtkObject (generally must be a widget) + a #GdkEventKey - + + + + + + Checks that the GTK+ library in use is compatible with the given version. Generally you would pass in the constants #GTK_MAJOR_VERSION, #GTK_MINOR_VERSION, #GTK_MICRO_VERSION as the three arguments to this function; that produces @@ -83188,213 +77483,359 @@ the running library must be binary compatible with the version @required_major.required_minor.@required_micro (same major version.) This function is primarily for GTK+ modules; the module -can call this function to check that it wasn't loaded +can call this function to check that it wasn't loaded into an incompatible version of GTK+. However, such a -a check isn't completely reliable, since the module may be +check isn't completely reliable, since the module may be linked against an old version of GTK+ and calling the old version of gtk_check_version(), but still get loaded into an application using a newer version of GTK+. given version, or a string describing the version mismatch. The returned string is owned by GTK+ and should not be modified -or freed."> +or freed. + %NULL if the GTK+ library is compatible with the - + the required major version. + - + the required minor version. + - + the required micro version. + - + Finds a child property of a container class by name. + + the #GParamSpec of the child property or %NULL if @class has no child property with that name. + + + + + a #GtkContainerClass + + + + the name of the child property to find + + + + + + Returns all child properties of a container class. + + a newly allocated %NULL-terminated array of #GParamSpec*. The array must be freed with g_free(). + + + + + a #GtkContainerClass + + + + location to return the number of child properties found + + + + + + Adds a GTK+ grab on @device, so all the events on @device and its +associated pointer or keyboard (if any) are delivered to @widget. +If the @block_others parameter is %TRUE, any other devices will be +unable to interact with @widget during the grab. + + + + + + a #GtkWidget + + + + a #GtkDevice to grab on. + + + + %TRUE to prevent other devices to interact with @widget. + + + + + + Removes a device grab from the given widget. You have to pair calls +to gtk_device_grab_add() and gtk_device_grab_remove(). + + + + + + a #GtkWidget + + + + a #GdkDevice + + + + + + Prevents gtk_init(), gtk_init_check(), gtk_init_with_args() and gtk_parse_args() from automatically -calling <literal>setlocale (LC_ALL, "")</literal>. You would -want to use this function if you wanted to set the locale for -your program to something other than the user's locale, or if +calling <literal>setlocale (LC_ALL, "")</literal>. You would +want to use this function if you wanted to set the locale for +your program to something other than the user's locale, or if you wanted to set different values for different locale categories. -Most programs should not need to call this function."> +Most programs should not need to call this function. + + Distributes @extra_space to child @sizes by bringing up smaller +children up to natural size first. +The remaining space will be added to the @minimum_size member of the +GtkRequestedSize struct. If all sizes reach their natural size then +the remaining space is returned. +to @sizes. + + The remainder of @extra_space after redistributing space + + + + + Extra space to redistribute among children after subtracting minimum sizes and any child padding from the overall allocation + + + + Number of requests to fit into the allocation + + + + An array of structs with a client pointer and a minimum/natural size in the orientation of the allocation. + + + + + Initiates a drag on the source side. The function only needs to be used when the application is starting drags itself, and is not needed when -gtk_drag_source_set() is used."> - +gtk_drag_source_set() is used. +The @event is used to retrieve the timestamp that will be used internally to +grab the pointer. If @event is #NULL, then GDK_CURRENT_TIME will be used. +However, you should try to pass a real event in all cases, since that can be +used by GTK+ to get information about the start position of the drag, for +example if the @event is a GDK_MOTION_NOTIFY. +Generally there are three cases when you want to start a drag by hand by +calling this function: +1. During a button-press-event handler, if you want to start a drag +immediately when the user presses the mouse button. Pass the @event +that you have in your button-press-event handler. +2. During a motion-notify-event handler, if you want to start a drag +when the mouse moves past a certain threshold distance after a button-press. +Pass the @event that you have in your motion-notify-event handler. +3. During a timeout handler, if you want to start a drag after the mouse +button is held down for some time. Try to save the last event that you got +from the mouse, using gdk_event_copy(), and pass it to this function +(remember to free the event with gdk_event_free() when you are done). +If you can really not pass a real event, pass #NULL instead. + + the context for this drag. + the source widget. - + + The targets (data formats) in which the source can provide the data. + A bitmask of the allowed drag actions for this drag. - + The button the user clicked to start the drag. + + The event that triggered the start of the drag. + Checks to see if a mouse drag starting at (@start_x, @start_y) and ending at (@current_x, @current_y) has passed the GTK+ drag threshold, and thus -should trigger the beginning of a drag-and-drop operation."> +should trigger the beginning of a drag-and-drop operation. - + %TRUE if the drag threshold has been passed. + + a #GtkWidget - + X coordinate of start of drag + - + Y coordinate of start of drag + - + current X coordinate + - + current Y coordinate + + Add the image targets supported by #GtkSelection to +the target list of the drag destination. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_image_targets() and +gtk_drag_dest_set_target_list(). + a #GtkWidget that's a drag destination + Add the text targets supported by #GtkSelection to +the target list of the drag destination. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_text_targets() and +gtk_drag_dest_set_target_list(). + a #GtkWidget that's a drag destination + Add the URI targets supported by #GtkSelection to +the target list of the drag destination. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_uri_targets() and +gtk_drag_dest_set_target_list(). + a #GtkWidget that's a drag destination + Looks for a match between @context->targets and the returning %GDK_NONE. @dest_target_list should usually be the return value from gtk_drag_dest_get_target_list(), but some widgets may have different valid targets for different parts of the widget; in that case, they will have to implement a drag_motion handler that -passes the correct target list to this function."> - +passes the correct target list to this function. + + first target that the source offers and the dest can accept, or %GDK_NONE + drag destination widget + drag context - + + list of droppable targets, or %NULL to use gtk_drag_dest_get_target_list (@widget). + c:identifier="gtk_drag_dest_get_target_list"> + Returns the list of targets this widget can accept from +drag-and-drop. + the #GtkTargetList, or %NULL if none + a #GtkWidget + Returns whether the widget has been configured to always +emit ::drag-motion signals. - + %TRUE if the widget always emits ::drag-motion events + + a #GtkWidget that's a drag destination - + Sets a widget as a potential drop destination, and adds default behaviors. The default behaviors listed in @flags have an effect similar -to installing default handlers for the widget's drag-and-drop signals +to installing default handlers for the widget's drag-and-drop signals (#GtkWidget:drag-motion, #GtkWidget:drag-drop, ...). They all exist for convenience. When passing #GTK_DEST_DEFAULT_ALL for instance it is -sufficient to connect to the widget's #GtkWidget::drag-data-received +sufficient to connect to the widget's #GtkWidget::drag-data-received signal to get primitive, but consistent drag-and-drop support. Things become more complicated when you try to preview the dragged data, as described in the documentation for #GtkWidget:drag-motion. The default @@ -83404,8 +77845,8 @@ invokations of gdk_drag_status() in the context of #GtkWidget:drag-motion, and invokations of gtk_drag_finish() in #GtkWidget:drag-data-received. Especially the later is dramatic, when your own #GtkWidget:drag-motion handler calls gtk_drag_get_data() to inspect the dragged data. -There's no way to set a default action here, you can use the -#GtkWidget:drag-motion callback for that. Here's an example which selects +There's no way to set a default action here, you can use the +#GtkWidget:drag-motion callback for that. Here's an example which selects the action to use depending on whether the control key is pressed or not: |[ static void @@ -83423,29 +77864,31 @@ gdk_drag_status (context, GDK_ACTION_COPY, time); else gdk_drag_status (context, GDK_ACTION_MOVE, time); } -]|"> +]| + a #GtkWidget + which types of default drag behavior to use - + + a pointer to an array of #GtkTargetEntry<!-- -->s indicating the drop types that this @widget will accept, or %NULL. Later you can access the list with gtk_drag_dest_get_target_list() and gtk_drag_dest_find_target(). - + the number of entries in @targets + + a bitmask of possible actions for a drop onto this @widget. @@ -83466,47 +77909,48 @@ gdk_drag_status (context, GDK_ACTION_MOVE, time); - + + Sets the target types that this widget can accept from drag-and-drop. The widget must first be made into a drag destination with -gtk_drag_dest_set()."> +gtk_drag_dest_set(). + a #GtkWidget that's a drag destination - + + list of droppable targets, or %NULL for none + Tells the widget to emit ::drag-motion and ::drag-leave +events regardless of the targets and the %GTK_DEST_DEFAULT_MOTION +flag. +This may be used when a widget wants to do generic +actions regardless of the targets that the source offers. + a #GtkWidget that's a drag destination - + whether to accept all targets + @@ -83529,13 +77973,13 @@ actions regardless of the targets that the source offers." - + - + - + @@ -83554,17 +77998,22 @@ actions regardless of the targets that the source offers." - + - + Determines the source widget for a drag. +within a single application, a pointer to the source widget. +Otherwise, %NULL. + + if the drag is occurring + a (destination side) drag context @@ -83579,369 +78028,364 @@ actions regardless of the targets that the source offers." - - - - - - - - - - - - - - - - - - - - - - + c:identifier="gtk_drag_set_icon_default"> + Sets the icon for a particular drag to the default +icon. + the context for a drag. (This must be called + Sets the icon for a given drag from a named themed icon. See the docs for #GtkIconTheme for more details. Note that the size of the icon depends on the icon theme (the icon is -loaded at the symbolic size #GTK_ICON_SIZE_DND), thus" - version="2.8"> +loaded at the symbolic size #GTK_ICON_SIZE_DND), thus + the context for a drag. (This must be called with a context for the source side of a drag) + name of icon to use - + the X offset of the hotspot within the icon + - + the Y offset of the hotspot within the icon + + c:identifier="gtk_drag_set_icon_pixbuf"> + Sets @pixbuf as the icon for a given drag. + the context for a drag. (This must be called with a context for the source side of a drag) + the #GdkPixbuf to use as the drag icon. - + the X offset within @widget of the hotspot. + - + the Y offset within @widget of the hotspot. + + Sets @pixmap as the icon for a given drag. GTK+ retains references for the arguments, and will release them when they are no longer needed. In general, gtk_drag_set_icon_pixbuf() -will be more convenient to use."> +will be more convenient to use. + the context for a drag. (This must be called with a context for the source side of a drag) + the colormap of the icon + the image data for the icon - + + the transparency mask for the icon or %NULL for none. - + the X offset within @pixmap of the hotspot. + - + the Y offset within @pixmap of the hotspot. + + c:identifier="gtk_drag_set_icon_stock"> + Sets the icon for a given drag from a stock ID. + the context for a drag. (This must be called with a context for the source side of a drag) + the ID of the stock icon to use for the drag. - + the X offset within the icon of the hotspot. + - + the Y offset within the icon of the hotspot. + + c:identifier="gtk_drag_set_icon_widget"> + Changes the icon for a widget to a given widget. GTK+ +will not destroy the icon, so if you don't want +it to persist, you should connect to the "drag-end" +signal and destroy it yourself. + the context for a drag. (This must be called + a toplevel window to use as an icon. - + the X offset within @widget of the hotspot. + - + the Y offset within @widget of the hotspot. + + Add the writable image targets supported by #GtkSelection to +the target list of the drag source. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_image_targets() and +gtk_drag_source_set_target_list(). + a #GtkWidget that's is a drag source + Add the text targets supported by #GtkSelection to +the target list of the drag source. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_text_targets() and +gtk_drag_source_set_target_list(). + a #GtkWidget that's is a drag source + Add the URI targets supported by #GtkSelection to +the target list of the drag source. The targets +are added with @info = 0. If you need another value, +use gtk_target_list_add_uri_targets() and +gtk_drag_source_set_target_list(). + a #GtkWidget that's is a drag source + Gets the list of targets this widget can provide for +drag-and-drop. + the #GtkTargetList, or %NULL if none + a #GtkWidget - + + Sets up a widget so that GTK+ will start a drag operation when the user +clicks and drags on the widget. The widget must have a window. + a #GtkWidget + the bitmask of buttons that can start the drag - + + the table of targets that the drag will support, may be %NULL - + the number of items in @targets + + the bitmask of possible actions for a drag from this widget + Sets the icon that will be used for drags from a particular widget from a pixmap/mask. GTK+ retains references for the arguments, and will release them when they are no longer needed. -Use gtk_drag_source_set_icon_pixbuf() instead."> +Use gtk_drag_source_set_icon_pixbuf() instead. + a #GtkWidget + the colormap of the icon + the image data for the icon - + + the transparency mask for an image. + Sets the icon that will be used for drags from a particular source +to a themed icon. See the docs for #GtkIconTheme for more details. + a #GtkWidget + name of icon to use + c:identifier="gtk_drag_source_set_icon_pixbuf"> + Sets the icon that will be used for drags from a particular widget +from a #GdkPixbuf. GTK+ retains a reference for @pixbuf and will +release it when it is no longer needed. + a #GtkWidget + the #GdkPixbuf for the drag icon + c:identifier="gtk_drag_source_set_icon_stock"> + Sets the icon that will be used for drags from a particular source +to a stock icon. + a #GtkWidget + the ID of the stock icon to use + Changes the target types that this widget offers for drag-and-drop. +The widget must first be made into a drag source with +gtk_drag_source_set(). + a #GtkWidget that's a drag source - + + list of draggable targets, or %NULL for none @@ -83966,912 +78410,231 @@ gtk_drag_source_set()." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Draws a text caret on @drawable at @location. This is not a style function +but merely a convenience function for drawing the standard cursor shape. + a #GtkWidget + a #GdkDrawable - + + rectangle to which the output is clipped, or %NULL if the output should not be clipped + location where to draw the cursor (@location->width is ignored) - + if the cursor should be the primary cursor color. + + whether the cursor is left-to-right or right-to-left. Should never be #GTK_TEXT_DIR_NONE - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE to draw a directional arrow on the cursor. Should be %FALSE unless the cursor is split. + - + - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - + + Registers an error quark for #GtkFileChooser if necessary. - + The error quark used for #GtkFileChooser errors. + - - - - - - + Returns the binary age as passed to +<application>libtool</application> when building the GTK+ library +the process is running against. If +<application>libtool</application> means nothing to you, don't +worry about it. + + the binary age of the GTK+ library. + + + + + Obtains a copy of the event currently being processed by GTK+. For +example, if you get a "clicked" signal from #GtkButton, the current +event will be the #GdkEventButton that triggered the "clicked" signal. The returned event must be freed with gdk_event_free(). -If there is no current event, the function returns %NULL."> +If there is no current event, the function returns %NULL. + a copy of the current event, or %NULL if no current event. - + + If there is a current event and it has a device, return that +device, otherwise return %NULL. - + a #GdkDevice, or %NULL + + + + + If there is a current event and it has a state field, place +that state field in @state and return %TRUE, otherwise return +%FALSE. + + %TRUE if there was a current event and it had a state field + + a location to store the state of the current event + c:identifier="gtk_get_current_event_time"> + If there is a current event and it has a timestamp, return that +timestamp, otherwise return %GDK_CURRENT_TIME. - + the timestamp from the current event, or %GDK_CURRENT_TIME. + + + + + Returns the GTK+ debug flags setting. + + + Returns the #PangoLanguage for the default language currently in effect. (Note that this can change over the life of an application.) The default language is derived from the current locale. It determines, for example, whether GTK+ uses the right-to-left or left-to-right text direction. This function is equivalent to pango_language_get_default(). See that function for details. -freed"> +freed + the default language as a #PangoLanguage, must not be - + If @event is %NULL or the event was not associated with any widget, returns %NULL, otherwise returns the widget that received the event -originally."> - +originally. +received @event, or %NULL + + the widget that originally + a #GdkEvent + + Returns the interface age as passed to +<application>libtool</application> when building the GTK+ library +the process is running against. If +<application>libtool</application> means nothing to you, don't +worry about it. + + the interface age of the GTK+ library. + + + + + Returns the major version number of the GTK+ library. (e.g. in GTK+ version +3.1.5 this is 3.) +This function is in the library, so it represents the GTK+ library +your code is running against. Contrast with the #GTK_MAJOR_VERSION +macro, which represents the major version of the GTK+ headers you +have included when compiling your code. + + the major version number of the GTK+ library. + + + + + Returns the micro version number of the GTK+ library. (e.g. in GTK+ version +3.1.5 this is 5.) +This function is in the library, so it represents the GTK+ library +your code is are running against. Contrast with the +#GTK_MICRO_VERSION macro, which represents the micro version of the +GTK+ headers you have included when compiling your code. + + the micro version number of the GTK+ library. + + + + + Returns the minor version number of the GTK+ library. (e.g. in GTK+ version +3.1.5 this is 1.) +This function is in the library, so it represents the GTK+ library +your code is are running against. Contrast with the +#GTK_MINOR_VERSION macro, which represents the minor version of the +GTK+ headers you have included when compiling your code. + + the minor version number of the GTK+ library. + + + + Returns a #GOptionGroup for the commandline arguments recognized +by GTK+ and GDK. You should add this group to your #GOptionContext +with g_option_context_add_group(), if you are using g_option_context_parse() to parse your commandline arguments. -by GTK+" - version="2.6"> - +by GTK+ + + a #GOptionGroup for the commandline arguments recognized - + whether to open the default display when parsing the commandline arguments + @@ -84886,7 +78649,10 @@ by GTK+" - + Queries the current grab of the default window group. +has the grab or %NULL if no grab is active + + The widget which currently @@ -84901,227 +78667,165 @@ by GTK+" - - + c:identifier="gtk_icon_size_from_name"> + Looks up the icon size associated with @name. + + the icon size + + the name to look up. - + + Gets the canonical name of the given icon size. The returned string +is statically allocated and should not be freed. + the name of the given icon size. - - + + a #GtkIconSize. + - + Obtains the pixel size of a semantic icon size, possibly modified by user preferences for the default #GtkSettings. (See gtk_icon_size_lookup_for_settings().) Normally @size would be #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_BUTTON, etc. This function -isn't normally needed, gtk_widget_render_icon() is the usual +isn't normally needed, gtk_widget_render_icon() is the usual way to get an icon for rendering, then just look at the size of the rendered pixbuf. The rendered pixbuf may not even correspond to the width/height returned by gtk_icon_size_lookup(), because themes are free to render the pixbuf however they like, including changing -the usual size."> +the usual size. - + %TRUE if @size was a valid size + - - + + an icon size + - - + + location to store icon width + - - + + location to store icon height + + Obtains the pixel size of a semantic icon size, possibly modified by user preferences for a particular #GtkSettings. Normally @size would be #GTK_ICON_SIZE_MENU, #GTK_ICON_SIZE_BUTTON, etc. This function -isn't normally needed, gtk_widget_render_icon() is the usual +isn't normally needed, gtk_widget_render_icon() is the usual way to get an icon for rendering, then just look at the size of the rendered pixbuf. The rendered pixbuf may not even correspond to the width/height returned by gtk_icon_size_lookup(), because themes are free to render the pixbuf however they like, including changing -the usual size." - version="2.2"> +the usual size. - + %TRUE if @size was a valid size + + a #GtkSettings object, used to determine which set of user preferences to used. - - + + an icon size + - - + + location to store icon width + - - + + location to store icon height + - - - + + Registers a new icon size, along the same lines as #GTK_ICON_SIZE_MENU, +etc. Returns the integer value for the size. + + integer value representing the size + + name of the icon size - + the icon width + - + the icon height + + Registers @alias as another name for @target. So calling gtk_icon_size_from_name() with @alias as argument -will return @target."> +will return @target. + an alias for @target - - + + an existing icon size + - + - + - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Call this function before using any other GTK+ functions in your GUI applications. It will initialize everything needed to operate the -toolkit and parses some standard command line options. @argc and -never see those standard arguments. -Note that there are some alternative ways to initialize GTK+: -if you are calling gtk_parse_args(), gtk_init_check(), -gtk_init_with_args() or g_option_context_parse() with -the option group returned by gtk_get_option_group(), you -<emphasis>don't</emphasis> have to call gtk_init(). +toolkit and parses some standard command line options. @argc and +never see those standard arguments. +if you are calling gtk_parse_args(), gtk_init_check(), +gtk_init_with_args() or g_option_context_parse() with +the option group returned by gtk_get_option_group(), you +<emphasis>don't</emphasis> have to call gtk_init(). <note><para> -This function will terminate your program if it was unable to initialize -the GUI for some reason. If you want your program to fall back to a +This function will terminate your program if it was unable to initialize +the GUI for some reason. If you want your program to fall back to a textual interface you want to call gtk_init_check() instead. </para></note> <note><para> @@ -85131,66 +78835,67 @@ almost never wanted in graphical applications. If you do need to handle SIGPIPE for some reason, reset the handler after gtk_init(), but notice that other libraries (e.g. libdbus or gvfs) might do similar things. -</para></note>"> +</para></note> - + caller-allocates="0" + transfer-ownership="full"> + Address of the <parameter>argc</parameter> parameter of your main() function. Changed if any arguments were handled. + + Address of the <parameter>argv</parameter> parameter of main(). Any parameters understood by gtk_init() are stripped before return. - + - + - + - + This function does the same work as gtk_init() with only initialized. Instead it returns %FALSE on failure. -This way the application can fall back to some other means of communication +This way the application can fall back to some other means of communication with the user - for example a curses or command line interface. -%FALSE otherwise."> +%FALSE otherwise. - + %TRUE if the GUI has been successfully initialized, + - + caller-allocates="0" + transfer-ownership="full"> + Address of the <parameter>argc</parameter> parameter of your main() function. Changed if any arguments were handled. + + Address of the <parameter>argv</parameter> parameter of main(). Any parameters understood by gtk_init() are stripped before return. @@ -85199,93 +78904,53 @@ with the user - for example a curses or command line interface. + This function does the same work as gtk_init_check(). Additionally, it allows you to add your own commandline options, and it automatically generates nicely formatted <option>--help</option> output. Note that your program will be terminated after writing out the help output. -%FALSE otherwise." - version="2.6" - throws="1"> +%FALSE otherwise. - + %TRUE if the GUI has been successfully initialized, + - - + + a pointer to the number of command line arguments. + - + a pointer to the array of command line arguments. + - + a string which is displayed in the first line of <option>--help</option> output, after <literal><replaceable>programname</replaceable> [OPTION...]</literal> + + a %NULL-terminated array of #GOptionEntry<!-- -->s describing the options of your program - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a translation domain to use for translating the <option>--help</option> output for the options in @entries and the @parameter_string with gettext(), or %NULL + + c:identifier="gtk_key_snooper_install" + introspectable="0"> - + - + - + @@ -85295,7 +78960,7 @@ be terminated after writing out the help output. - + @@ -85316,22 +78981,22 @@ be terminated after writing out the help output. - + - + - + - + @@ -85339,1251 +79004,1161 @@ be terminated after writing out the help output. - + + Draws an arrow in the given rectangle on @window using the given +parameters. @arrow_type determines the direction of the arrow. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail + the type of arrow to draw - + %TRUE if the arrow tip should be filled + - + x origin of the rectangle to draw the arrow in + - + y origin of the rectangle to draw the arrow in + - + width of the rectangle to draw the arrow in + - + height of the rectangle to draw the arrow in + - + + Draws a box on @window with the given parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the box + - + y origin of the box + - + the width of the box + - + the height of the box + - + + Draws a box in @window using the given style and state and shadow type, +leaving a gap in one side. + a #GtkStyle + a #GdkWindow + a state + type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle + - + y origin of the rectangle + - + width of the rectangle + - + width of the rectangle + + side in which to leave the gap - + starting position of the gap + - + width of the gap + - + + Draws a check button indicator in the given rectangle on @window with +the given parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle to draw the check in + - + y origin of the rectangle to draw the check in + - + the width of the rectangle to draw the check in + - + the height of the rectangle to draw the check in + - + + Draws a diamond in the given rectangle on @window using the given +parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle to draw the diamond in + - + y origin of the rectangle to draw the diamond in + - + width of the rectangle to draw the diamond in + - + height of the rectangle to draw the diamond in + - + Draws an expander as used in #GtkTreeView. @x and @y specify the center the expander. The size of the expander is determined by the -"expander-size" style property of @widget. (If widget is not -specified or doesn't have an "expander-size" property, an -unspecified default size will be used, since the caller doesn't +"expander-size" style property of @widget. (If widget is not +specified or doesn't have an "expander-size" property, an +unspecified default size will be used, since the caller doesn't have sufficient information to position the expander, this is likely not useful.) The expander is expander_size pixels tall in the collapsed position and expander_size pixels wide in the -expanded position."> +expanded position. + a #GtkStyle + a #GdkWindow + a state - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + the x position to draw the expander at + - + the y position to draw the expander at + + the style to draw the expander in; determines whether the expander is collapsed, expanded, or in an intermediate state. - + + Draws an extension, i.e. a notebook tab. + a #GtkStyle + a #GdkWindow + a state + type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the extension + - + y origin of the extension + - + width of the extension + - + width of the extension + + the side on to which the extension is attached - + + Draws a flat box on @window with the given parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the box + - + y origin of the box + - + the width of the box + - + the height of the box + - + + Draws a focus indicator around the given rectangle on @window using the +given style. + a #GtkStyle + a #GdkWindow + a state - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + the x origin of the rectangle around which to draw a focus indicator + - + the y origin of the rectangle around which to draw a focus indicator + - + the width of the rectangle around which to draw a focus indicator + - + the height of the rectangle around which to draw a focus indicator + - + + Draws a handle as used in #GtkHandleBox and #GtkPaned. + a #GtkStyle + a #GdkWindow + a state + type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the handle + - + y origin of the handle + - + with of the handle + - + height of the handle + + the orientation of the handle - + + Draws a horizontal line from (@x1, @y) to (@x2, @y) in @window +using the given style and state. + a #GtkStyle + a #GdkWindow + a state - + + rectangle to which the output is clipped, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + the starting x coordinate + - + the ending x coordinate + - + the y coordinate + - + + Draws a layout on @window using the given parameters. + a #GtkStyle + a #GdkWindow + a state - + whether to use the text or foreground graphics context of @style + - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin + - + y origin + + the layout to draw - + + Draws a radio button indicator in the given rectangle on @window with +the given parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle to draw the option in + - + y origin of the rectangle to draw the option in + - + the width of the rectangle to draw the option in + - + the height of the rectangle to draw the option in + - + + Draws a resize grip in the given rectangle on @window using the given +parameters. + a #GtkStyle + a #GdkWindow + a state - - - - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a style detail + the edge in which to draw the resize grip - + the x origin of the rectangle in which to draw the resize grip + - + the y origin of the rectangle in which to draw the resize grip + - + the width of the rectangle in which to draw the resize grip + - + the height of the rectangle in which to draw the resize grip + - + + Draws a shadow around the given rectangle in @window +using the given style and state and shadow type. + a #GtkStyle + a #GdkWindow + a state + type of shadow to draw - + + clip rectangle or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle + - + y origin of the rectangle + - + width of the rectangle + - + width of the rectangle + - + + Draws a shadow around the given rectangle in @window +using the given style and state and shadow type, leaving a +gap in one side. + a #GtkStyle + a #GdkWindow + a state + type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle + - + y origin of the rectangle + - + width of the rectangle + - + width of the rectangle + + side in which to leave the gap - + starting position of the gap + - + width of the gap + - + + Draws a slider in the given rectangle on @window using the +given style and orientation. + a #GtkStyle + a #GdkWindow + a state + a shadow - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + the x origin of the rectangle in which to draw a slider + - + the y origin of the rectangle in which to draw a slider + - + the width of the rectangle in which to draw a slider + - + the height of the rectangle in which to draw a slider + + the orientation to be used + Draws a spinner on @window using the given parameters. + a #GtkStyle + a #GdkWindow + a state - + + clip rectangle, or %NULL if the output should not be clipped + the widget (may be %NULL) + a style detail (may be %NULL) - + the nth step, a value between 0 and #GtkSpinner:num-steps + - + the x origin of the rectangle in which to draw the spinner + - + the y origin of the rectangle in which to draw the spinner + - + the width of the rectangle in which to draw the spinner + - + the height of the rectangle in which to draw the spinner + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Draws an option menu tab (i.e. the up and down pointing arrows) +in the given rectangle on @window using the given parameters. + a #GtkStyle + a #GdkWindow + a state + the type of shadow to draw - + + clip rectangle, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + x origin of the rectangle to draw the tab in + - + y origin of the rectangle to draw the tab in + - + the width of the rectangle to draw the tab in + - + the height of the rectangle to draw the tab in + - + + Draws a vertical line from (@x, @y1_) to (@x, @y2_) in @window +using the given style and state. + a #GtkStyle + a #GdkWindow + a state - + + rectangle to which the output is clipped, or %NULL if the output should not be clipped - + + the widget - + + a style detail - + the starting y coordinate + - + the ending y coordinate + - + the x coordinate + + Returns the name of the default paper size, which +depends on the current locale. +is owned by GTK+ and should not be modified. + the name of the default paper size. The string - + Creates a list of known paper sizes. +allocated #GtkPaperSize objects + + a newly allocated list of newly - + whether to include custom paper sizes as defined in the page setup dialog + - + Parses command line arguments, and initializes global attributes of GTK+, but does not actually open a connection to a display. (See gdk_display_open(), gdk_get_display_arg_name()) Any arguments used by GTK+ or GDK are removed from the array and -You shouldn't call this function explicitely if you are using -gtk_init(), or gtk_init_check()."> +You shouldn't call this function explicitely if you are using +gtk_init(), or gtk_init_check(). - + %TRUE if initialization succeeded, otherwise %FALSE. + - + caller-allocates="0" + transfer-ownership="full"> + a pointer to the number of command line arguments. + + caller-allocates="0" + transfer-ownership="full"> + a pointer to the array of command line arguments. + + Registers an error quark for #GtkPrintOperation if necessary. + + The error quark used for #GtkPrintOperation errors. + + + - + introspectable="0"> + - + - + @@ -86593,86 +80168,71 @@ a problem." + introspectable="0"> - + - + - + - + - + Sends an event to a widget, propagating the event to parent widgets if the event remains unhandled. Events received by GTK+ from GDK normally begin in gtk_main_do_event(). Depending on the type of event, existence of modal dialogs, grabs, etc., the event may be propagated; if so, this function is used. gtk_propagate_event() calls gtk_widget_event() on each widget it decides to send the event to. So gtk_widget_event() is the lowest-level function; it -simply emits the "event" and possibly an event-specific signal on a +simply emits the "event" and possibly an event-specific signal on a widget. gtk_propagate_event() is a bit higher-level, and gtk_main_do_event() is the highest level. -All that said, you most likely don't want to use any of these +All that said, you most likely don't want to use any of these functions; synthesizing events is rarely needed. Consider asking on the mailing list for better ways to achieve your goals. For example, use gdk_window_invalidate_rect() or -gtk_widget_queue_draw() instead of making up expose events."> +gtk_widget_queue_draw() instead of making up expose events. + a #GtkWidget + an event - + - + - + - + - + @@ -86682,22 +80242,24 @@ gtk_widget_queue_draw() instead of making up expose events."> - + - + - + - + - + - + - + @@ -86721,7 +80283,7 @@ gtk_widget_queue_draw() instead of making up expose events."> - + @@ -86732,205 +80294,169 @@ gtk_widget_queue_draw() instead of making up expose events."> - - - - - - - - - - - - - - + + c:identifier="gtk_rc_add_default_file"> + Adds a file to the list of files to be parsed at the +end of gtk_init(). - - - - - - - - - - - - - - - - - - - - - - - - - - + the pathname to the file. If @filename is not absolute, it is searched in the current directory. + Searches for a theme engine in the GTK+ search path. This function is not useful for applications and should not be used. -otherwise %NULL."> - +otherwise %NULL. + + The filename, if found (must be freed with g_free()), + name of a theme engine + Looks up a file in pixmap path for the specified #GtkSettings. If the file is not found, it outputs a warning message using -g_warning() and returns %NULL."> +g_warning() and returns %NULL. + the filename. + a #GtkSettings + Scanner used to get line number information for the warning message, or %NULL + name of the pixmap file to locate. + Retrieves the current list of RC files that will be parsed at the end of gtk_init(). -is owned by GTK+ and must not be freed by the application. -If you want to store this information, you should make a copy."> - +This memory is owned by GTK+ and must not be freed by the application. +If you want to store this information, you should make a copy. + + A %NULL-terminated array of filenames. + c:identifier="gtk_rc_get_im_module_file"> + Obtains the path to the IM modules file. See the documentation +of the <link linkend="im-module-file"><envar>GTK_IM_MODULE_FILE</envar></link> +environment variable for more details. + a newly-allocated string containing the name of the file listing the IM modules available for loading + Obtains the path in which to look for IM modules. See the documentation +of the <link linkend="im-module-path"><envar>GTK_PATH</envar></link> environment variable for more details about looking up modules. This function is useful solely for utilities supplied with GTK+ and should -not be used by applications under normal circumstances."> +not be used by applications under normal circumstances. + a newly-allocated string containing the path in which to look for IM modules. - + Returns a directory in which GTK+ looks for theme engines. For full information about the search for theme engines, see the docs for <envar>GTK_PATH</envar> in -<xref linkend="gtk-running"/>."> +<xref linkend="gtk-running"/>. + the directory. (Must be freed with g_free()) + Finds all matching RC styles for a given widget, +composites them together, and then creates a #GtkStyle representing the composite appearance. -(GTK+ actually keeps a cache of previously +(GTK+ actually keeps a cache of previously created styles, so a new style may not be created.) to the returned style, so if you want to save this -style around, you should add a reference yourself."> - +style around, you should add a reference yourself. + + the resulting style. No refcount is added + a #GtkWidget + Creates up a #GtkStyle from styles defined in a RC file by providing the raw components used in matching. This function may be useful when creating pseudo-widgets that should be themed like widgets but -don't actually have corresponding GTK+ widgets. An example of this +don't actually have corresponding GTK+ widgets. An example of this would be items inside a GNOME canvas widget. The action of gtk_rc_get_style() is similar to: |[ gtk_widget_path (widget, NULL, &path, NULL); gtk_widget_class_path (widget, NULL, &class_path, NULL); -gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget), +gtk_rc_get_style_by_paths (gtk_widget_get_settings (widget), path, class_path, G_OBJECT_TYPE (widget)); ]| -or %NULL if nothing matching was specified and the default style should -be used. The returned value is owned by GTK+ as part of an internal cache, -so you must call g_object_ref() on the returned value if you want to -keep a reference to it."> - +supplied paths, or %NULL if nothing matching was specified and the +default style should be used. The returned value is owned by GTK+ +as part of an internal cache, so you must call g_object_ref() on +the returned value if you want to keep a reference to it. + + A style created by matching with the + a #GtkSettings object - + + the widget path to use when looking up the style, or %NULL if no matching against the widget path should be done - + + the class path to use when looking up the style, or %NULL if no matching against the class path should be done. + a type that will be used along with parent types of this type when matching against class styles, or #G_TYPE_NONE @@ -86950,53 +80476,56 @@ keep a reference to it."> - + Parses a color in the <link linkend="color=format">format</link> expected +in a RC file. +Note that theme engines should use gtk_rc_parse_color_full() in order to support symbolic colors. -that was expected but not found"> +that was expected but not found - + %G_TOKEN_NONE if parsing succeeded, otherwise the token + + a #GScanner + a pointer to a #GdkColor structure in which to store the result + Parses a color in the <link linkend="color=format">format</link> expected in a RC file. If @style is not %NULL, it will be consulted to resolve references to symbolic colors. -that was expected but not found" - version="2.12"> +that was expected but not found - + %G_TOKEN_NONE if parsing succeeded, otherwise the token + + a #GScanner - + + a #GtkRcStyle, or %NULL + a pointer to a #GdkColor structure in which to store the result - + @@ -87009,7 +80538,7 @@ that was expected but not found" - + @@ -87031,150 +80560,174 @@ that was expected but not found" + A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() or gtk_widget_class_install_style_property_parser() which parses -borders in the form -<literal>"{ left, right, top, bottom }"</literal> for integers +borders in the form +<literal>"{ left, right, top, bottom }"</literal> for integers %left, %right, %top and %bottom. -has been set to the resulting #GtkBorder."> +has been set to the resulting #GtkBorder. - + %TRUE if @gstring could be parsed and @property_value + + a #GParamSpec + the #GString to be parsed + a #GValue which must hold boxed values. + A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() or gtk_widget_class_install_style_property_parser() which parses a -color given either by its name or in the form +color given either by its name or in the form <literal>{ red, green, blue }</literal> where %red, %green and %blue are integers between 0 and 65535 or floating-point numbers between 0 and 1. -has been set to the resulting #GdkColor."> +has been set to the resulting #GdkColor. - + %TRUE if @gstring could be parsed and @property_value + + a #GParamSpec + the #GString to be parsed + a #GValue which must hold #GdkColor values. + A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() or gtk_widget_class_install_style_property_parser() which parses a single enumeration value. The enumeration value can be specified by its name, its nickname or its numeric value. For consistency with flags parsing, the value may be surrounded by parentheses. -has been set to the resulting #GEnumValue."> +has been set to the resulting #GEnumValue. - + %TRUE if @gstring could be parsed and @property_value + + a #GParamSpec + the #GString to be parsed + a #GValue which must hold enum values. + A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() +or gtk_widget_class_install_style_property_parser() which parses flags. Flags can be specified by their name, their nickname or -numerically. Multiple flags can be specified in the form -<literal>"( flag1 | flag2 | ... )"</literal>. -has been set to the resulting flags value."> +numerically. Multiple flags can be specified in the form +<literal>"( flag1 | flag2 | ... )"</literal>. +has been set to the resulting flags value. - + %TRUE if @gstring could be parsed and @property_value + + a #GParamSpec + the #GString to be parsed + a #GValue which must hold flags values. + A #GtkRcPropertyParser for use with gtk_settings_install_property_parser() or gtk_widget_class_install_style_property_parser() which parses a -requisition in the form -<literal>"{ width, height }"</literal> for integers %width and %height. -has been set to the resulting #GtkRequisition."> +requisition in the form +<literal>"{ width, height }"</literal> for integers %width and %height. +has been set to the resulting #GtkRequisition. - + %TRUE if @gstring could be parsed and @property_value + + a #GParamSpec + the #GString to be parsed + a #GValue which must hold boxed values. - + If the modification time on any previously read file for the default #GtkSettings has changed, discard all style information -and then reread all previously read RC files."> +and then reread all previously read RC files. - + %TRUE if the files were reread. + + If the modification time on any previously read file for the given #GtkSettings has changed, discard all style information -and then reread all previously read RC files."> +and then reread all previously read RC files. - + %TRUE if the files were reread. + + a #GtkSettings - + load whether or not anything changed + + This function recomputes the styles for all widgets that use a particular #GtkSettings object. (There is one #GtkSettings object per #GdkScreen, see gtk_settings_get_for_screen()); It is useful when some global parameter has changed that affects the appearance @@ -87182,240 +80735,263 @@ of all widgets, because when a widget gets a new style, it will both redraw and recompute any cached information about its appearance. As an example, it is used when the default font size set by the operating system changes. Note that this function -doesn't affect widgets that have a style set explicitely on them -with gtk_widget_set_style()." - version="2.4"> +doesn't affect widgets that have a style set explicitely on them +with gtk_widget_set_style(). + a #GtkSettings - - + + + c:identifier="gtk_rc_set_default_files"> + Sets the list of files that GTK+ will read at the +end of gtk_init(). - - - + A %NULL-terminated list of filenames. + - + + + + + + + + + + + Converts a color from RGB space to HSV. Input values must be in the [0.0, 1.0] range; -output values will be in the same range." - version="2.14"> +output values will be in the same range. - + Red + - + Green + - + Blue + - - + + Return value for the hue component + - - + + Return value for the saturation component + - - + + Return value for the value component + + c:identifier="gtk_selection_add_target"> + Appends a specified target to the list of supported targets for a +given widget and selection. + a #GtkTarget + the selection + target to add. - + A unsigned integer which will be passed back to the application. + + c:identifier="gtk_selection_add_targets"> + Prepends a table of targets to the list of supported targets +for a given widget and selection. + a #GtkWidget + the selection + a table of targets to add - - - - - - - - - - - - - - + number of entries in @targets + + c:identifier="gtk_selection_clear_targets"> + Remove all targets registered for the given selection for the +widget. + a #GtkWidget + an atom representing a selection - + Requests the contents of a selection. When received, +a "selection-received" signal will be generated. request. (e.g., there was already a request in process for -this widget)."> +this widget). - + %TRUE if requested succeeded. %FALSE if we could not process + + The widget which acts as requestor + Which selection to get + Form of information desired (e.g., STRING) - + Time of request (usually of triggering event) + + c:identifier="gtk_selection_owner_set"> + Claims ownership of a given selection for a particular widget, +or, if @widget is %NULL, release ownership of the selection. - + %TRUE if the operation succeeded + - + + a #GtkWidget, or %NULL. + an interned atom representing the selection to claim - + timestamp with which to claim the selection + + Claim ownership of a given selection for a particular widget, or, +if @widget is %NULL, release ownership of the selection. - + TRUE if the operation succeeded + + the #Gdkdisplay where the selection is set - + + new selection owner (a #GdkWidget), or %NULL. + an interned atom representing the selection to claim. - + timestamp with which to claim the selection + + Removes all handlers and unsets ownership of all selections for a widget. Called when widget is being destroyed. This function will not generally be -called by applications."> +called by applications. + a #GtkWidget - + Sets the GTK+ debug flags. + + + + + + + + + + + Initializes internationalization support for GTK+. gtk_init() automatically does this, so there is typically no point in calling this function. If you are calling this function because you changed the locale @@ -87425,34 +81001,35 @@ after GTK+ is initialized may produce inconsistent results and is not really supported.) In detail - sets the current locale according to the program environment. This is the same as calling the C library function -<literal>setlocale (LC_ALL, "")</literal> but also takes care of the +<literal>setlocale (LC_ALL, "")</literal> but also takes care of the locale specific setup of the windowing system used by GDK. form lang_COUNTRY, where lang is an ISO-639 language code, and COUNTRY is an ISO-3166 country code. On Unix, this form matches the -result of the setlocale(); it is also used on other machines, such as -Windows, where the C library returns a different result. The string is -owned by GTK+ and should not be modified or freed."> +result of the setlocale(); it is also used on other machines, such as +Windows, where the C library returns a different result. The string is +owned by GTK+ and should not be modified or freed. + a string corresponding to the locale set, typically in the + This is a convenience function for showing an application's about box. The constructed dialog is associated with the parent window and -reused for future invocations of this function." - version="2.6"> +reused for future invocations of this function. - + + transient parent, or %NULL for none + the name of the first property @@ -87463,7 +81040,9 @@ reused for future invocations of this function." + This is a convenience function for launching the default application to show the uri. The uri must be of a form understood by GIO. Typical examples are <simplelist> @@ -87475,346 +81054,96 @@ Ideally the timestamp is taken from the event triggering the gtk_show_uri() call. If timestamp is not known you can take %GDK_CURRENT_TIME. This function can be used as a replacement for gnome_vfs_url_show() -and gnome_url_show()." - version="2.14" - throws="1"> +and gnome_url_show(). - + %TRUE on success, %FALSE on error. + - + + screen to show the uri on or %NULL for the default screen + the uri to show - + a timestamp to prevent focus stealing. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Registers each of the stock items in @items. If an item already exists with the same stock ID as one of the @items, the old item gets replaced. The stock items are copied, so GTK+ does not hold any pointer into @items and @items can be freed. Use gtk_stock_add_static() if @items is persistent and GTK+ need not -copy the array."> +copy the array. + a #GtkStockItem or array of items - + number of #GtkStockItem in @items + - + + Same as gtk_stock_add(), but doesn't copy @items, so + a #GtkStockItem or array of #GtkStockItem - + number of items + - + Retrieves a list of all known stock IDs added to a #GtkIconFactory or registered with gtk_stock_add(). The list must be freed with g_slist_free(), -and each string in the list must be freed with g_free()."> - +and each string in the list must be freed with g_free(). + + a list of known stock IDs - + + Fills @item with the registered values for @stock_id, returning %TRUE +if @stock_id was known. - + %TRUE if @item was initialized + + a stock item name + stock item to initialize with values + Sets a function to be used for translating the @label of a stock item. If no function is registered for a translation domain, g_dgettext() is used. @@ -87824,9 +81153,9 @@ of your application for this, as long as your #GtkTranslateFunc uses the correct domain when calling dgettext(). This can be useful, e.g. when dealing with message contexts: |[ -GtkStockItem items[] = { -{ MY_ITEM1, NC_("odd items", "Item 1"), 0, 0, "odd-item-domain" }, -{ MY_ITEM2, NC_("even items", "Item 2"), 0, 0, "even-item-domain" }, +GtkStockItem items[] = { +{ MY_ITEM1, NC_("odd items", "Item 1"), 0, 0, "odd-item-domain" }, +{ MY_ITEM2, NC_("even items", "Item 2"), 0, 0, "even-item-domain" }, }; gchar * my_translate_func (const gchar *msgid, @@ -87837,15 +81166,15 @@ return (gchar*)g_dpgettext2 (GETTEXT_PACKAGE, msgctxt, msgid); } /&ast; ... &ast;/ gtk_stock_add (items, G_N_ELEMENTS (items)); -gtk_stock_set_translate_func ("odd-item-domain", my_translate_func, "odd items"); -gtk_stock_set_translate_func ("even-item-domain", my_translate_func, "even items"); -]|" - version="2.8"> +gtk_stock_set_translate_func ("odd-item-domain", my_translate_func, "odd items"); +gtk_stock_set_translate_func ("even-item-domain", my_translate_func, "even items"); +]| + the translation domain for which @func shall be used + a #GtkTranslateFunc - + data to pass to @func + - + + a #GDestroyNotify that is called when @data is no longer needed + This function frees a target table as returned by +gtk_target_table_new_from_list() + a #GtkTargetEntry array - + the number of entries in the array + + This function creates an #GtkTargetEntry array that contains the same targets as the passed %list. The returned table is newly allocated and should be freed using gtk_target_table_free() when no -longer needed." - version="2.10"> - +longer needed. + + the new table. + a #GtkTargetList - - + + return location for the number ot targets in the table + + Determines if any of the targets in @targets can be used to +provide a #GdkPixbuf. +otherwise %FALSE. - + %TRUE if @targets include a suitable target for images, + + an array of #GdkAtom<!-- -->s - + the length of @targets + - + whether to accept only targets for which GTK+ knows how to convert a pixbuf into the format + + Determines if any of the targets in @targets can be used to +provide rich text. +otherwise %FALSE. - + %TRUE if @targets include a suitable target for rich text, + + an array of #GdkAtom<!-- -->s - + the length of @targets + + a #GtkTextBuffer + Determines if any of the targets in @targets can be used to +provide text. +otherwise %FALSE. - + %TRUE if @targets include a suitable target for text, + + an array of #GdkAtom<!-- -->s - + the length of @targets + + Determines if any of the targets in @targets can be used to +provide an uri list. +otherwise %FALSE. - + %TRUE if @targets include a suitable target for uri lists, + + an array of #GdkAtom<!-- -->s - + the length of @targets + - + c:identifier="gtk_test_create_simple_window" + introspectable="0"> + @@ -87992,8 +81344,10 @@ otherwise %FALSE." - - + + @@ -88010,8 +81364,9 @@ otherwise %FALSE." - + c:identifier="gtk_test_display_button_window" + introspectable="0"> + @@ -88027,8 +81382,10 @@ otherwise %FALSE." - - + + @@ -88040,8 +81397,10 @@ otherwise %FALSE." - - + + @@ -88053,8 +81412,10 @@ otherwise %FALSE." - - + + @@ -88071,26 +81432,26 @@ otherwise %FALSE." + This function is used to initialize a GTK+ test program. It will in turn call g_test_init() and gtk_init() to properly -initialize the testing framework and graphical toolkit. It'll -also set the program's locale to "C" and prevent loading of rc +initialize the testing framework and graphical toolkit. It'll +also set the program's locale to "C" and prevent loading of rc files and Gtk+ modules. This is done to make tets program environments as deterministic as possible. Like gtk_init() and g_test_init(), any known arguments will be -processed and stripped from @argc and @argv." - version="2.14"> +processed and stripped from @argc and @argv. - - + + Address of the <parameter>argc</parameter> parameter of the main() function. Changed if any arguments were handled. + + Address of the <parameter>argv</parameter> parameter of main(). Any parameters understood by g_test_init() or gtk_init() are stripped before return. @@ -88105,8 +81466,8 @@ processed and stripped from @argc and @argv." - - + + @@ -88119,7 +81480,7 @@ processed and stripped from @argc and @argv." - + @@ -88137,24 +81498,24 @@ processed and stripped from @argc and @argv." - + - + - + - + @@ -88183,14 +81544,14 @@ processed and stripped from @argc and @argv." - + - + @@ -88200,286 +81561,184 @@ processed and stripped from @argc and @argv." - + - + - + - + + + + - - + + - - - - - - - - - + + - - + + - - + + - - - - - - - - - + + - - + + - - + + - - + + - - - - - - - - - - - - + + + + + Obtains a @tree_model and @path from selection data of target type %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler. This function can only be used if @selection_data originates from the same -process that's calling this function, because a pointer to the tree model -is being passed around. If you aren't in the same process, then you'll +process that's calling this function, because a pointer to the tree model +is being passed around. If you aren't in the same process, then you'll get memory corruption. In the #GtkTreeDragDest drag_data_received handler, you can assume that selection data of type %GTK_TREE_MODEL_ROW is in from the current process. The returned path must be freed with gtk_tree_path_free(). -is otherwise valid"> +is otherwise valid - + %TRUE if @selection_data had target type %GTK_TREE_MODEL_ROW and + + a #GtkSelectionData + a #GtkTreeModel + row in @tree_model + c:identifier="gtk_tree_row_reference_deleted"> + Lets a set of row reference created by gtk_tree_row_reference_new_proxy() +know that the model emitted the "row_deleted" signal. + A #GObject + The path position that was deleted + c:identifier="gtk_tree_row_reference_inserted"> + Lets a set of row reference created by gtk_tree_row_reference_new_proxy() +know that the model emitted the "row_inserted" signal. + A #GObject + The row position that was inserted + c:identifier="gtk_tree_row_reference_reordered"> + Lets a set of row reference created by gtk_tree_row_reference_new_proxy() +know that the model emitted the "rows_reordered" signal. + A #GObject + The parent path of the reordered signal + The iter pointing to the parent of the reordered - - + + The new order of rows + + c:identifier="gtk_tree_set_row_drag_data"> + Sets selection data of target type %GTK_TREE_MODEL_ROW. Normally used +in a drag_data_get handler. - + %TRUE if the #GtkSelectionData had the proper target type to allow us to set a tree row + + some #GtkSelectionData + a #GtkTreeModel + a row in @tree_model - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/basis/gtk/ffi/ffi.factor b/basis/gtk/ffi/ffi.factor index e649025670..1a4c3ebca0 100644 --- a/basis/gtk/ffi/ffi.factor +++ b/basis/gtk/ffi/ffi.factor @@ -1,12 +1,18 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.destructors alien.libraries -cairo.ffi combinators kernel system -gobject-introspection atk.ffi gdk.ffi gdk.pixbuf.ffi gio.ffi -glib.ffi gmodule.ffi gobject.ffi pango.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.c-types alien.destructors alien.libraries +alien.syntax combinators gobject-introspection +gobject-introspection.standard-types kernel pango.ffi system +vocabs.loader ; IN: gtk.ffi +<< +"atk.ffi" require +"gdk.ffi" require +>> + +LIBRARY: gtk + << "gtk" { { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" cdecl add-library ] } @@ -15,14 +21,14 @@ IN: gtk.ffi } cond >> -TYPEDEF: void GtkAllocation -TYPEDEF: void GtkEnumValue -TYPEDEF: void GtkFlagValue -TYPEDEF: GType GtkType - IMPLEMENT-STRUCTS: GtkTreeIter ; -GIR: vocab:gtk/Gtk-2.0.gir +GIR: vocab:gtk/Gtk-3.0.gir DESTRUCTOR: gtk_widget_destroy +! diff --git a/basis/gtk/gl/GtkGL-1.0.gir b/basis/gtk/gl/GtkGL-1.0.gir deleted file mode 100644 index a2d54ffdeb..0000000000 --- a/basis/gtk/gl/GtkGL-1.0.gir +++ /dev/null @@ -1,173 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/basis/gtk/gl/GtkGLExt-1.0.gir b/basis/gtk/gl/GtkGLExt-1.0.gir new file mode 100644 index 0000000000..01b4bd05dd --- /dev/null +++ b/basis/gtk/gl/GtkGLExt-1.0.gir @@ -0,0 +1,213 @@ + + + + + + + + + + + + + + + + + + + + + + Call this function before using any other GtkGLExt functions in your +applications. It will initialize everything needed to operate the library +and parses some standard command line options. @argc and +never see those standard arguments. +<note><para> +This function will terminate your program if it was unable to initialize +the library for some reason. If you want your program to fall back to a +textual interface you want to call gtk_gl_init_check() instead. +</para></note> + + + + + + Address of the <parameter>argc</parameter> parameter of your <function>main()</function> function. Changed if any arguments were handled. + + + + Address of the <parameter>argv</parameter> parameter of <function>main()</function>. Any parameters understood by gtk_gl_init() are stripped before return. + + + + + + + + This function does the same work as gtk_gl_init() with only +initialized. Instead it returns %FALSE on failure. +This way the application can fall back to some other means of communication +with the user - for example a curses or command line interface. +%FALSE otherwise. + + %TRUE if the GUI has been successfully initialized, + + + + + Address of the <parameter>argc</parameter> parameter of your <function>main()</function> function. Changed if any arguments were handled. + + + + Address of the <parameter>argv</parameter> parameter of <function>main()</function>. Any parameters understood by gtk_gl_init() are stripped before return. + + + + + + + + Creates a new #GdkGLContext with the appropriate #GdkGLDrawable +for this widget. The GL context must be freed when you're +finished with it. See also gtk_widget_get_gl_context(). + + the new #GdkGLContext. + + + + + a #GtkWidget. + + + + the #GdkGLContext with which to share display lists and texture objects. NULL indicates that no sharing is to take place. + + + + whether rendering is to be done with a direct connection to the graphics system. + + + + GDK_GL_RGBA_TYPE or GDK_GL_COLOR_INDEX_TYPE (currently not used). + + + + + + Returns the #GdkGLConfig referred by the @widget. + + the #GdkGLConfig. + + + + + a #GtkWidget. + + + + + + Returns the #GdkGLContext with the appropriate #GdkGLDrawable +for this widget. Unlike the GL context returned by +gtk_widget_create_gl_context(), this context is owned by the widget. +#GdkGLContext is needed for the function gdk_gl_drawable_begin, +or for sharing display lists (see gtk_widget_set_gl_capability()). + + the #GdkGLContext. + + + + + a #GtkWidget. + + + + + + Returns the #GdkGLWindow owned by the @widget. + + the #GdkGLWindow. + + + + + a #GtkWidget. + + + + + + Returns whether the @widget is OpenGL-capable. + + TRUE if the @widget is OpenGL-capable, FALSE otherwise. + + + + + a #GtkWidget. + + + + + + Set the OpenGL-capability to the @widget. +This function prepares the widget for its use with OpenGL. + + TRUE if it is successful, FALSE otherwise. + + + + + the #GtkWidget to be used as the rendering area. + + + + a #GdkGLConfig. + + + + the #GdkGLContext with which to share display lists and texture objects. NULL indicates that no sharing is to take place. + + + + whether rendering is to be done with a direct connection to the graphics system. + + + + GDK_GL_RGBA_TYPE or GDK_GL_COLOR_INDEX_TYPE (currently not used). + + + + + + diff --git a/basis/gtk/gl/ffi/ffi.factor b/basis/gtk/gl/ffi/ffi.factor index 775537063b..e901c5bb2f 100644 --- a/basis/gtk/gl/ffi/ffi.factor +++ b/basis/gtk/gl/ffi/ffi.factor @@ -1,11 +1,16 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection gdk.ffi gdk.pixbuf.ffi gdk.gl.ffi gio.ffi -glib.ffi gmodule.ffi gobject.ffi gtk.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gtk.gl.ffi +<< +"gtk.ffi" require +"gdk.gl.ffi" require +>> + +LIBRARY: gtk.gl + << "gtk.gl" { { [ os winnt? ] [ drop ] } @@ -14,5 +19,4 @@ IN: gtk.gl.ffi } cond >> -GIR: vocab:gtk/gl/GtkGL-1.0.gir - +GIR: vocab:gtk/gl/GtkGLExt-1.0.gir diff --git a/basis/pango/Pango-1.0.gir b/basis/pango/Pango-1.0.gir index 06ce0e31f0..99ec659aeb 100644 --- a/basis/pango/Pango-1.0.gir +++ b/basis/pango/Pango-1.0.gir @@ -2,7 +2,7 @@ - @@ -15,15 +15,22 @@ and/or use gtk-doc annotations. --> - - - + c:identifier-prefixes="Pango" + c:symbol-prefixes="pango"> + + + + + + + + + - + - + - + - + - + - + - + + + - - + + + + + + + + + + + - + + + + + + + + + + - + + + + + + + + + + + + + @@ -93,26 +132,28 @@ and/or use gtk-doc annotations. --> - - - + + + - + - + - + @@ -121,7 +162,7 @@ and/or use gtk-doc annotations. --> - + @@ -131,134 +172,116 @@ and/or use gtk-doc annotations. --> - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - + - + introspectable="0"> + Copy a #PangoAttrIterator +be freed with pango_attr_iterator_destroy(). + + the newly allocated #PangoAttrIterator, which should - + + Destroy a #PangoAttrIterator and free all associated memory. + Find the current attribute of a particular type at the iterator location. When multiple attributes of the same type overlap, the attribute whose range starts closest to the current location is used. if no attribute of that type applies to the current -location."> - +location. + + the current attribute of the given type, or %NULL + the type of attribute to find. - - - - - - - - - - - - - - - - + Gets a list of all attributes at the current position of the iterator. all attributes for the current range. To free this value, call pango_attribute_destroy() on -each value and g_slist_free() on the list." - version="1.2"> - +each value and g_slist_free() on the list. + + a list of - + + + Get the font and other attributes at the current iterator position. + + + + + + a #PangoFontDescription to fill in with the current values. The family name in this structure will be set using pango_font_description_set_family_static() using values from an attribute in the #PangoAttrList associated with the iterator, so if you plan to keep it around, you must call: <literal>pango_font_description_set_family (desc, pango_font_description_get_family (desc))</literal>. + + + + if non-%NULL, location to store language tag for item, or %NULL if none is found. + + + + if non-%NULL, location in which to store a list of non-font attributes at the the current position; only the highest priority value of each attribute will be added to this list. In order to free this value, you must call pango_attribute_destroy() on each member. + + + + + + + + Advance the iterator until the next change of style. + + %FALSE if the iterator is at the end of the list, otherwise %TRUE + + + + + Get the range of the current segment. Note that the +stored return values are signed, not unsigned like +the values in #PangoAttribute. To deal with this API +oversight, stored return values that wouldn't fit into +a signed integer are clamped to %G_MAXINT. + + + + + + location to store the start of the range + + + + location to store the end of the range + + + + @@ -267,163 +290,149 @@ each value and g_slist_free() on the list." - - - - - - - - - - - + glib:get-type="pango_attr_list_get_type" + c:symbol-prefix="attr_list"> + + Create a new empty attribute list with a reference count of one. +be freed with pango_attr_list_unref(). + the newly allocated #PangoAttrList, which should - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Insert the given attribute into the #PangoAttrList. It will replace any attributes of the same type on that segment and be merged with any adjoining attributes that are identical. This function is slower than pango_attr_list_insert() for creating a attribute list in order (potentially much slower for large lists). However, pango_attr_list_insert() is not suitable for continually changing a set of attributes -since it never removes or combines existing attributes."> +since it never removes or combines existing attributes. + the attribute to insert. Ownership of this value is assumed by the list. - + Copy @list and return an identical new list. +reference count of one, which should +be freed with pango_attr_list_unref(). +Returns %NULL if @list was %NULL. + + the newly allocated #PangoAttrList, with a + + + + + Given a #PangoAttrList and callback function, removes any elements +of @list for which @func returns %TRUE and inserts them into +a new list. +no attributes of the given types were found. + + the new #PangoAttrList or %NULL if + + + + + callback function; returns %TRUE if an attribute should be filtered out. + + + + Data to be passed to @func + + + + + + Create a iterator initialized to the beginning of the list. +be freed with pango_attr_iterator_destroy(). + + the newly allocated #PangoAttrIterator, which should + + + + + Insert the given attribute into the #PangoAttrList. It will +be inserted after all other attributes with a matching + + + + + + the attribute to insert. Ownership of this value is assumed by the list. + + + + + + Insert the given attribute into the #PangoAttrList. It will +be inserted before all other attributes with a matching + + + + + + the attribute to insert. Ownership of this value is assumed by the list. + + + + + + Increase the reference count of the given attribute list by one. + + The attribute list passed in + + + + + This function opens up a hole in @list, fills it in with attributes from the left, and then merges @other on top of the hole. This operation is equivalent to stretching every attribute that applies at position @pos in @list by an amount @len, and then calling pango_attr_list_change() with a copy of each attribute in @other in sequence (offset in position by @pos). This operation proves useful for, for instance, inserting -a pre-edit string in the middle of an edit buffer."> +a pre-edit string in the middle of an edit buffer. + another #PangoAttrList - + the position in @list at which to insert @other + - + the length of the spliced segment. (Note that this must be specified since the attributes in @other may only be present at some subsection of this range) + - - - - - - - - - - - - - - - - + + Decrease the reference count of the given attribute list by one. +If the result is zero, free the attribute list and the attributes +it contains. + + @@ -438,107 +447,25 @@ be freed with pango_attr_iterator_destroy()."> - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + - - - - - - - - - - - - - - - - - - - - @@ -650,66 +577,67 @@ freed with pango_attribute_destroy()." - + - + - + Make a copy of an attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + Destroy a #PangoAttribute and free all associated memory. + + + + + + Compare two attributes for equality. This compares only the +actual value of the two attributes and not the ranges that the +attributes apply to. + + %TRUE if the two attributes have the same value. + + + + + another #PangoAttribute + + + + + + Initializes @attr's klass to @klass, +it's start_index to %PANGO_ATTR_INDEX_FROM_TEXT_BEGINNING and end_index to %PANGO_ATTR_INDEX_TO_TEXT_END such that the attribute applies -to the entire text by default." - version="1.20"> +to the entire text by default. + a #PangoAttributeClass - - - - - - - - - - - - - - - - - - - - + The #PangoBidiType type represents the bidirectional character +type of a Unicode character as specified by the +<ulink url="http://www.unicode.org/reports/tr9/">Unicode bidirectional algorithm</ulink>. + glib:get-type="pango_color_get_type" + c:symbol-prefix="color"> - + - + - + - + Creates a copy of @src, which should be freed with pango_color_free(). Primarily used by language bindings, not that useful otherwise (since colors can just be copied by assignment in C). be freed with pango_color_free(), or %NULL -if @src was %NULL."> +if @src was %NULL. + the newly allocated #PangoColor, which should - + + Frees a color allocated by pango_color_copy(). - + Fill in the fields of a color from a string specification. The string can either one of a large set of standard names. (Taken from the X11 <filename>rgb.txt</filename> file), or it can be a hex value in the -form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb' or '&num;rrrrggggbbbb' where -'r', 'g' and 'b' are hex digits of the red, green, and blue +form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb' or '&num;rrrrggggbbbb' where +'r', 'g' and 'b' are hex digits of the red, green, and blue components of the color, respectively. (White in the four -forms is '&num;fff' '&num;ffffff' '&num;fffffffff' and '&num;ffffffffffff') -otherwise false."> +forms is '&num;fff' '&num;ffffff' '&num;fffffffff' and '&num;ffffffffffff') +otherwise false. - + %TRUE if parsing of the specifier succeeded, + + a string specifying the new color + Returns a textual specification of @color in the hexadecimal form <literal>&num;rrrrggggbbbb</literal>, where <literal>r</literal>, <literal>g</literal> and <literal>b</literal> are hex digits representing -the red, green, and blue components respectively." - version="1.16"> +the red, green, and blue components respectively. + a newly-allocated text string that must be freed with g_free(). - + Creates a new #PangoContext initialized to default values. This function is not particularly useful as it should always be followed by a pango_context_set_font_map() call, and the function pango_font_map_create_context() does these two steps together and hence users are recommended to use that. If you are using Pango as part of a higher-level system, -that system may have it's own way of create a #PangoContext. +that system may have it's own way of create a #PangoContext. For instance, the GTK+ toolkit has, among others, gdk_pango_context_get_for_screen(), and gtk_widget_get_pango_context(). Use those instead. -be freed with g_object_unref()."> +be freed with g_object_unref(). + the newly allocated #PangoContext, which should - + + Retrieves the base direction for the context. See +pango_context_set_base_dir(). - + the base direction for the context. + + + + + Retrieves the base gravity for the context. See +pango_context_set_base_gravity(). + + the base gravity for the context. + + + + + Retrieve the default font description for the context. +This value must not be modified or freed. + + a pointer to the context's default font description. + - - - - - - + version="1.6" + introspectable="0"> + Gets the #PangoFontmap used to look up fonts for this context. +is owned by Pango and should not be unreferenced. + + the font map for the #PangoContext. This value - + + Retrieves the gravity for the context. This is similar to +pango_context_get_base_gravity(), except for when the base gravity +is %PANGO_GRAVITY_AUTO for which pango_gravity_get_for_matrix() is used +to return the gravity from the current context matrix. - + the resolved gravity for the context. + - - - - - - - - - + + Retrieves the gravity hint for the context. See +pango_context_set_gravity_hint() for details. + + the gravity hint for the context. + + + + + Retrieves the global language tag for the context. - + the global language tag. + - - - - - - - - + + Gets the transformation matrix that will be applied when +rendering with this context. See pango_context_set_matrix(). +(which is the same as the identity matrix). The returned +matrix is owned by Pango and must not be modified or +freed. + + the matrix, or %NULL if no matrix has been set + - - - - - - - - - + Get overall metric information for a particular font description. Since the metrics may be substantially different for different scripts, a language tag can be provided to indicate that the metrics should be retrieved that correspond to the script(s) @@ -961,273 +896,276 @@ list of figures. If characters from multiple of these families would be used to render the string, then the returned fonts would be a composite of the metrics for the fonts loaded for the individual families. -when finished using the object."> +when finished using the object. + a #PangoFontMetrics object. The caller must call pango_font_metrics_unref() + a #PangoFontDescription structure. %NULL means that the font description from the context will be used. + language tag used to determine which script to get the metrics for. %NULL means that the language tag from the context will be used. If no language tag is set on the context, metrics for the default language (as determined by pango_language_get_default()) will be returned. - + + List all families for a context. + + + location to store a pointer to an array of #PangoFontFamily *. This array should be freed with g_free(). + + + + location to store the number of elements in @descs + + + + + + Loads the font in one of the fontmaps in the context +that is the closest match for @desc. + + the font loaded, or %NULL if no font matched. + + + a #PangoFontDescription describing the font to load - - - - - - - - - - - - - + + Load a set of fonts in the context that can be used to render +a font matching @desc. + + the fontset, or %NULL if no font matched. + + + a #PangoFontDescription describing the fonts to load + + + a #PangoLanguage the fonts will be used for - + Sets the base direction for the context. The base direction is used in applying the Unicode bidirectional algorithm; if the @direction is %PANGO_DIRECTION_LTR or %PANGO_DIRECTION_RTL, then the value will be used as the paragraph direction in the Unicode bidirectional algorithm. A value of %PANGO_DIRECTION_WEAK_LTR or %PANGO_DIRECTION_WEAK_RTL is used only -for paragraphs that do not contain any strong characters themselves."> +for paragraphs that do not contain any strong characters themselves. + the new base direction - - - - - + Sets the base gravity for the context. +The base gravity is used in laying vertical text out. + the new base gravity - - - + + Set the default font description for the context + + + + + the new pango font description + + + - - - + + Sets the font map to be searched when fonts are looked-up in this context. +This is only for internal use by Pango backends, a #PangoContext obtained +via one of the recommended methods should already have a suitable font map. + + + + + the #PangoFontMap to set. + + + + Sets the gravity hint for the context. The gravity hint is used in laying vertical text out, and is only relevant if gravity of the context as returned by pango_context_get_gravity() -is set %PANGO_GRAVITY_EAST or %PANGO_GRAVITY_WEST." - version="1.16"> +is set %PANGO_GRAVITY_EAST or %PANGO_GRAVITY_WEST. + the new gravity hint - - - + + Sets the global language tag for the context. The default language +for the locale of the running process can be found using +pango_language_get_default(). + + + + + the new language tag. + + + + Sets the transformation matrix that will be applied when rendering with this context. Note that reported metrics are in the user space coordinates before the application of the matrix, not device-space -coordinates after the application of the matrix. So, they don't scale +coordinates after the application of the matrix. So, they don't scale with the matrix, though they may change slightly for different -matrices, depending on how the text is fit to the pixel grid." - version="1.6"> +matrices, depending on how the text is fit to the pixel grid. + a #PangoMatrix, or %NULL to unset any existing matrix. (No matrix set is the same as setting the identity matrix.) - - - - - - - - - - - - - - - - - - - - - + + Copy an existing #PangoCoverage. (This function may now be unnecessary since we refcount the structure. File a bug if you use it.) with a reference count of one, which -should be freed with pango_coverage_unref()."> - +should be freed with pango_coverage_unref(). + + the newly allocated #PangoCoverage, - - + + Determine whether a particular index is covered by @coverage + + the coverage level of @coverage for character @index_. - + the index to check + - - - - - - - - - - - - - - + Set the coverage for each index in @coverage to be the max (better) value of the current coverage for the index and the coverage for -the corresponding index in @other."> +the corresponding index in @other. + another #PangoCoverage - + + Increase the reference count on the #PangoCoverage by one + + @coverage + + + + + Modify a particular index within @coverage - - + + the index to modify + - - + + the new level for @index_ + + + Convert a #PangoCoverage structure into a flat binary format + + + + + + location to store result (must be freed with g_free()) + + + + location to store size of result + + + + + + Decrease the reference count on the #PangoCoverage by one. +If the result is zero, free the coverage and all associated memory. + + + + glib:nick="exact"/> + The #PangoDirection type represents a direction in the Unicode bidirectional algorithm; not every value in this enumeration makes sense for every usage of #PangoDirection; for example, the return value of pango_unichar_direction() and pango_find_base_dir() cannot be %PANGO_DIRECTION_WEAK_LTR or %PANGO_DIRECTION_WEAK_RTL, since every character is either neutral or has a strong direction; on the other hand -%PANGO_DIRECTION_NEUTRAL doesn't make sense to pass +%PANGO_DIRECTION_NEUTRAL doesn't make sense to pass to pango_itemize_with_base_dir(). The %PANGO_DIRECTION_TTB_LTR, %PANGO_DIRECTION_TTB_RTL values come from an earlier interpretation of this enumeration as the writing direction of a block of text and are no longer used; See #PangoGravity for how -vertical text is handled in Pango." - glib:type-name="PangoDirection" - glib:get-type="pango_direction_get_type" - c:type="PangoDirection"> +vertical text is handled in Pango. - + - + - + - + - - - + + Frees an array of font descriptions. + + - - + + a pointer to an array of #PangoFontDescription, may be %NULL + + + + number of font descriptions in @descs + - + Returns a description of the font, with font size set in points. Use pango_font_describe_with_absolute_size() if you want the font -size in device units."> +size in device units. + a newly-allocated #PangoFontDescription object. + Returns a description of the font, with absolute font size set +(in device units). Use pango_font_describe() if you want the font +size in points. + a newly-allocated #PangoFontDescription object. - - - - - - - - - - - + introspectable="0"> + Finds the best matching shaper for a font for a particular +language tag and character point. + + the best matching shaper. + the language tag - + a Unicode character. + - - - + + Computes the coverage map for a given font and language tag. + + a newly-allocated #PangoCoverage object. + + the language tag + + Gets the font map for which the font was created. +Note that the font maintains a <firstterm>weak</firstterm> reference +to the font map, so if all references to font map are dropped, the font +map will be finalized even if there are fonts created with the font +map that are still alive. In that case this function will return %NULL. +It is the responsibility of the user to ensure that the font map is kept +alive. In most uses this is not an issue as a #PangoContext holds +a reference to the font map. + + the #PangoFontMap for the font, or %NULL if @font is %NULL. + + + + Gets the logical and ink extents of a glyph within a font. The coordinate system for each rectangle has its origin at the base line and horizontal origin of the character with increasing coordinates extending to the right and down. The macros PANGO_ASCENT(), @@ -1438,411 +1372,61 @@ PANGO_DESCENT(), PANGO_LBEARING(), and PANGO_RBEARING() can be used to convert from the extents rectangle to more traditional font metrics. The units of the rectangles are in 1/PANGO_SCALE of a device unit. If @font is %NULL, this function gracefully sets some sane values in the -output variables and returns."> +output variables and returns. + the glyph index + rectangle used to store the extents of the glyph as drawn or %NULL to indicate that the result is not needed. + rectangle used to store the logical extents of the glyph or %NULL to indicate that the result is not needed. - + + Gets overall metric information for a font. Since the metrics may be +substantially different for different scripts, a language tag can +be provided to indicate that the metrics should be retrieved that +correspond to the script(s) used by that language. +If @font is %NULL, this function gracefully sets some sane values in the +output variables and returns. +when finished using the object. - + a #PangoFontMetrics object. The caller must call pango_font_metrics_unref() + + + + language tag used to determine which script to get the metrics for, or %NULL to indicate to get the metrics for the entire font. + + + - + glib:get-type="pango_font_description_get_type" + c:symbol-prefix="font_description"> + + Creates a new font description structure with all fields unset. +should be freed using pango_font_description_free(). + the newly allocated #PangoFontDescription, which - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Determines if the style attributes of @new_match are a closer match for @desc than those of @old_match are, or if @old_match is %NULL, determines if @new_match is a match at all. Approximate matching is done for @@ -1851,137 +1435,481 @@ Style attributes are all attributes other than family and size-related attributes. Approximate matching for style considers PANGO_STYLE_OBLIQUE and PANGO_STYLE_ITALIC as matches, but not as good a match as when the styles are equal. -Note that @old_match must match @desc."> +Note that @old_match must match @desc. - + %TRUE if @new_match is a better match + + a #PangoFontDescription, or %NULL + a #PangoFontDescription - + Make a copy of a #PangoFontDescription. +be freed with pango_font_description_free(), or %NULL +if @desc was %NULL. + + the newly allocated #PangoFontDescription, which should + + + + + Like pango_font_description_copy(), but only a shallow copy is made +of the family name and other allocated fields. The result can only +be used until @desc is modified or freed. This is meant to be used +when the copy is only needed temporarily. +be freed with pango_font_description_free(), or %NULL +if @desc was %NULL. + + the newly allocated #PangoFontDescription, which should + + + + + Compares two font descriptions for equality. Two font descriptions +are considered equal if the fonts they describe are provably identical. +This means that their masks do not have to match, as long as other fields +are all the same. (Two font descriptions may result in identical fonts +being loaded, but still compare %FALSE.) +%FALSE otherwise. + + %TRUE if the two font descriptions are identical, + + + + + another #PangoFontDescription + + + + + + Frees a font description. + + + + + + Gets the family name field of a font description. See +pango_font_description_set_family(). +%NULL if not previously set. This has the same life-time +as the font description itself and should not be freed. + + the family name field for the font description, or + + + + + Gets the gravity field of a font description. See +pango_font_description_set_gravity(). +pango_font_description_get_set_fields() to find out if +the field was explicitly set or not. + + the gravity field for the font description. Use + + + + + Determines which fields in a font description have been set. +fields in @desc that have been set. + + a bitmask with bits set corresponding to the + + + + + Gets the size field of a font description. +See pango_font_description_set_size(). +You must call pango_font_description_get_size_is_absolute() +to find out which is the case. Returns 0 if the size field has not +previously been set or it has been set to 0 explicitly. +Use pango_font_description_get_set_fields() to +find out if the field was explicitly set or not. + + the size field for the font description in points or device units. + + + + + Determines whether the size of the font is in points (not absolute) or device units (absolute). +See pango_font_description_set_size() and pango_font_description_set_absolute_size(). +points or device units. Use pango_font_description_get_set_fields() to +find out if the size field of the font description was explicitly set or not. + + whether the size for the font description is in + + + + + Gets the stretch field of a font description. +See pango_font_description_set_stretch(). +pango_font_description_get_set_fields() to find out if +the field was explicitly set or not. + + the stretch field for the font description. Use + + + + + Gets the style field of a #PangoFontDescription. See +pango_font_description_set_style(). +Use pango_font_description_get_set_fields() to find out if +the field was explicitly set or not. + + the style field for the font description. + + + + + Gets the variant field of a #PangoFontDescription. See +pango_font_description_set_variant(). +pango_font_description_get_set_fields() to find out if +the field was explicitly set or not. + + the variant field for the font description. Use + + + + + Gets the weight field of a font description. See +pango_font_description_set_weight(). +pango_font_description_get_set_fields() to find out if +the field was explicitly set or not. + + the weight field for the font description. Use + + + + + Computes a hash of a #PangoFontDescription structure suitable +to be used, for example, as an argument to g_hash_table_new(). +The hash value is independent of @desc->mask. + + the hash value. + + + + + Merges the fields that are set in @desc_to_merge into the fields in +are not already set are affected. If %TRUE, then fields that are +already set will be replaced as well. +If @desc_to_merge is %NULL, this function performs nothing. + + + + + + the #PangoFontDescription to merge from, or %NULL + + + + if %TRUE, replace fields in @desc with the corresponding values from @desc_to_merge, even if they are already exist. + + + + + + Like pango_font_description_merge(), but only a shallow copy is made +of the family name and other allocated fields. @desc can only be +used until @desc_to_merge is modified or freed. This is meant +to be used when the merged font description is only needed temporarily. + + + + + + the #PangoFontDescription to merge from + + + + if %TRUE, replace fields in @desc with the corresponding values from @desc_to_merge, even if they are already exist. + + + + + + Sets the size field of a font description, in device units. This is mutually +exclusive with pango_font_description_set_size() which sets the font size +in points. + + + + + + the new size, in Pango units. There are %PANGO_SCALE Pango units in one device unit. For an output backend where a device unit is a pixel, a @size value of 10 * PANGO_SCALE gives a 10 pixel font. + + + + + + Sets the family name field of a font description. The family +name represents a family of related font styles, and will +resolve to a particular #PangoFontFamily. In some uses of +#PangoFontDescription, it is also possible to use a comma +separated list of family names for this field. + + + + + + a string representing the family name. + + + + + + Like pango_font_description_set_family(), except that no +copy of @family is made. The caller must make sure that the +string passed in stays around until @desc has been freed +or the name is set again. This function can be used if +if @desc is only needed temporarily. + + + + + + a string representing the family name. + + + + + + Sets the gravity field of a font description. The gravity field +specifies how the glyphs should be rotated. If @gravity is +%PANGO_GRAVITY_AUTO, this actually unsets the gravity mask on +the font description. +This function is seldom useful to the user. Gravity should normally +be set on a #PangoContext. + + + + + + the gravity for the font description. + + + + + + Sets the size field of a font description in fractional points. This is mutually +exclusive with pango_font_description_set_absolute_size(). + + + + + + the size of the font in points, scaled by PANGO_SCALE. (That is, a @size value of 10 * PANGO_SCALE is a 10 point font. The conversion factor between points and device units depends on system configuration and the output device. For screen display, a logical DPI of 96 is common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3 pixel font. Use pango_font_description_set_absolute_size() if you need a particular size in device units. + + + + + + Sets the stretch field of a font description. The stretch field +specifies how narrow or wide the font should be. + + + + + + the stretch for the font description + + + + + + Sets the style field of a #PangoFontDescription. The +#PangoStyle enumeration describes whether the font is slanted and +the manner in which it is slanted; it can be either +#PANGO_STYLE_NORMAL, #PANGO_STYLE_ITALIC, or #PANGO_STYLE_OBLIQUE. +Most fonts will either have a italic style or an oblique +style, but not both, and font matching in Pango will +match italic specifications with oblique fonts and vice-versa +if an exact match is not found. + + + + + + the style for the font description + + + + + + Sets the variant field of a font description. The #PangoVariant +can either be %PANGO_VARIANT_NORMAL or %PANGO_VARIANT_SMALL_CAPS. + + + + + + the variant type for the font description. + + + + + + Sets the weight field of a font description. The weight field +specifies how bold or light the font should be. In addition +to the values of the #PangoWeight enumeration, other intermediate +numeric values are possible. + + + + + + the weight for the font description. + + + + + + Creates a filename representation of a font description. The +filename is identical to the result from calling +pango_font_description_to_string(), but with underscores instead of +characters that are untypical in filenames, and in lower case only. + + a new string that must be freed with g_free(). + + + + + Creates a string representation of a font description. See pango_font_description_from_string() for a description of the format of the string representation. The family list in the string description will only have a terminating comma if the -last word of the list is a valid style option."> +last word of the list is a valid style option. + a new string that must be freed with g_free(). - - - + + Unsets some of the fields in a #PangoFontDescription. The unset +fields will get back to their default values. + + + + + bitmask of fields in the @desc to unset. + + + - + Returns the family, style, variant, weight and stretch of a #PangoFontFace. The size field of the resulting font description will be unset. holding the description of the face. Use pango_font_description_free() -to free the result."> +to free the result. + a newly-created #PangoFontDescription structure + Gets a name representing the style of this face among the different faces in the #PangoFontFamily for the face. This name is unique among all faces in the family and is suitable for displaying to users. -owned by the face object and must not be modified or freed."> +owned by the face object and must not be modified or freed. + the face name for the face. This string is + + Returns whether a #PangoFontFace is synthesized by the underlying +font rendering engine from another face, perhaps by shearing, emboldening, +or lightening it. + + whether @face is synthesized. + + + + List the available sizes for a font. This is only applicable to bitmap +fonts. For scalable fonts, stores %NULL at the location pointed to by +are in Pango units and are sorted in ascending order. - - + + location to store a pointer to an array of int. This array should be freed with g_free(). + - - + + location to store the number of elements in @sizes + - - - - - - - - - - - - - - - - - - - + Gets the name of the family. The name is unique among all fonts for the font backend and can be used in a #PangoFontDescription to specify that a face from this family is desired. -by the family object and must not be modified or freed."> +by the family object and must not be modified or freed. + the name of the family. This string is owned + A monospace font is a font designed for text display where the the characters form a regular grid. For Western languages this would mean that the advance width of all characters are the same, but this categorization also includes Asian fonts which include @@ -1990,14 +1918,33 @@ character is typically double-width in a monospace font. The best way to find out the grid-cell size is to call pango_font_metrics_get_approximate_digit_width(), since the results of pango_font_metrics_get_approximate_char_width() may be affected -by double-width characters." - version="1.4"> +by double-width characters. - + %TRUE if the family is monospace. + + + Lists the different font faces that make up @family. The faces +in a family share a common design, but differ in slant, weight, +width and other aspects. + + + + + + location to store an array of pointers to #PangoFontFace objects, or %NULL. This array should be freed with g_free() when it is no longer needed. + + + + location to store number of elements in @faces. + + + + + Creates a #PangoContext connected to @fontmap. This is equivalent to pango_context_new() followed by pango_context_set_font_map(). If you are using Pango as part of a higher-level system, -that system may have it's own way of create a #PangoContext. +that system may have it's own way of create a #PangoContext. For instance, the GTK+ toolkit has, among others, gdk_pango_context_get_for_screen(), and gtk_widget_get_pango_context(). Use those instead. -be freed with g_object_unref()." - version="1.22"> - +be freed with g_object_unref(). + + the newly allocated #PangoContext, which should + + List all families for a fontmap. + + + + + + location to store a pointer to an array of #PangoFontFamily *. This array should be freed with g_free(). + + + + location to store the number of elements in @families + + + + - + introspectable="0"> + Load the font in the fontmap that is the closest match for @desc. + + the font loaded, or %NULL if no font matched. + the #PangoContext the font will be used with + a #PangoFontDescription describing the font to load - + introspectable="0"> + Load a set of fonts in the fontmap that can be used to render +a font matching @desc. + + the fontset, or %NULL if no font matched. + the #PangoContext the font will be used with + a #PangoFontDescription describing the font to load + a #PangoLanguage the fonts will be used for - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + glib:get-type="pango_font_metrics_get_type" + c:symbol-prefix="font_metrics"> + Gets the approximate character width for a font metrics structure. This is merely a representative value useful, for example, for determining the initial size for a window. Actual characters in -text will be wider and narrower than this."> +text will be wider and narrower than this. - + the character width, in Pango units. + + Gets the approximate digit width for a font metrics structure. This is merely a representative value useful, for example, for determining the initial size for a window. Actual digits in text can be wider or narrower than this, though this value is generally somewhat more accurate than the result of -pango_font_metrics_get_approximate_char_width() for digits."> +pango_font_metrics_get_approximate_char_width() for digits. - + the digit width, in Pango units. + - + + Gets the ascent from a font metrics structure. The ascent is +the distance from the baseline to the logical top of a line +of text. (The logical top may be above or below the top of the +actual drawn ink. It is necessary to lay out the text to figure +where the ink will be.) - + the ascent, in Pango units. + - + + Gets the descent from a font metrics structure. The descent is +the distance from the baseline to the logical bottom of a line +of text. (The logical bottom may be above or below the bottom of the +actual drawn ink. It is necessary to lay out the text to figure +where the ink will be.) - + the descent, in Pango units. + + Gets the suggested position to draw the strikethrough. +The value returned is the distance <emphasis>above</emphasis> the +baseline of the top of the strikethrough. - + the suggested strikethrough position, in Pango units. + + Gets the suggested thickness to draw for the strikethrough. - + the suggested strikethrough thickness, in Pango units. + + + + + Gets the suggested position to draw the underline. +The value returned is the distance <emphasis>above</emphasis> the +baseline of the top of the underline. Since most fonts have +underline positions beneath the baseline, this value is typically +negative. + + the suggested underline position, in Pango units. + + + + + Gets the suggested thickness to draw for the underline. + + the suggested underline thickness, in Pango units. + + + + + Increase the reference count of a font metrics structure by one. + + @metrics + + + + + Decrease the reference count of a font metrics structure by one. If +the result is zero, frees the structure and any associated +memory. + + - - - - - - - - - - - - - - - + version="1.4" + introspectable="0"> + Iterates through all the fonts in a fontset, calling @func for +each one. If @func returns %TRUE, that stops the iteration. - + + Callback function - + data to pass to the callback function + + + Returns the font in the fontset that contains the best glyph for the +Unicode character @wc. +with the font. + + a #PangoFont. The caller must call g_object_unref when finished + + + + + a Unicode character + + + + + + Get overall metric information for the fonts in the fontset. +when finished using the object. + + a #PangoFontMetrics object. The caller must call pango_font_metrics_unref() + + + - + @@ -2268,7 +2234,7 @@ each one. If @func returns %TRUE, that stops the iteration." - + @@ -2297,61 +2263,21 @@ each one. If @func returns %TRUE, that stops the iteration." + glib:get-type="pango_glyph_item_get_type" + c:symbol-prefix="glyph_item"> - - - - - - - - - - - - - - - - - - - - - - - + Splits a shaped item (PangoGlyphItem) into multiple items based on an attribute list. The idea is that if you have attributes -that don't affect shaping, such as color or underline, to avoid +that don't affect shaping, such as color or underline, to avoid affecting shaping, you filter them out (pango_attr_list_filter()), apply the shaping process and then reapply them to the result using this function. @@ -2363,69 +2289,107 @@ cases, it may happen that item->extra_attrs for some of the result items can have multiple attributes of the same type. This function takes ownership of @glyph_item; it will be reused as one of the elements in the list. -the list using g_slist_free()." - version="1.2"> - - +the list using g_slist_free(). + + a list of glyph items resulting from splitting + + + + text that @list applies to + a #PangoAttrList + + Make a deep copy of an existing #PangoGlyphItem structure. +be freed with pango_glyph_item_free(), or %NULL +if @orig was %NULL. + + the newly allocated #PangoGlyphItem, which should + + + + + Frees a #PangoGlyphItem and resources to which it points. + + + + + + Given a #PangoGlyphItem and the corresponding +text, determine the screen width corresponding to each character. When +multiple characters compose a single cluster, the width of the entire +cluster is divided equally among the characters. +See also pango_glyph_string_get_logical_widths(). + + + + + + text that @glyph_item corresponds to (glyph_item->item->offset is an offset from the start of @text) + + + + an array whose length is the number of characters in glyph_item (equal to glyph_item->item->num_chars) to be filled in with the resulting character widths. + + + + + Adds spacing between the graphemes of @glyph_item to +give the effect of typographic letter spacing. + text that @glyph_item corresponds to (glyph_item->item->offset is an offset from the start of @text) + logical attributes for the item (the first logical attribute refers to the position before the first character in the item) - + amount of letter spacing to add in Pango units. May be negative, though too large negative values will give ugly results. + - - - + + Modifies @orig to cover only the text after @split_index, and +returns a new item that covers the text before @split_index that +used to be in @orig. You can think of @split_index as the length of +the returned item. @split_index may not be 0, and it may not be +greater than or equal to the length of @orig (that is, there must +be at least one byte assigned to each item, you can't create a +zero-length item). +This function is similar in function to pango_item_split() (and uses +it internally.) +with pango_glyph_item_free(). + + the newly allocated item representing text before + + text to which positions in @orig apply - - + + byte index of position to split item, relative to the start of the item + @@ -2433,7 +2397,8 @@ See also pango_glyph_string_get_logical_widths()." + glib:get-type="pango_glyph_item_iter_get_type" + c:symbol-prefix="glyph_item_iter"> @@ -2441,326 +2406,346 @@ See also pango_glyph_string_get_logical_widths()." - + - + - + - + - + - + + Make a shallow copy of an existing #PangoGlyphItemIter structure. +be freed with pango_glyph_item_iter_free(), or %NULL +if @orig was %NULL. + the newly allocated #PangoGlyphItemIter, which should + Frees a #PangoGlyphItemIter created by pango_glyph_item_iter_copy(). - + Initializes a #PangoGlyphItemIter structure to point to the +last cluster in a glyph item. +See #PangoGlyphItemIter for details of cluster orders. - + %FALSE if there are no clusters in the glyph item + + the glyph item to iterate over + text corresponding to the glyph item - + Initializes a #PangoGlyphItemIter structure to point to the +first cluster in a glyph item. +See #PangoGlyphItemIter for details of cluster orders. - + %FALSE if there are no clusters in the glyph item + + the glyph item to iterate over + text corresponding to the glyph item + Advances the iterator to the next cluster in the glyph item. +See #PangoGlyphItemIter for details of cluster orders. +last cluster. - + %TRUE if the iterator was advanced, %FALSE if we were already on the + + Moves the iterator to the preceding cluster in the glyph item. +See #PangoGlyphItemIter for details of cluster orders. +first cluster. - + %TRUE if the iterator was moved, %FALSE if we were already on the + + glib:get-type="pango_glyph_string_get_type" + c:symbol-prefix="glyph_string"> - + - + - + - + + Create a new #PangoGlyphString. +should be freed with pango_glyph_string_free(). + the newly allocated #PangoGlyphString, which - - - - - - - - - - - + Copy a glyph string and associated storage. should be freed with pango_glyph_string_free(), -or %NULL if @string was %NULL."> +or %NULL if @string was %NULL. + the newly allocated #PangoGlyphString, which - - - - - - + Compute the logical and ink extents of a glyph string. See the documentation for pango_font_get_glyph_extents() for details about the interpretation -of the rectangles."> +of the rectangles. + a #PangoFont + rectangle used to store the extents of the glyph string as drawn or %NULL to indicate that the result is not needed. + rectangle used to store the logical extents of the glyph string or %NULL to indicate that the result is not needed. - - - - - + or %NULL to indicate that the result is not needed. or %NULL to indicate that the result is not needed. Computes the extents of a sub-portion of a glyph string. The extents are relative to the start of the glyph string range (the origin of their coordinate system is at the start of the range, not at the start of the entire -glyph string)."> +glyph string). - + start index + - + end index (the range is the set of bytes with + + a #PangoFont + rectangle used to store the extents of the glyph string range as drawn + rectangle used to store the logical extents of the glyph string range + + Free a glyph string and associated storage. + + + + + Given a #PangoGlyphString resulting from pango_shape() and the corresponding text, determine the screen width corresponding to each character. When multiple characters compose a single cluster, the width of the entire cluster is divided equally among the characters. -See also pango_glyph_item_get_logical_widths()."> +See also pango_glyph_item_get_logical_widths(). + the text corresponding to the glyphs - + the length of @text, in bytes + - + the embedding level of the string + - - + + an array whose length is the number of characters in text (equal to g_utf8_strlen (text, length) unless text has NUL bytes) to be filled in with the resulting character widths. + - + Computes the logical width of the glyph string as can also be computed +using pango_glyph_string_extents(). However, since this only computes the +width, it's much faster. This is in fact only a convenience function that +computes the sum of geometry.width for each glyph in the @glyphs. + + the logical width of the glyph string. + + + + + Converts from character position to x position. (X position is measured from the left edge of the run). Character positions -are computed by dividing up each cluster into equal portions."> +are computed by dividing up each cluster into equal portions. - + + the text for the run - - + + the number of bytes (not characters) in @text. + + the analysis information return from pango_itemize() - + the byte index within @text + - + whether we should compute the result for the beginning (%FALSE) or end (%TRUE) of the character. + - - + + location to store result + - + Resize a glyph string to the given length. + + + + + + the new length of the string. + + + + + + Convert from x offset to character position. Character positions are computed by dividing up each cluster into equal portions. In scripts where positioning within a cluster is not allowed (such as Thai), the returned value may not be a valid cursor position; the caller must combine the result with the logical -attributes for the text to compute the valid cursor position."> +attributes for the text to compute the valid cursor position. - + + the text for the run - - + + the number of bytes (not characters) in text. + + the analysis information return from pango_itemize() - + the x offset (in Pango units) + - - + + location to store calculated byte index within @text + - - + + location to store a boolean indicating whether the user clicked on the leading or trailing edge of the character. + - + + The #PangoGravity type represents the orientation of glyphs in a segment of text. This is useful when rendering vertical text layouts. In those situations, the layout is rotated using a non-identity PangoMatrix, and then glyph orientation is controlled using #PangoGravity. Not every value in this enumeration makes sense for every usage of #PangoGravity; for example, %PANGO_GRAVITY_AUTO only can be passed to pango_context_set_base_gravity() and can only be returned by -pango_context_get_base_gravity()." - version="1.16" - glib:type-name="PangoGravity" - glib:get-type="pango_gravity_get_type" - c:type="PangoGravity"> +pango_context_get_base_gravity(). + The #PangoGravityHint defines how horizontal scripts should behave in a +vertical context. That is, English excerpt in a vertical paragraph for +example. +See #PangoGravity. + glib:get-type="pango_item_get_type" + c:symbol-prefix="item"> - + - + - + - + + Creates a new #PangoItem structure initialized to default values. +be freed with pango_item_free(). + the newly allocated #PangoItem, which should - + + Copy an existing #PangoItem structure. +be freed with pango_item_free(), or %NULL if + the newly allocated #PangoItem, which should - + + Free a #PangoItem and all associated memory. - + Modifies @orig to cover only the text after @split_index, and returns a new item that covers the text before @split_index that used to be in @orig. You can think of @split_index as the length of the returned item. @split_index may not be 0, and it may not be greater than or equal to the length of @orig (that is, there must -be at least one byte assigned to each item, you can't create a +be at least one byte assigned to each item, you can't create a zero-length item). @split_offset is the length of the first item in chars, and must be provided because the text used to generate the -item isn't available, so pango_item_split() can't count the char +item isn't available, so pango_item_split() can't count the char length of the split items itself. -should be freed with pango_item_free()."> +should be freed with pango_item_free(). + new item representing text before @split_index, which - + byte index of position to split item, relative to the start of the item + - + number of chars between start of @orig and @split_index + @@ -2877,18 +2859,11 @@ should be freed with pango_item_free()."> - - - - - + glib:get-type="pango_language_get_type" + c:symbol-prefix="language"> + Get a string that is representative of the characters needed to render a particular language. The sample text may be a pangram, but is not necessarily. It is chosen to be demonstrative of normal text in the language, as well as exposing font @@ -2897,64 +2872,22 @@ as sample text in a font selection dialog. If @language is %NULL, the default language as found by pango_language_get_default() is used. If Pango does not have a sample string for @language, the classic -"The quick brown fox..." is returned. This can be detected by +"The quick brown fox..." is returned. This can be detected by comparing the returned pointer value to that returned for (non-existent) -language code "xx". That is, compare to: +language code "xx". That is, compare to: <informalexample><programlisting> -pango_language_get_sample_string (pango_language_from_string ("xx")) +pango_language_get_sample_string (pango_language_from_string ("xx")) </programlisting></informalexample> -and should not be freed."> +and should not be freed. + the sample string. This value is owned by Pango - - - - - - - - - - - - - - - - - - - - + Determines the scripts used to to write @language. If nothing is known about the language tag @language, or if @language is %NULL, then %NULL is returned. The list of scripts returned starts with the script that the @@ -2973,211 +2906,702 @@ number of entries in the array stored in @num_scripts, or %NULL if Pango does not have any information about this particular language tag (also the case if @language is %NULL). The returned array is owned by Pango and should not be modified -or freed." - version="1.22"> +or freed. + An array of #PangoScript values, with the - - + + location to return number of scripts, or %NULL + + + Determines if @script is one of the scripts used to +write @language. The returned value is conservative; +if nothing is known about the language tag @language, +%TRUE will be returned, since, as far as Pango knows, +This routine is used in Pango's itemization process when +determining if a supplied language tag is relevant to +a particular section of text. It probably is not useful for +applications in most circumstances. +This function uses pango_language_get_scripts() internally. +to write @language or if nothing is known about @language +(including the case that @language is %NULL), +%FALSE otherwise. + + %TRUE if @script is one of the scripts used + + + + + a #PangoScript + + + + + + Checks if a language tag matches one of the elements in a list of +language ranges. A language tag is considered to match a range +in the list if the range is '*', the range is exactly the tag, +or the range is a prefix of the tag, and the character after it +in the tag is '-'. + + %TRUE if a match was found. + + + + + a list of language ranges, separated by ';', ':', ',', or space characters. Each element must either be '*', or a RFC 3066 language range canonicalized as by pango_language_from_string() + + + + + + Gets the RFC-3066 format string representing the given language tag. +Pango and should not be freed. + + a string representing the language tag. This is owned by + + + - + Create a new #PangoLayout object with attributes initialized to default values for a particular #PangoContext. count of one, which should be freed with -g_object_unref()."> +g_object_unref(). + the newly allocated #PangoLayout, with a reference + a #PangoContext - + Forces recomputation of any state in the #PangoLayout that +might depend on the layout's context. This function should +be called if you make changes to the context subsequent +to creating the layout. + + + + + + Does a deep copy-by-value of the @src layout. The attribute list, tab array, and text from the original layout are all copied by value. count of one, which should be freed with -g_object_unref()."> - +g_object_unref(). + + the newly allocated #PangoLayout, with a reference + + positioned within the horizontal space available. + + the alignment. + + + + + Gets the attribute list for the layout, if any. + + a #PangoAttrList. + + + + + Gets whether to calculate the bidirectional base direction +for the layout according to the contents of the layout. +See pango_layout_set_auto_dir(). +is computed from the layout's contents, %FALSE otherwise. + + %TRUE if the bidirectional base direction + + + + + Gets the Y position of baseline of the first line in @layout. + + baseline of first line, from top of @layout. + + + + Retrieves the #PangoContext used for this layout. have an additional refcount added, so if you want to keep -a copy of this around, you must reference it yourself."> - +a copy of this around, you must reference it yourself. + + the #PangoContext for the layout. This does not - + + Given an index within a layout, determines the positions that of the +strong and weak cursors if the insertion point is at that +index. The position of each cursor is stored as a zero-width +rectangle. The strong cursor location is the location where +characters of the directionality equal to the base direction of the +layout are inserted. The weak cursor location is the location +where characters of the directionality opposite to the base +direction of the layout are inserted. - - + + the byte index of the cursor + + + + location to store the strong cursor position (may be %NULL) + + + + location to store the weak cursor position (may be %NULL) + - - - + + Gets the type of ellipsization being performed for @layout. +See pango_layout_set_ellipsize() +Use pango_layout_is_ellipsized() to query whether any paragraphs +were actually ellipsized. + + the current ellipsization mode for @layout. + - + + Computes the logical and ink extents of @layout. Logical extents +are usually what you want for positioning things. Note that both extents +may have non-zero x and y. You may want to use those to offset where you +render the layout. Not doing that is a very typical bug that shows up as +right-to-left layouts not being correctly positioned in a layout with +a set width. +The extents are given in layout coordinates and in Pango units; layout +coordinates begin at the top left corner of the layout. - - + + rectangle used to store the extents of the layout as drawn or %NULL to indicate that the result is not needed. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + rectangle used to store the logical extents of the layout + + Gets the font description for the layout, if any. +or %NULL if the font description from the layout's +context is inherited. This value is owned by the layout +and must not be modified or freed. + a pointer to the layout's font description, - + + Gets the height of layout used for ellipsization. See +pango_layout_set_height() for details. +number of lines if negative. + + the height, in Pango units if positive, or + + + + + Gets the paragraph indent width in Pango units. A negative value +indicates a hanging indentation. + + the indent in Pango units. + + + + + Returns an iterator to iterate over the visual extents of the layout. +pango_layout_iter_free(). + + the new #PangoLayoutIter that should be freed using + + + + + Gets whether each complete line should be stretched to fill the entire +width of the layout. + + the justify. + + + + + Retrieves a particular line from a #PangoLayout. +Use the faster pango_layout_get_line_readonly() if you do not plan +to modify the contents of the line (glyphs, glyph widths, etc.). +index is out of range. This layout line can +be ref'ed and retained, but will become invalid +if changes are made to the #PangoLayout. + + the requested #PangoLayoutLine, or %NULL if the + + + + + the index of a line, which must be between 0 and <literal>pango_layout_get_line_count(layout) - 1</literal>, inclusive. + + + + + + Retrieves the count of lines for the @layout. + + the line count. + + + + + Retrieves a particular line from a #PangoLayout. +This is a faster alternative to pango_layout_get_line(), +but the user is not expected +to modify the contents of the line (glyphs, glyph widths, etc.). +index is out of range. This layout line can +be ref'ed and retained, but will become invalid +if changes are made to the #PangoLayout. +No changes should be made to the line. + + the requested #PangoLayoutLine, or %NULL if the + + + + + the index of a line, which must be between 0 and <literal>pango_layout_get_line_count(layout) - 1</literal>, inclusive. + + + + + + Returns the lines of the @layout as a list. +Use the faster pango_layout_get_lines_readonly() if you do not plan +to modify the contents of the lines (glyphs, glyph widths, etc.). +the lines in the layout. This points to internal data of the #PangoLayout +and must be used with care. It will become invalid on any change to the layout's +text or properties. + + a #GSList containing + + + + + + + Returns the lines of the @layout as a list. +This is a faster alternative to pango_layout_get_lines(), +but the user is not expected +to modify the contents of the lines (glyphs, glyph widths, etc.). +the lines in the layout. This points to internal data of the #PangoLayout and +must be used with care. It will become invalid on any change to the layout's +text or properties. No changes should be made to the lines. + + a #GSList containing + + + + + + + Retrieves an array of logical attributes for each character in +the @layout. + + + + + + location to store a pointer to an array of logical attributes This value must be freed with g_free(). + + + + location to store the number of the attributes in the array. (The stored value will be one more than the total number of characters in the layout, since there need to be attributes corresponding to both the position before the first character and the position after the last character.) + + + + + + Computes the logical and ink extents of @layout in device units. +This function just calls pango_layout_get_extents() followed by +two pango_extents_to_pixels() calls, rounding @ink_rect and @logical_rect +such that the rounded rectangles fully contain the unrounded one (that is, +passes them as first argument to pango_extents_to_pixels()). + + + + + + rectangle used to store the extents of the layout as drawn or %NULL to indicate that the result is not needed. + + + + rectangle used to store the logical extents of the layout or %NULL to indicate that the result is not needed. + + + + + + Determines the logical width and height of a #PangoLayout +in device units. (pango_layout_get_size() returns the width +and height scaled by %PANGO_SCALE.) This +is simply a convenience function around +pango_layout_get_pixel_extents(). - + location to store the logical width, or %NULL + + + + location to store the logical height, or %NULL + - + + Obtains the value set by pango_layout_set_single_paragraph_mode(). +paragraph separator characters, %FALSE otherwise. - + %TRUE if the layout does not break paragraphs at + + + Determines the logical width and height of a #PangoLayout +in Pango units (device units scaled by %PANGO_SCALE). This +is simply a convenience function around pango_layout_get_extents(). + + + + + + location to store the logical width, or %NULL + + + + location to store the logical height, or %NULL + + + + + + Gets the amount of spacing between the lines of the layout. + + the spacing in Pango units. + + + + + Gets the current #PangoTabArray used by this layout. If no +#PangoTabArray has been set, then the default tabs are in use +and %NULL is returned. Default tabs are every 8 spaces. +The return value should be freed with pango_tab_array_free(). + + a copy of the tabs for this layout, or %NULL. + + + + + Gets the text in the layout. The returned text should not +be freed or modified. + + the text in the @layout. + + + + + Counts the number unknown glyphs in @layout. That is, zero if +glyphs for all characters in the layout text were found, or more +than zero otherwise. +This function can be used to determine if there are any fonts +available to render all characters in a certain string, or when +used in combination with %PANGO_ATTR_FALLBACK, to check if a +certain font supports all the characters in the string. + + The number of unknown glyphs in @layout. + + + + + Gets the width to which the lines of the #PangoLayout should wrap. + + the width in Pango units, or -1 if no width set. + + + + + Gets the wrap mode for the layout. +Use pango_layout_is_wrapped() to query whether any paragraphs +were actually wrapped. + + active wrap mode. + + + + + Converts from byte @index_ within the @layout to line and X position. +(X position is measured from the left edge of the line) + + + + + + the byte index of a grapheme within the layout. + + + + an integer indicating the edge of the grapheme to retrieve the position of. If 0, the trailing edge of the grapheme, if > 0, the leading of the grapheme. + + + + location to store resulting line index. (which will between 0 and pango_layout_get_line_count(layout) - 1) + + + + location to store resulting position within line (%PANGO_SCALE units per device unit) + + + + + + Converts from an index within a #PangoLayout to the onscreen position +corresponding to the grapheme at that index, which is represented +as rectangle. Note that <literal>pos->x</literal> is always the leading +edge of the grapheme and <literal>pos->x + pos->width</literal> the trailing +edge of the grapheme. If the directionality of the grapheme is right-to-left, +then <literal>pos->width</literal> will be negative. + + + + + + byte index within @layout + + + + rectangle in which to store the position of the grapheme + + + + + + Queries whether the layout had to ellipsize any paragraphs. +This returns %TRUE if the ellipsization mode for @layout +is not %PANGO_ELLIPSIZE_NONE, a positive width is set on @layout, +and there are paragraphs exceeding that width that have to be +ellipsized. +otherwise. + + %TRUE if any paragraphs had to be ellipsized, %FALSE + + + + + Queries whether the layout had to wrap any paragraphs. +This returns %TRUE if a positive width is set on @layout, +ellipsization mode of @layout is set to %PANGO_ELLIPSIZE_NONE, +and there are paragraphs exceeding the layout width that have +to be wrapped. +otherwise. + + %TRUE if any paragraphs had to be wrapped, %FALSE + + + + + Computes a new cursor position from an old position and +a count of positions to move visually. If @direction is positive, +then the new strong cursor position will be one position +to the right of the old cursor position. If @direction is negative, +then the new strong cursor position will be one position +to the left of the old cursor position. +In the presence of bidirectional text, the correspondence +between logical and visual order will depend on the direction +of the current run, and there may be jumps when the cursor +is moved off of the end of a run. +Motion here is in cursor positions, not in characters, so a +single call to pango_layout_move_cursor_visually() may move the +cursor over multiple characters when multiple characters combine +to form a single grapheme. + + + + + + whether the moving cursor is the strong cursor or the weak cursor. The strong cursor is the cursor corresponding to text insertion in the base direction for the layout. + + + + the byte index of the grapheme for the old index + + + + if 0, the cursor was at the trailing edge of the grapheme indicated by @old_index, if > 0, the cursor was at the leading edge. + + + + direction to move cursor. A negative value indicates motion to the left. + + + + location to store the new cursor byte index. A value of -1 indicates that the cursor has been moved off the beginning of the layout. A value of %G_MAXINT indicates that the cursor has been moved off the end of the layout. + + + + number of characters to move forward from the location returned for @new_index to get the position where the cursor should be displayed. This allows distinguishing the position at the beginning of one line from the position at the end of the preceding line. @new_index is always on the line where the cursor should be displayed. + + + + + + positioned within the horizontal space available. + + + + + + the alignment + + + + + + Sets the text attributes for a layout object. +References @attrs, so the caller can unref its reference. + + + + + + a #PangoAttrList, can be %NULL + + + + + + Sets whether to calculate the bidirectional base direction +for the layout according to the contents of the layout; +when this flag is on (the default), then paragraphs in +(Arabic and Hebrew principally), will have right-to-left +layout, paragraphs with letters from other scripts will +have left-to-right layout. Paragraphs with only neutral +characters get their direction from the surrounding paragraphs. +When %FALSE, the choice between left-to-right and +right-to-left layout is done according to the base direction +of the layout's #PangoContext. (See pango_context_set_base_dir()). +When the auto-computed direction of a paragraph differs from the +base direction of the context, the interpretation of +%PANGO_ALIGN_LEFT and %PANGO_ALIGN_RIGHT are swapped. + + + + + + if %TRUE, compute the bidirectional base direction from the layout's contents. + + + + + + Sets the type of ellipsization being performed for @layout. +Depending on the ellipsization mode @ellipsize text is +removed from the start, middle, or end of text so they +fit within the width and height of layout set with +pango_layout_set_width() and pango_layout_set_height(). +If the layout contains characters such as newlines that +force it to be layed out in multiple paragraphs, then whether +each paragraph is ellipsized separately or the entire layout +is ellipsized as a whole depends on the set height of the layout. +See pango_layout_set_height() for details. + + + + + + the new ellipsization mode for @layout + + + + + + Sets the default font description for the layout. If no font +description is set on the layout, the font description from +the layout's context is used. + + + + + + the new #PangoFontDescription, or %NULL to unset the current font description + + + + + Sets the height to which the #PangoLayout should be ellipsized at. There are two different behaviors, based on whether @height is positive or negative. If @height is positive, it will be the maximum height of the layout. Only @@ -3191,1044 +3615,625 @@ this value if the layout contains multiple paragraphs of text. The default value of -1 means that first line of each paragraph is ellipsized. This behvaior may be changed in the future to act per layout instead of per paragraph. File a bug against pango at <ulink -url="http://bugzilla.gnome.org/">http://bugzilla.gnome.org/</ulink> if your +url="http://bugzilla.gnome.org/">http://bugzilla.gnome.org/</ulink> if your code relies on this behavior. Height setting only has effect if a positive width is set on The behavior is undefined if a height other than -1 is set and ellipsization mode is set to %PANGO_ELLIPSIZE_NONE, and may change in the -future." - version="1.20"> +future. - + the desired height of the layout in Pango units if positive, or desired number of lines if negative. + - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - + Sets whether each complete line should be stretched to fill the entire width of the layout. This stretching is typically done by adding whitespace, but for some scripts (such as Arabic), the justification may be done in more complex ways, like extending the characters. Note that this setting is not implemented and so is ignored in Pango -older than 1.18."> +older than 1.18. - + whether the lines in the layout should be justified. + - - - - - - + + Same as pango_layout_set_markup_with_accel(), but +the markup text isn't scanned for accelerators. - - + + marked-up text + + + + length of marked-up text in bytes, or -1 if @markup is nul-terminated + - - - - - - + + Sets the layout text and attribute list from marked-up text (see +<link linkend="PangoMarkupFormat">markup format</link>). Replaces +the current text and attribute list. +If @accel_marker is nonzero, the given character will mark the +character following it as an accelerator. For example, @accel_marker +might be an ampersand or underscore. All characters marked +as an accelerator will receive a %PANGO_UNDERLINE_LOW attribute, +and the first character so marked will be returned in @accel_char. +Two @accel_marker characters following each other produce a single +literal @accel_marker character. - - + + marked-up text (see <link linkend="PangoMarkupFormat">markup format</link>) + + + + length of marked-up text in bytes, or -1 if @markup is nul-terminated + + + + marker for accelerators in the text + + + + return location for first located accelerator, or %NULL + - - - - - - - - - - - - - - - - - - - - + If @setting is %TRUE, do not treat newlines and similar characters as paragraph separators; instead, keep all text in a single paragraph, and display a glyph for paragraph separator characters. Used when -you want to allow editing of newlines on a single text line."> +you want to allow editing of newlines on a single text line. - + new setting + - - - - - - + + Sets the amount of spacing in Pango unit between the lines of the +layout. - - + + the amount of spacing + - - - - - - - - - - - - - - - - - - - - - + + Sets the tabs to use for @layout, overriding the default tabs +(by default, tabs are every 8 spaces). If @tabs is %NULL, the default +tabs are reinstated. @tabs is copied into the layout; you must +free your copy of @tabs yourself. - - - - - + + a #PangoTabArray, or %NULL + - + + Sets the text of the layout. +Note that if you have used +pango_layout_set_markup() or pango_layout_set_markup_with_accel() on +the attributes set on the layout from the markup as this function does not +clear attributes. - - + + a valid UTF-8 string + - - + + maximum length of @text, in bytes. -1 indicates that the string is nul-terminated and the length should be calculated. The text will also be truncated on encountering a nul-termination even when @length is positive. + - + + Sets the width to which the lines of the #PangoLayout should wrap or - - - - - - - - - - - + + the desired width in Pango units, or -1 to indicate that no wrapping or ellipsization should be performed. + - + + Sets the wrap mode; the wrap mode only has effect if a width +is set on the layout with pango_layout_set_width(). +To turn off wrapping, set the width to -1. - - - - - - - - + + the wrap mode + - - - - - - - - - - - - - - - - - - - - - - - - - - + Converts from X and Y position within a layout to the byte index to the character at that logical position. If the Y position is not inside the layout, the closest position is chosen (the position will be clamped inside the layout). If the X position is not within the layout, then the start or the end of the line is chosen as described for pango_layout_x_to_index(). If either the X or Y positions were not inside the layout, then the -function returns %FALSE; on an exact hit, it returns %TRUE."> +function returns %FALSE; on an exact hit, it returns %TRUE. - + %TRUE if the coordinates were inside text, %FALSE otherwise. + - + the X offset (in Pango units) from the left edge of the layout. + - + the Y offset (in Pango units) from the top edge of the layout + - - + + location to store calculated byte index + - - + + location to store a integer indicating where in the grapheme the user clicked. It will either be zero, or the number of characters in the grapheme. 0 represents the trailing edge of the grapheme. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + glib:get-type="pango_layout_iter_get_type" + c:symbol-prefix="layout_iter"> + + Determines whether @iter is on the last line of the layout. + + %TRUE if @iter is on the last line. + + + + + Copies a #PangLayoutIter. +be freed with pango_layout_iter_free(), or %NULL if + the newly allocated #PangoLayoutIter, which should - + + Frees an iterator that's no longer in use. - + + Gets the Y position of the current line's baseline, in layout +coordinates (origin at top left of the entire layout). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + baseline of current line. + + Gets the extents of the current character, in layout coordinates (origin is the top left of the entire layout). Only logical extents can sensibly be obtained for characters; ink extents make sense only -down to the level of clusters."> +down to the level of clusters. + rectangle to fill with logical extents + c:identifier="pango_layout_iter_get_cluster_extents"> + Gets the extents of the current cluster, in layout coordinates +(origin is the top left of the entire layout). + rectangle to fill with ink extents, or %NULL + rectangle to fill with logical extents, or %NULL - + + Gets the current byte index. Note that iterating forward by char +moves in visual order, not logical order, so indexes may not be +sequential. Also, the index may be equal to the length of the text +in the layout, if on the %NULL run (see pango_layout_iter_get_run()). + + current byte index. + + + + + Gets the layout associated with a #PangoLayoutIter. + + the layout associated with @iter. + + + + + Obtains the extents of the #PangoLayout being iterated +over. @ink_rect or @logical_rect can be %NULL if you +aren't interested in them. + rectangle to fill with ink extents, or %NULL + rectangle to fill with logical extents, or %NULL + + Gets the current line. +Use the faster pango_layout_iter_get_line_readonly() if you do not plan +to modify the contents of the line (glyphs, glyph widths, etc.). + + the current line. + + + + Obtains the extents of the current line. @ink_rect or @logical_rect +can be %NULL if you aren't interested in them. Extents are in layout coordinates (origin is the top-left corner of the entire #PangoLayout). Thus the extents returned by this function will be the same width/height but not at the same x/y as the extents -returned from pango_layout_line_get_extents()."> +returned from pango_layout_line_get_extents(). + rectangle to fill with ink extents, or %NULL + rectangle to fill with logical extents, or %NULL + + Gets the current line for read-only access. +This is a faster alternative to pango_layout_iter_get_line(), +but the user is not expected +to modify the contents of the line (glyphs, glyph widths, etc.). + + the current line, that should not be modified. + + + + Divides the vertical space in the #PangoLayout being iterated over between the lines in the layout, and returns the space belonging to -the current line. A line's range includes the line's logical +the current line. A line's range includes the line's logical extents, plus half of the spacing above and below the line, if pango_layout_set_spacing() has been called to set layout spacing. The Y positions are in layout coordinates (origin at top left of the -entire layout)."> +entire layout). - - + + start of line + - - + + end of line + - + + Gets the current run. When iterating by run, at the end of each +line, there's a position with a %NULL run, so this function can return +%NULL. The %NULL run at the end of each line ensures that all lines have +at least one run, even lines consisting of only a newline. +Use the faster pango_layout_iter_get_run_readonly() if you do not plan +to modify the contents of the run (glyphs, glyph widths, etc.). + + the current run. + + + + + Gets the extents of the current run in layout coordinates +(origin is the top left of the entire layout). + rectangle to fill with ink extents, or %NULL + rectangle to fill with logical extents, or %NULL - + + Gets the current run. When iterating by run, at the end of each +line, there's a position with a %NULL run, so this function can return +%NULL. The %NULL run at the end of each line ensures that all lines have +at least one run, even lines consisting of only a newline. +This is a faster alternative to pango_layout_iter_get_run(), +but the user is not expected +to modify the contents of the run (glyphs, glyph widths, etc.). + + the current run, that should not be modified. + + + + + Moves @iter forward to the next character in visual order. If @iter was already at +the end of the layout, returns %FALSE. - + whether motion was possible. + + + + + Moves @iter forward to the next cluster in visual order. If @iter +was already at the end of the layout, returns %FALSE. + + whether motion was possible. + + + + + Moves @iter forward to the start of the next line. If @iter is +already on the last line, returns %FALSE. + + whether motion was possible. + + + + + Moves @iter forward to the next run in visual order. If @iter was +already at the end of the layout, returns %FALSE. + + whether motion was possible. + + glib:get-type="pango_layout_line_get_type" + c:symbol-prefix="layout_line"> - + - + - + + + - + - + - + + Computes the logical and ink extents of a layout line. See +pango_font_get_glyph_extents() for details about the interpretation +of the rectangles. + + + + + + rectangle used to store the extents of the glyph string as drawn, or %NULL + + + + rectangle used to store the logical extents of the glyph string, or %NULL + + + + + + Computes the logical and ink extents of @layout_line in device units. +This function just calls pango_layout_line_get_extents() followed by +two pango_extents_to_pixels() calls, rounding @ink_rect and @logical_rect +such that the rounded rectangles fully contain the unrounded one (that is, +passes them as first argument to pango_extents_to_pixels()). + + + + + + rectangle used to store the extents of the glyph string as drawn, or %NULL + + + + rectangle used to store the logical extents of the glyph string, or %NULL + + + + + + Gets a list of visual ranges corresponding to a given logical range. +This list is not necessarily minimal - there may be consecutive +ranges which are adjacent. The ranges will be sorted from left to +right. The ranges are with respect to the left edge of the entire +layout, not with respect to the line. + + + + + + Start byte index of the logical range. If this value is less than the start index for the line, then the first range will extend all the way to the leading edge of the layout. Otherwise it will start at the leading edge of the first character. + + + + Ending byte index of the logical range. If this value is greater than the end index for the line, then the last range will extend all the way to the trailing edge of the layout. Otherwise, it will end at the trailing edge of the last character. + + + + location to store a pointer to an array of ranges. The array will be of length <literal>2*n_ranges</literal>, with each range starting at <literal>(*ranges)[2*n]</literal> and of width <literal>(*ranges)[2*n + 1] - (*ranges)[2*n]</literal>. This array must be freed with g_free(). The coordinates are relative to the layout and are in Pango units. + + + + + + The number of ranges stored in @ranges. + + + + + + Converts an index within a line to a X position. + + + + + + byte offset of a grapheme within the layout + + + + an integer indicating the edge of the grapheme to retrieve the position of. If > 0, the trailing edge of the grapheme, if 0, the leading of the grapheme. + + + + location to store the x_offset (in Pango unit) + + + + + + Increase the reference count of a #PangoLayoutLine by one. + the line passed in. - + Decrease the reference count of a #PangoLayoutLine by one. If the result is zero, the line and all associated memory -will be freed."> +will be freed. - + Converts from x offset to the byte index of the corresponding character within the text of the layout. If @x_pos is outside the line, in the line. This determination is based on the resolved direction of the paragraph; for example, if the resolved direction is @@ -4236,298 +4241,176 @@ right-to-left, then an X position to the right of the line (after it) results in 0 being stored in @index_ and @trailing. An X position to the left of the line results in @index_ pointing to the (logical) last grapheme in the line and @trailing being set to the number of characters -in that grapheme. The reverse is true for a left-to-right line."> +in that grapheme. The reverse is true for a left-to-right line. - + %FALSE if @x_pos was outside the line, %TRUE if inside + - + the X offset (in Pango units) from the left edge of the line. + - - - - - - - - - - - - - - + location to store calculated byte index for the grapheme in which the user clicked. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + location to store an integer indicating where in the grapheme the user clicked. It will either be zero, or the number of characters in the grapheme. 0 represents the leading edge of the grapheme. + - + - + - + - + - + - + - + - + - + - + - + - + - + + A structure specifying a transformation between user-space coordinates and device coordinates. The transformation is given by <programlisting> x_device = x_user * matrix->xx + y_user * matrix->xy + matrix->x0; y_device = x_user * matrix->yx + y_user * matrix->yy + matrix->y0; -</programlisting>" - version="1.6" - glib:type-name="PangoMatrix" - glib:get-type="pango_matrix_get_type"> +</programlisting> - + - + - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Changes the transformation represented by @matrix to be the transformation given by first applying transformation -given by @new_matrix then applying the original transformation." - version="1.6"> +given by @new_matrix then applying the original transformation. + a #PangoMatrix - + + Copies a #PangoMatrix. +be freed with pango_matrix_free(), or %NULL if + + the newly allocated #PangoMatrix, which should + + + + + Free a #PangoMatrix created with pango_matrix_copy(). + + + + + + Returns the scale factor of a matrix on the height of the font. +That is, the scale factor in the direction perpendicular to the +vector that the X coordinate is mapped to. +or 1.0 if @matrix is %NULL. + + the scale factor of @matrix on the height of the font, + + + + + Changes the transformation represented by @matrix to be the +transformation given by first rotating by @degrees degrees +counter-clockwise then applying the original transformation. - - + + degrees to rotate counter-clockwise + - - + + + + Changes the transformation represented by @matrix to be the +transformation given by first scaling by @sx in the X direction +and @sy in the Y direction then applying the original +transformation. + + + + + + amount to scale by in X direction + + + + amount to scale by in Y direction + + Transforms the distance vector (@dx,@dy) by @matrix. This is similar to pango_matrix_transform_point() except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows: @@ -4538,23 +4421,64 @@ dy2 = dx1 * yx + dy1 * yy; Affine transformations are position invariant, so the same vector always transforms to the same vector. If (@x1,@y1) transforms to (@x2,@y2) then (@x1+@dx1,@y1+@dy1) will transform to -(@x1+@dx2,@y1+@dy2) for all values of @x1 and @x2." - version="1.16"> +(@x1+@dx2,@y1+@dy2) for all values of @x1 and @x2. - - + + in/out X component of a distance vector + - - + + yn/out Y component of a distance vector + + + + + + First transforms the @rect using @matrix, then calculates the bounding box +of the transformed rectangle. The rectangle should be in device units +(pixels). +This function is useful for example when you want to draw a rotated +should be and how much you should shift the layout when rendering. +For better accuracy, you should use pango_matrix_transform_rectangle() on +original rectangle in Pango units and convert to pixels afterward +using pango_extents_to_pixels()'s first argument. + + + + + + in/out bounding box in device units, or %NULL + + + + + + Transforms the point (@x, @y) by @matrix. + + + + + + in/out X position + + + + in/out Y position + + First transforms @rect using @matrix, then calculates the bounding box of the transformed rectangle. The rectangle should be in Pango units. This function is useful for example when you want to draw a rotated should be and how much you should shift the layout when rendering. @@ -4567,81 +4491,62 @@ first argument, for an inclusive rounded rectangle. However, there are valid reasons that you may want to convert to pixels first and then transform, for example when the transformed coordinates may overflow in Pango units (large matrix translation for -example)." - version="1.16"> +example). + in/out bounding box in Pango units, or %NULL - + + Changes the transformation represented by @matrix to be the +transformation given by first translating by (@tx, @ty) +then applying the original transformation. - - + + amount to translate in the X direction + + + + amount to translate in the Y direction + - - - - - - - - - - - - - - + - + - + - + - + + #PangoRenderPart defines different items to render for such +purposes as setting colors. - + #PangoRenderer is a base class for objects that are used to +render Pango objects such as #PangoGlyphString and +#PangoLayout. + + + + + + + Draw a squiggly line that approximately covers the given rectangle +in the style of an underline used to indicate a spelling error. +(The width of the underline is rounded to an integer number +of up/down segments and the resulting rectangle is centered +in the original rectangle) +This should be called while @renderer is already active. Use +pango_renderer_activate() to activate a renderer. + + + + + + X coordinate of underline, in Pango units in user coordinate system + + + + Y coordinate of underline, in Pango units in user coordinate system + + + + width of underline, in Pango units in user coordinate system + + + + height of underline, in Pango units in user coordinate system + + + + + + Draws a single glyph with coordinates in device space. + a #PangoFont - - + + the glyph index of a single glyph + - + X coordinate of left edge of baseline of glyph + - + Y coordinate of left edge of baseline of glyph + - + + Draws the glyphs in @glyph_item with the specified #PangoRenderer, +embedding the text associated with the glyphs in the output if the +output format supports it (PDF for example). +Note that @text is the start of the text for layout, which is then +indexed by <literal>@glyph_item->item->offset</literal>. +If @text is %NULL, this simply calls pango_renderer_draw_glyphs(). +The default implementation of this method simply falls back to +pango_renderer_draw_glyphs(). + + + + + + the UTF-8 text that @glyph_item refers to, or %NULL + + + + a #PangoGlyphItem + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws the glyphs in @glyphs with the specified #PangoRenderer. + + + + + + a #PangoFont + + + + a #PangoGlyphString + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws an axis-aligned rectangle in user space coordinates with the +specified #PangoRenderer. +This should be called while @renderer is already active. Use +pango_renderer_activate() to activate a renderer. + type of object this rectangle is part of - + X position at which to draw rectangle, in user space coordinates in Pango units + - + Y position at which to draw rectangle, in user space coordinates in Pango units + - + width of rectangle in Pango units in user space coordinates + - - - - - - - - - - - - - - - - - - - - + height of rectangle in Pango units in user space coordinates + @@ -4741,80 +4736,79 @@ render Pango objects such as #PangoGlyphString and - + - + - + + Draws a trapezoid with the parallel sides aligned with the X axis +using the given #PangoRenderer; coordinates are in device space. + type of object this trapezoid is part of - + Y coordinate of top of trapezoid + - + X coordinate of left end of top of trapezoid + - + X coordinate of right end of top of trapezoid + - + Y coordinate of bottom of trapezoid + - + X coordinate of left end of bottom of trapezoid + - + X coordinate of right end of bottom of trapezoid + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Informs Pango that the way that the rendering is done +for @part has changed in a way that would prevent multiple +pieces being joined together into one drawing call. For +instance, if a subclass of #PangoRenderer was to add a stipple +option for drawing underlines, it needs to call +<informalexample><programlisting> +pango_renderer_part_changed (render, PANGO_RENDER_PART_UNDERLINE); +</programlisting></informalexample> +When the stipple changes or underlines with different stipples +might be joined together. Pango automatically calls this for +changes to colors. (See pango_renderer_set_color()) + + + + + + the part for which rendering has changed. + + + + @@ -4825,258 +4819,325 @@ render Pango objects such as #PangoGlyphString and - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Does initial setup before rendering operations on @renderer. pango_renderer_deactivate() should be called when done drawing. Calls such as pango_renderer_draw_layout() automatically activate the layout before drawing on it. Calls to pango_renderer_activate() and pango_renderer_deactivate() can be nested and the renderer will only be initialized and -deinitialized once." - version="1.8"> +deinitialized once. + Cleans up after rendering operations on @renderer. See +docs for pango_renderer_activate(). + + Draw a squiggly line that approximately covers the given rectangle +in the style of an underline used to indicate a spelling error. +(The width of the underline is rounded to an integer number +of up/down segments and the resulting rectangle is centered +in the original rectangle) +This should be called while @renderer is already active. Use +pango_renderer_activate() to activate a renderer. + + + + + + X coordinate of underline, in Pango units in user coordinate system + + + + Y coordinate of underline, in Pango units in user coordinate system + + + + width of underline, in Pango units in user coordinate system + + + + height of underline, in Pango units in user coordinate system + + + + + + Draws a single glyph with coordinates in device space. + + + + + + a #PangoFont + + + + the glyph index of a single glyph + + + + X coordinate of left edge of baseline of glyph + + + + Y coordinate of left edge of baseline of glyph + + + + + + Draws the glyphs in @glyph_item with the specified #PangoRenderer, +embedding the text associated with the glyphs in the output if the +output format supports it (PDF for example). +Note that @text is the start of the text for layout, which is then +indexed by <literal>@glyph_item->item->offset</literal>. +If @text is %NULL, this simply calls pango_renderer_draw_glyphs(). +The default implementation of this method simply falls back to +pango_renderer_draw_glyphs(). + + + + + + the UTF-8 text that @glyph_item refers to, or %NULL + + + + a #PangoGlyphItem + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws the glyphs in @glyphs with the specified #PangoRenderer. + + + + + + a #PangoFont + + + + a #PangoGlyphString + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws @layout with the specified #PangoRenderer. + + + + + + a #PangoLayout + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws @line with the specified #PangoRenderer. + + + + + + a #PangoLayoutLine + + + + X position of left edge of baseline, in user space coordinates in Pango units. + + + + Y position of left edge of baseline, in user space coordinates in Pango units. + + + + + + Draws an axis-aligned rectangle in user space coordinates with the +specified #PangoRenderer. +This should be called while @renderer is already active. Use +pango_renderer_activate() to activate a renderer. + + + + + + type of object this rectangle is part of + + + + X position at which to draw rectangle, in user space coordinates in Pango units + + + + Y position at which to draw rectangle, in user space coordinates in Pango units + + + + width of rectangle in Pango units in user space coordinates + + + + height of rectangle in Pango units in user space coordinates + + + + + + Draws a trapezoid with the parallel sides aligned with the X axis +using the given #PangoRenderer; coordinates are in device space. + + + + + + type of object this trapezoid is part of + + + + Y coordinate of top of trapezoid + + + + X coordinate of left end of top of trapezoid + + + + X coordinate of right end of top of trapezoid + + + + Y coordinate of bottom of trapezoid + + + + X coordinate of left end of bottom of trapezoid + + + + X coordinate of right end of bottom of trapezoid + + + + + + Gets the current rendering color for the specified part. +if it hasn't been set and should be inherited from the +environment. + + the color for the specified part, or %NULL + + + + + the part to get the color for + + + + + + Gets the layout currently being rendered using @renderer. +Calling this function only makes sense from inside a subclass's +methods, like in its draw_shape<!---->() for example. +The returned layout should not be modified while still being +rendered. +rendered using @renderer at this time. + + the layout, or %NULL if no layout is being + + + + + Gets the layout line currently being rendered using @renderer. +Calling this function only makes sense from inside a subclass's +methods, like in its draw_shape<!---->() for example. +The returned layout line should not be modified while still being +rendered. +rendered using @renderer at this time. + + the layout line, or %NULL if no layout line is being + + + + + Gets the transformation matrix that will be applied when +rendering. See pango_renderer_set_matrix(). +(which is the same as the identity matrix). The returned +matrix is owned by Pango and must not be modified or +freed. + + the matrix, or %NULL if no matrix has been set + + + + Informs Pango that the way that the rendering is done for @part has changed in a way that would prevent multiple pieces being joined together into one drawing call. For instance, if a subclass of #PangoRenderer was to add a stipple @@ -5086,100 +5147,49 @@ pango_renderer_part_changed (render, PANGO_RENDER_PART_UNDERLINE); </programlisting></informalexample> When the stipple changes or underlines with different stipples might be joined together. Pango automatically calls this for -changes to colors. (See pango_renderer_set_color())" - version="1.8"> +changes to colors. (See pango_renderer_set_color()) + the part for which rendering has changed. + Sets the color for part of the rendering. + the part to change the color of + the new color or %NULL to unset the current color - - - - - - - - - - + Sets the transformation matrix that will be applied when rendering. + a #PangoMatrix, or %NULL to unset any existing matrix. (No matrix set is the same as setting the identity matrix.) - - - - - - - - - - - - - - - @@ -5187,10 +5197,10 @@ rendered using @renderer at this time." - + - + @@ -5202,17 +5212,13 @@ rendered using @renderer at this time." + Class structure for #PangoRenderer. - + @@ -5221,22 +5227,26 @@ Class structure for #PangoRenderer." + a #PangoFont + a #PangoGlyphString - + X position of left edge of baseline, in user space coordinates in Pango units. + - + Y position of left edge of baseline, in user space coordinates in Pango units. + - + @@ -5245,25 +5255,30 @@ Class structure for #PangoRenderer." + type of object this rectangle is part of - + X position at which to draw rectangle, in user space coordinates in Pango units + - + Y position at which to draw rectangle, in user space coordinates in Pango units + - + width of rectangle in Pango units in user space coordinates + - + height of rectangle in Pango units in user space coordinates + - + @@ -5272,22 +5287,26 @@ Class structure for #PangoRenderer." - + X coordinate of underline, in Pango units in user coordinate system + - + Y coordinate of underline, in Pango units in user coordinate system + - + width of underline, in Pango units in user coordinate system + - + height of underline, in Pango units in user coordinate system + - + @@ -5299,16 +5318,16 @@ Class structure for #PangoRenderer." - + - + - + @@ -5317,31 +5336,38 @@ Class structure for #PangoRenderer." + type of object this trapezoid is part of - + Y coordinate of top of trapezoid + - + X coordinate of left end of top of trapezoid + - + X coordinate of right end of top of trapezoid + - + Y coordinate of bottom of trapezoid + - + X coordinate of left end of bottom of trapezoid + - + X coordinate of right end of bottom of trapezoid + - + @@ -5350,22 +5376,26 @@ Class structure for #PangoRenderer." + a #PangoFont + the glyph index of a single glyph - + X coordinate of left edge of baseline of glyph + - + Y coordinate of left edge of baseline of glyph + - + @@ -5374,13 +5404,14 @@ Class structure for #PangoRenderer." + the part for which rendering has changed. - + @@ -5392,7 +5423,7 @@ Class structure for #PangoRenderer." - + @@ -5404,7 +5435,7 @@ Class structure for #PangoRenderer." - + @@ -5419,7 +5450,7 @@ Class structure for #PangoRenderer." - + @@ -5428,46 +5459,50 @@ Class structure for #PangoRenderer." + the UTF-8 text that @glyph_item refers to, or %NULL + a #PangoGlyphItem - + X position of left edge of baseline, in user space coordinates in Pango units. + - + Y position of left edge of baseline, in user space coordinates in Pango units. + - - + + - - + + - - + + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + A #PangoScriptIter is used to iterate through a string +and identify ranges in different scripts. + + Frees a #PangoScriptIter created with pango_script_iter_new(). + + - - - - - - - - - + + Gets information about the range to which @iter currently points. +The range is the set of locations p where *start <= p < *end. +(That is, it doesn't include the character stored at *end) - - - + location to store start position of the range, or %NULL + - - - + location to store end position of the range, or %NULL + + location to store script for range, or %NULL - + Advances a #PangoScriptIter to the next range. If @iter is already at the end, it is left unchanged and %FALSE -is returned." - version="1.4"> +is returned. - - - - - - + %TRUE if @iter was successfully advanced. + @@ -5937,10 +5910,10 @@ is returned." glib:nick="ultra-expanded"/> + An enumeration specifying the various slant styles possible for a font. - + + Creates an array of @initial_size tab stops. Tab stops are specified in pixel units if @positions_in_pixels is %TRUE, otherwise in Pango units. All stops are initially at position 0. -be freed with pango_tab_array_free()."> +be freed with pango_tab_array_free(). + the newly allocated #PangoTabArray, which should - + Initial number of tab stops to allocate, can be 0 + - + whether positions are in pixel units + + This is a convenience function that creates a #PangoTabArray and allows you to specify the alignment and position of each tab stop. You <emphasis>must</emphasis> provide an alignment and position for @size tab stops. -be freed with pango_tab_array_free()."> +be freed with pango_tab_array_free(). + the newly allocated #PangoTabArray, which should - + number of tab stops in the array + - + whether positions are in pixel units + + alignment of first tab stop - + position of first tab stop + @@ -6014,111 +5996,114 @@ be freed with pango_tab_array_free()."> - + + Copies a #PangoTabArray +be freed with pango_tab_array_free(). + the newly allocated #PangoTabArray, which should - + + Frees a tab array and associated resources. - + + Returns %TRUE if the tab positions are in pixels, %FALSE if they are +in Pango units. - + whether positions are in pixels. + - + + Gets the number of tab stops in @tab_array. - + the number of tab stops in the array. + - - - - - - + + Gets the alignment and position of a tab stop. - - - - - - - - - - - - - - - - - + tab stop index + + location to store alignment, or %NULL - - + + location to store tab position, or %NULL + - + If non-%NULL, @alignments and @locations are filled with allocated arrays of length pango_tab_array_get_size(). You must free the -returned array."> +returned array. + location to store an array of tab stop alignments, or %NULL - - + + location to store an array of tab positions, or %NULL + - + + Resizes a tab array. You must subsequently initialize any tabs that +were added as a result of growing the array. - + + + + new size of the array + + + + + + Sets the alignment and location of a tab stop. +implementation. + + + + + + the index of a tab stop + + + + tab alignment + + + + tab location in Pango units + + + - + - + c:identifier="PANGO_WRAP_WORD_CHAR" glib:nick="word-char"/> + + + + + + + + + + + + - + introspectable="0"> + Create a new background color attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + the red value (ranging from 0 to 65535) + - + the green value + - + the blue value + + Create a new font fallback attribute. If fallback is disabled, characters will only be used from the closest matching font on the system. No fallback will be done to other fonts on the system that might contain the characters in the text. -freed with pango_attribute_destroy()." - version="1.4"> - +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + %TRUE if we should fall back on other fonts for characters the active font is missing. + - + introspectable="0"> + Create a new font family attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the family or comma separated list of families + + Create a new font description attribute. This attribute +allows setting family, style, weight, variant, stretch, +and size simultaneously. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + the font description + + + + - + introspectable="0"> + Create a new foreground color attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + the red value (ranging from 0 to 65535) + - + the green value + - + the blue value + - + version="1.16" + introspectable="0"> + Create a new gravity hint attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the gravity hint value. - + version="1.16" + introspectable="0"> + Create a new gravity attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the gravity value; should not be %PANGO_GRAVITY_AUTO. + + Create a new language tag attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + language tag + + + + - + version="1.6" + introspectable="0"> + Create a new letter-spacing attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + amount of extra space to add between graphemes of the text, in Pango units. + - + introspectable="0"> + Create a new baseline displacement attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + the amount that the text should be displaced vertically, in Pango units. Positive values displace the text upwards. + + Create a new font size scale attribute. The base font for the affected text will have its size multiplied by @scale_factor. -freed with pango_attribute_destroy()."> - +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + factor to scale the font + + + + + + Create a new shape attribute. A shape is used to impose a +particular ink and logical rectangle on the result of shaping a +particular glyph. This might be used, for instance, for +embedding a picture or a widget inside a #PangoLayout. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + ink rectangle to assign to each character + + + + logical rectangle to assign to each character + + + + + + Like pango_attr_shape_new(), but a user data pointer is also +provided; this pointer can be accessed when later +rendering the glyph. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + ink rectangle to assign to each character + + + + logical rectangle to assign to each character + + + + user data pointer + + + + function to copy @data when the attribute is copied. If %NULL, @data is simply copied as a pointer. + + + + function to free @data when the attribute is freed, or %NULL + + + + + + Create a new font-size attribute in fractional points. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + the font size, in %PANGO_SCALE<!-- -->ths of a point. + + + + + + Create a new font-size attribute in device units. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + + + + + the font size, in %PANGO_SCALE<!-- -->ths of a device unit. + - + introspectable="0"> + Create a new font stretch attribute +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the stretch + Create a new strikethrough color attribute. This attribute modifies the color of strikethrough lines. If not set, strikethrough lines will use the foreground color. -freed with pango_attribute_destroy()." - version="1.8"> - +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + the red value (ranging from 0 to 65535) + - + the green value + - + the blue value + - + introspectable="0"> + Create a new strike-through attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + %TRUE if the text should be struck-through. + - + introspectable="0"> + Create a new font slant style attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the slant style + Fetches the attribute type name passed in when registering the type using pango_attr_type_register(). The returned value is an interned string (see g_intern_string() for what that means) that should not be modified or freed. -a built-in Pango attribute type or invalid." - version="1.22"> - +a built-in Pango attribute type or invalid. + + the type ID name (which may be %NULL), or %NULL if @type is + an attribute type ID to fetch the name for - + c:identifier="pango_attr_type_register"> + Allocate a new attribute type ID. The attribute type name can be accessed +later by using pango_attr_type_get_name(). + + the new type ID. + an identifier for the type + Create a new underline color attribute. This attribute modifies the color of underlines. If not set, underlines will use the foreground color. -freed with pango_attribute_destroy()." - version="1.8"> - +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be - + the red value (ranging from 0 to 65535) + - + the green value + - + the blue value + - + introspectable="0"> + Create a new underline-style attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the underline style. - + introspectable="0"> + Create a new font variant attribute (normal or small caps) +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the variant - + introspectable="0"> + Create a new font weight attribute. +freed with pango_attribute_destroy(). + + the newly allocated #PangoAttribute, which should be + the weight - + c:identifier="pango_bidi_type_for_unichar" + introspectable="0"> + - + - + Determines possible line, word, and character breaks for a string of Unicode text with a single analysis. For most -purposes you may want to use pango_get_log_attrs()."> +purposes you may want to use pango_get_log_attrs(). + the text to process - + length of @text in bytes (may be -1 if @text is nul-terminated) + + #PangoAnalysis structure from pango_itemize() + an array to store character information in - + size of the array passed as @attrs + + Convert data generated from pango_converage_to_bytes() back to a #PangoCoverage -the data was invalid."> - +the data was invalid. + + a newly allocated #PangoCoverage, or %NULL if - - - + binary data representing a #PangoCoverage + - + the size of @bytes in bytes + + + Create a new #PangoCoverage +initialized to %PANGO_COVERAGE_NONE +with a reference count of one, which +should be freed with pango_coverage_unref(). + + the newly allocated #PangoCoverage, + + + + Converts extents from Pango units to device units, dividing by the %PANGO_SCALE factor and performing rounding. The @inclusive rectangle is converted by flooring the x/y coordinates and extending width/height, such that the final rectangle completely includes the original @@ -6585,163 +6790,208 @@ of the rectangle to the nearest device unit (pixel). rectangle to completely contain the original rectangle, pass it in as @inclusive. If you want two touching-but-not-overlapping rectangles stay touching-but-not-overlapping after rounding to device units, pass them in -as @nearest." - version="1.16"> +as @nearest. + rectangle to round to pixels inclusively, or %NULL. + rectangle to round to nearest pixels, or %NULL. - + Searches a string the first character that has a strong +direction, according to the Unicode bidirectional algorithm. +If no such character is found, then %PANGO_DIRECTION_NEUTRAL is returned. + + The direction corresponding to the first strong character. + the text to process - + length of @text in bytes (may be -1 if @text is nul-terminated) + + Locates a paragraph boundary in @text. A boundary is caused by delimiter characters, such as a newline, carriage return, carriage return-newline pair, or Unicode paragraph separator character. The index of the run of delimiters is returned in (index after all delimiters) is stored in @next_paragraph_start. If no delimiters are found, both @paragraph_delimiter_index and -off the end)."> +off the end). + UTF-8 text - + length of @text in bytes, or -1 if nul-terminated + - - + + return location for index of delimiter + - - + + return location for start of next paragraph + - + Creates a new font description from a string representation in the +form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a +comma separated list of families optionally terminated by a comma, +STYLE_OPTIONS is a whitespace separated list of words where each WORD +describes one of style, variant, weight, stretch, or gravity, and SIZE +is a decimal number (size in points) or optionally followed by the +unit modifier "px" for absolute size. Any one of the options may +be absent. If FAMILY-LIST is absent, then the family_name field of +the resulting font description will be initialized to %NULL. If +STYLE-OPTIONS is missing, then all style options will be set to the +default values. If SIZE is missing, the size in the resulting font +description will be set to 0. + + a new #PangoFontDescription. + + + + + string representation of a font description. + + + + + + Computes a #PangoLogAttr for each character in @text. The @log_attrs array must have one #PangoLogAttr for each position in @text; if last position at the end of the text. @text should be an entire -paragraph; logical attributes can't be computed without context +paragraph; logical attributes can't be computed without context (for example you need to see spaces on either side of a word to know -the word is a word)."> +the word is a word). + text to process - + length in bytes of @text + - + embedding level, or -1 if unknown + + language tag + array with one #PangoLogAttr per character in @text, plus one extra, to be filled in - + length of @log_attrs array + + If @ch has the Unicode mirrored property and there is another Unicode +character that typically has a glyph that is the mirror image of @ch's glyph, puts that character in the address pointed to by @mirrored_ch. Use g_unichar_get_mirror_char() instead; the docs for that function provide full details. -filled in, %FALSE otherwise"> +filled in, %FALSE otherwise - + %TRUE if @ch has a mirrored character and @mirrored_ch is + - + a Unicode character + - + location to store the mirrored character + - + Finds the gravity that best matches the rotation component +in a #PangoMatrix. +%PANGO_GRAVITY_AUTO, or %PANGO_GRAVITY_SOUTH if @matrix is %NULL + + the gravity of @matrix, which will never be + a #PangoMatrix + Based on the script, base gravity, and hint, returns actual gravity to use in laying out a single #PangoItem. If @base_gravity is %PANGO_GRAVITY_AUTO, it is first replaced with the preferred gravity of @script. To get the preferred gravity of a script, pass %PANGO_GRAVITY_AUTO and %PANGO_GRAVITY_HINT_STRONG in. -with @script." - version="1.16"> - +with @script. + + resolved gravity suitable to use for a run of text + #PangoScript to query + base gravity of the paragraph + orientation hint + Based on the script, East Asian width, base gravity, and hint, returns actual gravity to use in laying out a single character or #PangoItem. This function is similar to pango_gravity_get_for_script() except @@ -6752,63 +7002,70 @@ whereas narrow/full-width characters are always rotated in vertical context. If @base_gravity is %PANGO_GRAVITY_AUTO, it is first replaced with the preferred gravity of @script. -with @script and @wide." - version="1.26"> - +with @script and @wide. + + resolved gravity suitable to use for a run of text + #PangoScript to query - + %TRUE for wide characters as returned by g_unichar_iswide() + + base gravity of the paragraph + orientation hint + Converts a #PangoGravity value to its natural rotation in radians. Note that pango_matrix_rotate() takes angle in degrees, not radians. So, to call pango_matrix_rotate() with the output of this function -you should multiply it by (180. / G_PI)." - version="1.16"> +you should multiply it by (180. / G_PI). - + the rotation value corresponding to @gravity. + + gravity to query + Checks @ch to see if it is a character that should not be normally rendered on the screen. This includes all Unicode characters -with "ZERO WIDTH" in their name, as well as <firstterm>bidi</firstterm> formatting characters, and +with "ZERO WIDTH" in their name, as well as <firstterm>bidi</firstterm> formatting characters, and a few other ones. This is totally different from g_unichar_iszerowidth() -and is at best misnamed." - version="1.10"> +and is at best misnamed. - + %TRUE if @ch is a zero-width character, %FALSE otherwise + - + a Unicode character + - + after @start_index. This must be >= 0. Breaks a piece of text into segments with consistent directional level and shaping engine. Each byte of @text will @@ -6817,94 +7074,116 @@ the generated list of items will be in logical order (the start offsets of the items are ascending). range before or containing @start_index; @cached_iter will be advanced to the range covering the position just after @start_index + @length. -(i.e. if itemizing in a loop, just keep passing in the same @cached_iter)."> - - +(i.e. if itemizing in a loop, just keep passing in the same @cached_iter). + + a #GList of #PangoItem structures. + + + + a structure holding information that affects + the text to itemize. - + first byte in @text to process + - - + + the number of bytes (not characters) to process + + the set of attributes that apply to @text. + Cached attribute iterator, or %NULL + after @start_index. This must be >= 0. Like pango_itemize(), but the base direction to use when computing bidirectional levels (see pango_context_set_base_dir ()), is specified explicitly rather than gotten from the #PangoContext. freed using pango_item_free() probably in combination with g_list_foreach(), -and the list itself using g_list_free()." - version="1.4"> - - +and the list itself using g_list_free(). + + a #GList of #PangoItem structures. The items should be + + + + a structure holding information that affects + base direction to use for bidirectional processing + the text to itemize. - + first byte in @text to process + - - + + the number of bytes (not characters) to process + + the set of attributes that apply to @text. + Cached attribute iterator, or %NULL + Take a RFC-3066 format language tag as a string and convert it to a #PangoLanguage pointer that can be efficiently copied (copy the pointer) and compared with other language tags (compare the pointer.) This function first canonicalizes the string by converting it to -lowercase, mapping '_' to '-', and stripping all characters other -than letters and '-'. +lowercase, mapping '_' to '-', and stripping all characters other +than letters and '-'. Use pango_language_get_default() if you want to get the #PangoLanguage for the current locale of the process. if @language was %NULL. The returned pointer will be valid -forever after, and should not be freed."> +forever after, and should not be freed. + an opaque pointer to a #PangoLanguage structure, or %NULL + a string representing a language tag, or %NULL + Returns the #PangoLanguage for the current locale of the process. Note that this can change over the life of an application. On Unix systems, this is the return value is derived from <literal>setlocale(LC_CTYPE, NULL)</literal>, and the user can @@ -6915,90 +7194,93 @@ COUNTRY is an ISO-3166 country code. For instance, sv_FI for Swedish as written in Finland or pt_BR for Portuguese as written in Brazil. On Windows, the C library does not use any such environment -variables, and setting them won't affect the behavior of functions +variables, and setting them won't affect the behavior of functions like ctime(). The user sets the locale through the Regional Options in the Control Panel. The C library (in the setlocale() function) does not use country and language codes, but country and language names spelled out in English. However, this function does check the above environment variables, and does return a Unix-style locale string based on -either said environment variables or the thread's current locale. -Your application should call <literal>setlocale(LC_ALL, "");</literal> +either said environment variables or the thread's current locale. +Your application should call <literal>setlocale(LC_ALL, "");</literal> for the user settings to take effect. Gtk+ does this in its initialization functions automatically (by calling gtk_set_locale()). See <literal>man setlocale</literal> for more details. -freed." - version="1.16"> +freed. + the default language as a #PangoLanguage, must not be + This will return the bidirectional embedding levels of the input paragraph as defined by the Unicode Bidirectional Algorithm available at: http://www.unicode.org/reports/tr9/ If the input base direction is a weak direction, the direction of the characters in the text will determine the final resolved direction. -character (not byte), that should be freed using g_free." - version="1.4"> - - - - +character (not byte), that should be freed using g_free. + + a newly allocated array of embedding levels, one item per + + the text to itemize. - - + + the number of bytes (not characters) to process, or -1 if @text is nul-terminated and the length should be calculated. + + input base direction, and output resolved direction. - + Parses an enum type and stores the result in @value. If @str does not match the nick name of any of the possible values for the enum and is not an integer, %FALSE is returned, a warning is issued if @warn is %TRUE, and a string representing the list of possible values is stored in -"none/start/middle/end". If failed and @possible_values is not %NULL, -returned string should be freed using g_free()." - version="1.16"> +"none/start/middle/end". If failed and @possible_values is not %NULL, +returned string should be freed using g_free(). - + %TRUE if @str was successfully parsed. + + enum type to parse, eg. %PANGO_TYPE_ELLIPSIZE_MODE. + string to parse. May be %NULL. - - + + integer to store the result in, or %NULL. + - - + + if %TRUE, issue a g_warning() on bad input. + - - - + place to store list of possible values on failure, or %NULL. + + Parses marked-up text (see +<link linkend="PangoMarkupFormat">markup format</link>) to create a plain-text string and an attribute list. If @accel_marker is nonzero, the given character will mark the character following it as an accelerator. For example, @accel_marker @@ -7008,233 +7290,287 @@ and the first character so marked will be returned in @accel_char. Two @accel_marker characters following each other produce a single literal @accel_marker character. If any error happens, none of the output arguments are touched except -for @error." - throws="1"> +for @error. - + %FALSE if @error is set, otherwise %TRUE + + markup to parse (see <link linkend="PangoMarkupFormat">markup format</link>) - + length of @markup_text, or -1 if nul-terminated + - + character that precedes an accelerator, or 0 for none + + address of return location for a #PangoAttrList, or %NULL - - - + address of return location for text with tags stripped, or %NULL + - + address of return location for accelerator char, or %NULL + - + + Parses a font stretch. The allowed values are +"ultra_condensed", "extra_condensed", "condensed", +"semi_condensed", "normal", "semi_expanded", "expanded", +"extra_expanded" and "ultra_expanded". Case variations are +ignored and the '_' characters may be omitted. - + %TRUE if @str was successfully parsed. + + a string to parse. + a #PangoStretch to store the result in. - - + + if %TRUE, issue a g_warning() on bad input. + - + + Parses a font style. The allowed values are "normal", +"italic" and "oblique", case variations being +ignored. - + %TRUE if @str was successfully parsed. + + a string to parse. + a #PangoStyle to store the result in. - - + + if %TRUE, issue a g_warning() on bad input. + - + + Parses a font variant. The allowed values are "normal" +and "smallcaps" or "small_caps", case variations being +ignored. - + %TRUE if @str was successfully parsed. + + a string to parse. + a #PangoVariant to store the result in. - - + + if %TRUE, issue a g_warning() on bad input. + - + + Parses a font weight. The allowed values are "heavy", +"ultrabold", "bold", "normal", "light", "ultraleight" +and integers. Case variations are ignored. - + %TRUE if @str was successfully parsed. + + a string to parse. + a #PangoWeight to store the result in. - - + + if %TRUE, issue a g_warning() on bad input. + + Quantizes the thickness and position of a line, typically an underline or strikethrough, to whole device pixels, that is integer multiples of %PANGO_SCALE. The purpose of this function is to avoid such lines looking blurry. Care is taken to make sure @thickness is at least one pixel when this function returns, but returned @position may become zero as a result -of rounding." - version="1.12"> +of rounding. - - + + pointer to the thickness of a line, in Pango units + - - + + corresponding position + + + + + + Reads an entire line from a file into a buffer. Lines may +be delimited with '\n', '\r', '\n\r', or '\r\n'. The delimiter +is not written into the buffer. Text after a '#' character is treated as +a comment and skipped. '\' can be used to escape a # character. +'\' proceeding a line delimiter combines adjacent lines. A '\' proceeding +any other character is ignored and written into the output buffer +unmodified. +the number of lines read (this is useful for maintaining +a line number counter which doesn't combine lines with '\') + + 0 if the stream was already at an %EOF character, otherwise + + + + + a stdio stream + + + + #GString buffer into which to write the result + + From a list of items in logical order and the associated directional levels, produce a list in visual order. The original list is unmodified. (Please open a bug if you use this function. It is not a particularly convenient interface, and the code -is duplicated elsewhere in Pango for that reason.)"> - - +is duplicated elsewhere in Pango for that reason.) + + a #GList of #PangoItem structures in visual order. + + + - + a #GList of #PangoItem in logical order. + + + - + + Scans an integer. +Leading white space is skipped. - + %FALSE if a parse error occurred. + - - - - - - - - - - - - - - - - - - + in/out string position + + an int into which to write the result + + + + + + Scans a string into a #GString buffer. The string may either +be a sequence of non-white-space characters, or a quoted +string with '"'. Instead a quoted string, '\"' represents +a literal quote. Leading white space outside of quotes is skipped. + + %FALSE if a parse error occurred. + + + + + in/out string position + + + + a #GString into which to write the result - + Scans a word into a #GString buffer. A word consists of [A-Za-z_] followed by zero or more [A-Za-z_0-9] -Leading white space is skipped."> +Leading white space is skipped. - + %FALSE if a parse error occurred. + - - - + in/out string position + + a #GString into which to write the result + Looks up the #PangoScript for a particular character (as defined by Unicode Standard Annex #24). No check is made for @ch being a valid Unicode character; if you pass in invalid character, the result is undefined. As of Pango 1.18, this function simply returns the return value of -g_unichar_get_script()." - version="1.4"> - +g_unichar_get_script(). + + the #PangoScript for the character. - + a Unicode character + + Given a script, finds a language tag that is reasonably representative of that script. This will usually be the most widely spoken or used language written in that script: for instance, the sample language for %PANGO_SCRIPT_CYRILLIC @@ -7255,150 +7591,190 @@ separated by colons or other separators. This function will return the first language in the parsed list that Pango believes may use @script for writing. This last predicate is tested using pango_language_includes_script(). This can -be used to control Pango's font selection for non-primary +be used to control Pango's font selection for non-primary languages. For example, a PANGO_LANGUAGE enviroment variable -set to "en:fa" makes Pango choose fonts suitable for Persian (fa) +set to "en:fa" makes Pango choose fonts suitable for Persian (fa) instead of Arabic (ar) when a segment of Arabic text is found in an otherwise non-Arabic text. The same trick can be used to choose a default language for %PANGO_SCRIPT_HAN when setting context language is not feasible. -of the script, or %NULL if no such language exists." - version="1.4"> +of the script, or %NULL if no such language exists. + a #PangoLanguage that is representative + a #PangoScript - + Create a new #PangoScriptIter, used to break a string of +Unicode into runs by text. No copy is made of @text, so +the caller needs to make sure it remains valid until +the iterator is freed with pango_script_iter_free(). +to point at the first range in the text, which should be +freed with pango_script_iter_free(). If the string is +empty, it will point at an empty range. + + the new script iterator, initialized + + + + + a UTF-8 string + + + + length of @text, or -1 if @text is nul-terminated. + + + + + + Given a segment of text and the corresponding #PangoAnalysis structure returned from pango_itemize(), convert the characters into glyphs. You may also pass -in only a substring of the item from pango_itemize()."> +in only a substring of the item from pango_itemize(). + the text to process - - + + the length (in bytes) of @text + + #PangoAnalysis structure from pango_itemize() + glyph string in which to store results - + + Skips 0 or more characters of white space. +the position at a '\0' character. - + %FALSE if skipping the white space leaves + - - - + in/out string position + - + introspectable="0"> + Splits a %G_SEARCHPATH_SEPARATOR-separated list of files, stripping +white space and substituting ~/ with $HOME/. + + a list of strings to be freed with g_strfreev() + a %G_SEARCHPATH_SEPARATOR separated list of filenames - + + Trims leading and trailing whitespace from a string. + A newly-allocated string that must be freed with g_free() + a string + Determines the inherent direction of a character; either %PANGO_DIRECTION_LTR, %PANGO_DIRECTION_RTL, or %PANGO_DIRECTION_NEUTRAL. This function is useful to categorize characters into left-to-right letters, right-to-left letters, and everything else. If full Unicode bidirectional type of a character is needed, -pango_bidi_type_for_gunichar() can be used instead."> - +pango_bidi_type_for_gunichar() can be used instead. + + the direction of the character. - + a Unicode character + + it by %PANGO_SCALE and rounds to nearest integer. - + the value in Pango units. + - + double floating-point value + + it by %PANGO_SCALE. - + the double value. + - + value in Pango units + - + This is similar to the macro %PANGO_VERSION except that it returns the encoded version of Pango available at run-time, as opposed to the version available at compile-time. A version number can be encoded into an integer using PANGO_VERSION_ENCODE(). -available at run time." - version="1.16"> +available at run time. - + The encoded version of Pango library + + Checks that the Pango library in use is compatible with the given version. Generally you would pass in the constants %PANGO_VERSION_MAJOR, %PANGO_VERSION_MINOR, %PANGO_VERSION_MICRO as the three arguments to this function; that produces @@ -7411,33 +7787,37 @@ version @required_major.required_minor.@required_micro For compile-time version checking use PANGO_VERSION_CHECK(). given version, or a string describing the version mismatch. The returned string is owned by Pango and should not be modified -or freed." - version="1.16"> +or freed. + %NULL if the Pango library is compatible with the - + the required major version. + - + the required minor version. + - + the required major version. + + This is similar to the macro %PANGO_VERSION_STRING except that it returns the version of Pango available at run-time, as opposed to the version available at compile-time. available at run time. The returned string is owned by Pango and should not be modified -or freed." - version="1.16"> +or freed. + A string containing the version of Pango library diff --git a/basis/pango/cairo/PangoCairo-1.0.gir b/basis/pango/cairo/PangoCairo-1.0.gir index 13d9e9d924..2f6b01ae30 100644 --- a/basis/pango/cairo/PangoCairo-1.0.gir +++ b/basis/pango/cairo/PangoCairo-1.0.gir @@ -2,7 +2,7 @@ - @@ -18,173 +18,361 @@ and/or use gtk-doc annotations. --> - - - + + + + + + + + + + + + + + #PangoCairoFont is an interface exported by fonts for use with Cairo. The actual type of the font will depend -on the particular font technology Cairo was compiled to use." - version="1.18"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +on the particular font technology Cairo was compiled to use. + + + Gets the #cairo_scaled_font_t used by @font. +The scaled font can be referenced and kept using +cairo_scaled_font_reference(). +or %NULL if @font is %NULL. - + the #cairo_scaled_font_t used by @font, + - + + + + #PangoCairoFontMap is an interface exported by font maps for +use with Cairo. The actual type of the font map will depend +on the particular font technology Cairo was compiled to use. + + + Create a #PangoContext for the given fontmap. + + the newly created context; free with g_object_unref(). + + + + + Gets the type of Cairo font backend that @fontmap uses. + + the #cairo_font_type_t cairo font backend type + + + + + Gets the resolution for the fontmap. See pango_cairo_font_map_set_resolution() + + the resolution in "dots per inch" + + + + Sets a default #PangoCairoFontMap to use with Cairo. This can be used to change the Cairo font backend that the default fontmap uses for example. The old default font map is unreffed and the new font map referenced. A value of %NULL for @fontmap will cause the current default font map to be released and a new default font -map to be created on demand, using pango_cairo_font_map_new()." - version="1.22"> +map to be created on demand, using pango_cairo_font_map_new(). + Sets the resolution for the fontmap. This is a scale factor between points specified in a #PangoFontDescription and Cairo units. The default value is 96, meaning that a 10 point font will be 13 -units high. (10 * 96. / 72. = 13.3)." - version="1.10"> +units high. (10 * 96. / 72. = 13.3). - + the resolution in "dots per inch". (Physical inches aren't actually involved; the terminology is conventional.) + - - - - - - - - - - - - - - - - - - - - - - - + + - + + + + + + + + + + + + + + + + + + + Retrieves any font rendering options previously set with +pango_cairo_font_map_set_font_options(). This function does not report options +that are derived from the target surface by pango_cairo_update_context() +if no options have been set. This value is owned by the context +and must not be modified or freed. + + the font options previously set on the context, or %NULL + + a #PangoContext, from a pangocairo font map - + Gets the resolution for the context. See pango_cairo_context_set_resolution() +be returned if no resolution has previously been set. + + the resolution in "dots per inch". A negative value will + + + + + a #PangoContext, from a pangocairo font map + + + + + + Sets callback function for context to use for rendering attributes +of type %PANGO_ATTR_SHAPE. See #PangoCairoShapeRendererFunc for +details. +Retrieves callback function and associated user data for rendering +attributes of type %PANGO_ATTR_SHAPE as set by +pango_cairo_context_set_shape_renderer(), if any. +if no shape rendering callback have been set. + + the shape rendering callback previously set on the context, or %NULL + + + + + a #PangoContext, from a pangocairo font map + + + + Pointer to #gpointer to return user data + + + + + + Sets the font options used when rendering text with this context. +These options override any options that pango_cairo_update_context() +derives from the target surface. + a #PangoContext, from a pangocairo font map + + + + a #cairo_font_options_t, or %NULL to unset any previously set options. A copy is made. + + + + + + Sets the resolution for the context. This is a scale factor between +points specified in a #PangoFontDescription and Cairo units. The +default value is 96, meaning that a 10 point font will be 13 +units high. (10 * 96. / 72. = 13.3). + + + + + + a #PangoContext, from a pangocairo font map - + the resolution in "dots per inch". (Physical inches aren't actually involved; the terminology is conventional.) A 0 or negative value means to use the resolution from the font map. + + + + + + Sets callback function for context to use for rendering attributes +of type %PANGO_ATTR_SHAPE. See #PangoCairoShapeRendererFunc for +details. + + + + + + a #PangoContext, from a pangocairo font map + + + + Callback function for rendering attributes of type %PANGO_ATTR_SHAPE, or %NULL to disable shape rendering. + + + + User data that will be passed to @func. + + + + Callback that will be called when the context is freed to release @data, or %NULL. + + + + + + Creates a context object set up to match the current transformation +and target surface of the Cairo context. This context can then be +used to create a layout using pango_layout_new(). +This function is a convenience function that creates a context using +the default font map, then updates it to @cr. If you just need to +create a layout for use with @cr and do not need to access #PangoContext +directly, you can use pango_cairo_create_layout() instead. +g_object_unref(). + + the newly created #PangoContext. Free with + + + + + a Cairo context + + + + + + Creates a layout object set up to match the current transformation +and target surface of the Cairo context. This layout can then be +used for text measurement with functions like +pango_layout_get_size() or drawing with functions like +pango_cairo_show_layout(). If you change the transformation +or target surface for @cr, you need to call pango_cairo_update_layout() +This function is the most convenient way to use Cairo with Pango, +however it is slightly inefficient since it creates a separate +#PangoContext object for each layout. This might matter in an +application that was laying out large amounts of text. +g_object_unref(). + + the newly created #PangoLayout. Free with + + + + + a Cairo context + + + + + + Add a squiggly line to the current path in the specified cairo context that +approximately covers the given rectangle in the style of an underline used +to indicate a spelling error. (The width of the underline is rounded to an +integer number of up/down segments and the resulting rectangle is centered +in the original rectangle) + + + + + + a Cairo context + + + + The X coordinate of one corner of the rectangle + + + + The Y coordinate of one corner of the rectangle + + + + Non-negative width of the rectangle + + + + Non-negative height of the rectangle + + Gets a default #PangoCairoFontMap to use with Cairo. Note that the type of the returned object will depend on the particular font backend Cairo was compiled to use; You generally should only use the #PangoFontMap and @@ -193,11 +381,278 @@ The default Cairo fontmap can be changed by using pango_cairo_font_map_set_default(). This can be used to change the Cairo font backend that the default fontmap uses for example. -object is owned by Pango and must not be freed." - version="1.10"> - +object is owned by Pango and must not be freed. + + the default Cairo fontmap for Pango. This + + Creates a new #PangoCairoFontMap object; a fontmap is used +to cache information about available fonts, and holds +certain global parameters such as the resolution. +In most cases, you can use pango_cairo_font_map_get_default() +instead. +Note that the type of the returned object will depend +on the particular font backend Cairo was compiled to use; +You generally should only use the #PangoFontMap and +#PangoCairoFontMap interfaces on the returned object. +be freed with g_object_unref(). + + the newly allocated #PangoFontMap, which should + + + + + Creates a new #PangoCairoFontMap object of the type suitable +to be used with cairo font backend of type @fonttype. +In most cases one should simply use @pango_cairo_font_map_new(), +or in fact in most of those cases, just use +which should be freed with g_object_unref(), +or %NULL if the requested cairo font backend is +not supported / compiled in. + + the newly allocated #PangoFontMap of suitable type + + + + + desired #cairo_font_type_t + + + + + + + + + + + + + + + + + + + + + + Adds the text in #PangoLayoutLine to the current path in the +specified cairo context. The origin of the glyphs (the left edge +of the line) will be at the current point of the cairo context. + + + + + + a Cairo context + + + + a #PangoLayoutLine + + + + + + Adds the text in a #PangoLayout to the current path in the +specified cairo context. The top-left corner of the #PangoLayout +will be at the current point of the cairo context. + + + + + + a Cairo context + + + + a Pango layout + + + + + + Draw a squiggly line in the specified cairo context that approximately +covers the given rectangle in the style of an underline used to indicate a +spelling error. (The width of the underline is rounded to an integer +number of up/down segments and the resulting rectangle is centered in the +original rectangle) + + + + + + a Cairo context + + + + The X coordinate of one corner of the rectangle + + + + The Y coordinate of one corner of the rectangle + + + + Non-negative width of the rectangle + + + + Non-negative height of the rectangle + + + + + + Draws the glyphs in @glyph_item in the specified cairo context, +embedding the text associated with the glyphs in the output if the +output format supports it (PDF for example), otherwise it acts +similar to pango_cairo_show_glyph_string(). +The origin of the glyphs (the left edge of the baseline) will +be drawn at the current point of the cairo context. +Note that @text is the start of the text for layout, which is then +indexed by <literal>@glyph_item->item->offset</literal>. + + + + + + a Cairo context + + + + the UTF-8 text that @glyph_item refers to + + + + a #PangoGlyphItem + + + + + + Draws the glyphs in @glyphs in the specified cairo context. +The origin of the glyphs (the left edge of the baseline) will +be drawn at the current point of the cairo context. + + + + + + a Cairo context + + + + a #PangoFont from a #PangoCairoFontMap + + + + a #PangoGlyphString + + + + + + Draws a #PangoLayout in the specified cairo context. +The top-left corner of the #PangoLayout will be drawn +at the current point of the cairo context. + + + + + + a Cairo context + + + + a Pango layout + + + + + + Draws a #PangoLayoutLine in the specified cairo context. +The origin of the glyphs (the left edge of the line) will +be drawn at the current point of the cairo context. + + + + + + a Cairo context + + + + a #PangoLayoutLine + + + + + + Updates a #PangoContext previously created for use with Cairo to +match the current transformation and target surface of a Cairo +context. If any layouts have been created for the context, +it's necessary to call pango_layout_context_changed() on those +layouts. + + + + + + a Cairo context + + + + a #PangoContext, from a pangocairo font map + + + + + + Updates the private #PangoContext of a #PangoLayout created with +pango_cairo_create_layout() to match the current transformation +and target surface of a Cairo context. + + + + + + a Cairo context + + + + a #PangoLayout, from pango_cairo_create_layout() + + + + diff --git a/basis/pango/cairo/ffi/ffi.factor b/basis/pango/cairo/ffi/ffi.factor index c37a08b6d6..1b19ba6ab7 100644 --- a/basis/pango/cairo/ffi/ffi.factor +++ b/basis/pango/cairo/ffi/ffi.factor @@ -1,10 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries alien.syntax cairo.ffi -combinators kernel system -gobject-introspection pango.ffi ; +USING: alien alien.libraries alien.syntax cairo.ffi combinators +gobject-introspection system vocabs.loader ; IN: pango.cairo.ffi +<< +"pango.ffi" require +>> + +LIBRARY: pango.cairo + << "pango.cairo" { { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } @@ -13,14 +18,9 @@ IN: pango.cairo.ffi } cond >> +FOREIGN-RECORD-TYPE: cairo.Context cairo_t +FOREIGN-RECORD-TYPE: cairo.ScaledFont cairo_scaled_font_t +FOREIGN-ENUM-TYPE: cairo.FontType cairo_font_type_t +FOREIGN-RECORD-TYPE: cairo.FontOptions cairo_font_options_t + GIR: vocab:pango/cairo/PangoCairo-1.0.gir - -FUNCTION: void -pango_cairo_update_layout ( cairo_t* cr, PangoLayout* layout ) ; - -FUNCTION: void -pango_cairo_show_layout ( cairo_t* cr, PangoLayout* layout ) ; - -FUNCTION: PangoLayout* -pango_cairo_create_layout ( cairo_t* cr ) ; - diff --git a/basis/pango/ffi/ffi.factor b/basis/pango/ffi/ffi.factor index e6c794e8bf..4e05226edc 100644 --- a/basis/pango/ffi/ffi.factor +++ b/basis/pango/ffi/ffi.factor @@ -1,10 +1,16 @@ -! Copyright (C) 2009 Anton Gorenko. +! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.destructors alien.libraries -alien.syntax combinators kernel system -gobject-introspection glib.ffi ; +alien.syntax combinators gobject-introspection +gobject-introspection.standard-types system vocabs.loader ; IN: pango.ffi +<< +"gobject.ffi" require +>> + +LIBRARY: pango + << "pango" { { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } @@ -13,9 +19,6 @@ IN: pango.ffi } cond >> -TYPEDEF: void PangoLayoutRun -TYPEDEF: guint32 PangoGlyph - IMPLEMENT-STRUCTS: PangoRectangle ; GIR: vocab:pango/Pango-1.0.gir @@ -23,3 +26,14 @@ GIR: vocab:pango/Pango-1.0.gir DESTRUCTOR: pango_font_description_free DESTRUCTOR: pango_layout_iter_free +! diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 996a26e584..3fbf2431b3 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,13 +1,14 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data -alien.strings arrays assocs classes.struct command-line destructors -gdk.ffi gdk.gl.ffi glib.ffi gobject.ffi gtk.ffi gtk.gl.ffi io.backend -io.backend.unix.multiplexers io.encodings.utf8 io.thread kernel libc -literals locals math math.bitwise math.order math.vectors namespaces -sequences strings system threads ui ui.backend ui.clipboards -ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.private -ui.gadgets.worlds ui.gestures ui.pixel-formats +alien.strings alien.syntax arrays assocs classes.struct command-line +destructors gdk.ffi gdk.gl.ffi glib.ffi +gobject-introspection.standard-types gobject.ffi gtk.ffi gtk.gl.ffi +io.backend io.backend.unix.multiplexers io.encodings.utf8 io.thread +kernel libc literals locals math math.bitwise math.order math.vectors +namespaces sequences strings system threads ui ui.backend +ui.clipboards ui.event-loop ui.gadgets ui.gadgets.editors +ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private ; IN: ui.backend.gtk @@ -144,33 +145,33 @@ CONSTANT: modifiers CONSTANT: action-key-codes H{ - { $ GDK_BackSpace "BACKSPACE" } - { $ GDK_Tab "TAB" } - { $ GDK_Return "RET" } - { $ GDK_KP_Enter "ENTER" } - { $ GDK_Escape "ESC" } - { $ GDK_Delete "DELETE" } - { $ GDK_Home "HOME" } - { $ GDK_Left "LEFT" } - { $ GDK_Up "UP" } - { $ GDK_Right "RIGHT" } - { $ GDK_Down "DOWN" } - { $ GDK_Page_Up "PAGE_UP" } - { $ GDK_Page_Down "PAGE_DOWN" } - { $ GDK_End "END" } - { $ GDK_Begin "BEGIN" } - { $ GDK_F1 "F1" } - { $ GDK_F2 "F2" } - { $ GDK_F3 "F3" } - { $ GDK_F4 "F4" } - { $ GDK_F5 "F5" } - { $ GDK_F6 "F6" } - { $ GDK_F7 "F7" } - { $ GDK_F8 "F8" } - { $ GDK_F9 "F9" } - { $ GDK_F10 "F10" } - { $ GDK_F11 "F11" } - { $ GDK_F12 "F12" } + { $ GDK_KEY_BackSpace "BACKSPACE" } + { $ GDK_KEY_Tab "TAB" } + { $ GDK_KEY_Return "RET" } + { $ GDK_KEY_KP_Enter "ENTER" } + { $ GDK_KEY_Escape "ESC" } + { $ GDK_KEY_Delete "DELETE" } + { $ GDK_KEY_Home "HOME" } + { $ GDK_KEY_Left "LEFT" } + { $ GDK_KEY_Up "UP" } + { $ GDK_KEY_Right "RIGHT" } + { $ GDK_KEY_Down "DOWN" } + { $ GDK_KEY_Page_Up "PAGE_UP" } + { $ GDK_KEY_Page_Down "PAGE_DOWN" } + { $ GDK_KEY_End "END" } + { $ GDK_KEY_Begin "BEGIN" } + { $ GDK_KEY_F1 "F1" } + { $ GDK_KEY_F2 "F2" } + { $ GDK_KEY_F3 "F3" } + { $ GDK_KEY_F4 "F4" } + { $ GDK_KEY_F5 "F5" } + { $ GDK_KEY_F6 "F6" } + { $ GDK_KEY_F7 "F7" } + { $ GDK_KEY_F8 "F8" } + { $ GDK_KEY_F9 "F9" } + { $ GDK_KEY_F10 "F10" } + { $ GDK_KEY_F11 "F11" } + { $ GDK_KEY_F12 "F12" } } : event-modifiers ( event -- seq ) @@ -195,30 +196,24 @@ CONSTANT: action-key-codes : on-motion ( win event user-data -- ? ) drop swap - [ GdkEventMotion memory>struct event-loc ] dip window + [ event-loc ] dip window move-hand fire-motion t ; -: on-enter ( win event user-data -- ? ) - on-motion ; - : on-leave ( win event user-data -- ? ) 3drop forget-rollover t ; : on-button-press ( win event user-data -- ? ) drop swap [ - GdkEventButton memory>struct mouse-event>gesture [ ] dip ] dip window send-button-down t ; : on-button-release ( win event user-data -- ? ) drop swap [ - GdkEventButton memory>struct mouse-event>gesture [ ] dip ] dip window send-button-up t ; : on-scroll ( win event user-data -- ? ) drop swap [ - GdkEventScroll memory>struct [ scroll-direction ] [ event-loc ] bi ] dip window send-scroll t ; @@ -227,7 +222,6 @@ CONSTANT: action-key-codes [ gdk_keyval_to_unicode [ f ] [ 1string ] if-zero f ] ?if ; : key-event>gesture ( event -- mods sym/f action? ) - GdkEventKey memory>struct [ event-modifiers ] [ key-sym ] bi ; : on-key-press ( win event user-data -- ? ) @@ -250,8 +244,6 @@ CONSTANT: action-key-codes GtkWidget:motion-notify-event connect-signal win "leave-notify-event" [ on-leave yield ] GtkWidget:leave-notify-event connect-signal - win "enter-notify-event" [ on-enter yield ] - GtkWidget:enter-notify-event connect-signal win "button-press-event" [ on-button-press yield ] GtkWidget:button-press-event connect-signal win "button-release-event" [ on-button-release yield ] @@ -274,7 +266,7 @@ CONSTANT: action-key-codes : on-configure ( win event user-data -- ? ) drop [ window ] [ GdkEventConfigure memory>struct ] bi* - [ event-loc >>window-loc ] [ event-dim >>dim ] bi + [ event-loc >>window-loc ] [ event-dim >>dim ] bi relayout-1 f ; : on-delete ( win event user-data -- ? ) @@ -323,7 +315,7 @@ M: editor get-cursor-loc&dim [ delete-cursor-surrounding t ] [ 3drop f ] if nip ; : get-preedit-string ( im-context -- str cursor-pos ) - { void* int } [ f swap gtk_im_context_get_preedit_string ] + { pointer: gchar gint } [ f swap gtk_im_context_get_preedit_string ] with-out-parameters [ [ utf8 alien>string ] [ g_free ] bi ] dip ; @@ -340,7 +332,11 @@ M: editor get-cursor-loc&dim : gadget-cursor-location ( gadget -- rectangle ) [ gadget-location ] [ get-cursor-loc&dim ] bi [ v+ ] dip - [ first2 ] bi@ GdkRectangle ; + [ first2 ] bi@ + ! ; + ! workaround> + ! GdkRectangle ; : update-cursor-location ( im-context gadget -- ) gadget-cursor-location gtk_im_context_set_cursor_location ; @@ -464,7 +460,7 @@ M: gtk-ui-backend (free-pixel-format) M: gtk-ui-backend (pixel-format-attribute) [ handle>> ] [ >gl-config-attribs ] bi* - { int } [ gdk_gl_config_get_attrib drop ] + { gint } [ gdk_gl_config_get_attrib drop ] with-out-parameters ; M: window-handle select-gl-context ( handle -- ) @@ -557,16 +553,20 @@ M: gtk-ui-backend beep gdk_beep ; M:: gtk-ui-backend system-alert ( caption text -- ) - f GTK_DIALOG_MODAL GTK_MESSAGE_WARNING GTK_BUTTONS_OK - caption utf8 string>alien f gtk_message_dialog_new - [ text utf8 string>alien f gtk_message_dialog_format_secondary_text ] - [ gtk_dialog_run drop ] - [ gtk_widget_destroy ] tri ; + [ + f GTK_DIALOG_MODAL GTK_MESSAGE_WARNING GTK_BUTTONS_OK + caption utf8 string>alien f + gtk_message_dialog_new >k_widget_destroy + [ + text utf8 string>alien f + gtk_message_dialog_format_secondary_text + ] [ gtk_dialog_run drop ] bi + ] with-destructors ; M: gtk-ui-backend (with-ui) [ - f f gtk_init - f f gtk_gl_init + 0 f gtk_init + 0 f gtk_gl_init init-clipboard start-ui stop-io-thread @@ -577,6 +577,7 @@ M: gtk-ui-backend (with-ui) ] with-destructors ] ui-running ; + gtk-ui-backend ui-backend set-global [ "ui.tools" ] main-vocab-hook set-global diff --git a/basis/ui/text/pango/pango.factor b/basis/ui/text/pango/pango.factor index ede8135e95..9b40448737 100644 --- a/basis/ui/text/pango/pango.factor +++ b/basis/ui/text/pango/pango.factor @@ -1,10 +1,10 @@ ! Copyright (C) 2009, 2010 Slava Pestov. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.c-types alien.strings arrays assocs cache cairo -cairo.ffi classes.struct combinators destructors fonts fry -init io.encodings.utf8 kernel math math.rectangles math.vectors -memoize namespaces sequences ui.text ui.text.private -gobject.ffi pango.ffi pango.cairo.ffi ; +USING: accessors alien.c-types alien.data alien.strings arrays assocs +cache cairo cairo.ffi classes.struct combinators destructors fonts fry +gobject.ffi init io.encodings.utf8 kernel math math.rectangles +math.vectors memoize namespaces pango.cairo.ffi pango.ffi sequences +ui.text ui.text.private ; IN: ui.text.pango : pango>float ( n -- x ) PANGO_SCALE /f ; inline @@ -69,16 +69,17 @@ SYMBOL: dpi : line-offset>x ( layout n -- x ) #! n is an index into the UTF8 encoding of the text [ drop first-line ] [ swap string>> >utf8-index ] 2bi - f 0 [ pango_layout_line_index_to_x ] keep - *int pango>float ; + f { int } [ pango_layout_line_index_to_x ] with-out-parameters + pango>float ; : x>line-offset ( layout x -- n ) #! n is an index into the UTF8 encoding of the text [ [ first-line ] dip - float>pango 0 0 - [ pango_layout_line_x_to_index drop ] 2keep - [ *int ] bi@ swap + float>pango + { int int } + [ pango_layout_line_x_to_index drop ] with-out-parameters + swap ] [ drop string>> ] 2bi utf8-index> + ; : selection-start/end ( selection -- start end ) From ed46a3d472d257618d6b8d5acad0e344004a7644 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 15 Nov 2010 21:46:54 +0600 Subject: [PATCH 53/76] pango.cairo: fix incorrect USING:; --- basis/pango/cairo/cairo.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/pango/cairo/cairo.factor b/basis/pango/cairo/cairo.factor index 67ae9969fe..38307ed347 100644 --- a/basis/pango/cairo/cairo.factor +++ b/basis/pango/cairo/cairo.factor @@ -1,5 +1,5 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: cairo.pango.ffi ; +USING: pango.cairo.ffi ; IN: pango.cairo From 0f954c9fa9f37e90cb1014f1a9e1e0b9d9fe14ed Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 15 Nov 2010 21:47:36 +0600 Subject: [PATCH 54/76] gdk.ffi: fix incorrect GdkEvent* structures' definitions; --- basis/gdk/ffi/ffi.factor | 73 +++++++++++++++++++++++++++++++++++----- 1 file changed, 65 insertions(+), 8 deletions(-) diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 1e779befa6..7107b52aa8 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -2,7 +2,8 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.destructors alien.libraries alien.syntax cairo.ffi classes.struct combinators -gobject-introspection kernel system vocabs.loader ; +gobject-introspection gobject-introspection.standard-types +kernel system vocabs.loader ; IN: gdk.ffi << @@ -20,13 +21,6 @@ LIBRARY: gdk } cond >> -IMPLEMENT-STRUCTS: GdkEventAny GdkEventKey GdkEventButton -GdkEventScroll GdkEventMotion GdkEventExpose GdkEventVisibility -GdkEventCrossing GdkEventFocus GdkEventConfigure GdkEventProperty -GdkEventSelection GdkEventDND GdkEventProximity GdkEventClient -GdkEventNoExpose GdkEventWindowState GdkEventSetting -GdkEventOwnerChange GdkEventGrabBroken GdkRectangle ; - ! Date: Mon, 15 Nov 2010 21:48:58 +0600 Subject: [PATCH 55/76] ui.backend.gtk: fix bugs; --- basis/ui/backend/gtk/gtk.factor | 43 ++++++++------------------------- 1 file changed, 10 insertions(+), 33 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 3fbf2431b3..743d98be51 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -1,15 +1,14 @@ ! Copyright (C) 2010 Anton Gorenko, Philipp Brüschweiler. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.accessors alien.c-types alien.data -alien.strings alien.syntax arrays assocs classes.struct command-line -destructors gdk.ffi gdk.gl.ffi glib.ffi -gobject-introspection.standard-types gobject.ffi gtk.ffi gtk.gl.ffi -io.backend io.backend.unix.multiplexers io.encodings.utf8 io.thread -kernel libc literals locals math math.bitwise math.order math.vectors -namespaces sequences strings system threads ui ui.backend -ui.clipboards ui.event-loop ui.gadgets ui.gadgets.editors -ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats -ui.pixel-formats.private ui.private ; +alien.strings arrays assocs classes.struct command-line destructors +gdk.ffi gdk.gl.ffi glib.ffi gobject-introspection.standard-types +gobject.ffi gtk.ffi gtk.gl.ffi io.backend io.backend.unix.multiplexers +io.encodings.utf8 io.thread kernel libc literals locals math +math.bitwise math.order math.vectors namespaces sequences strings +system threads ui ui.backend ui.clipboards ui.event-loop ui.gadgets +ui.gadgets.editors ui.gadgets.private ui.gadgets.worlds ui.gestures +ui.pixel-formats ui.pixel-formats.private ui.private ; IN: ui.backend.gtk SINGLETON: gtk-ui-backend @@ -285,7 +284,6 @@ CONSTANT: action-key-codes GENERIC: support-input-methods? ( gadget -- ? ) GENERIC: get-cursor-surrounding ( gadget -- text cursor-pos ) GENERIC: delete-cursor-surrounding ( offset count gadget -- ) -GENERIC: set-preedit-string ( str cursor-pos gadget -- ) GENERIC: get-cursor-loc&dim ( gadget -- loc dim ) M: gadget support-input-methods? drop f ; @@ -298,9 +296,6 @@ M: editor get-cursor-surrounding M: editor delete-cursor-surrounding 3drop ; -M: editor set-preedit-string - 3drop ; - M: editor get-cursor-loc&dim [ caret-loc ] [ caret-dim ] bi ; @@ -314,29 +309,13 @@ M: editor get-cursor-loc&dim window world-focus dup support-input-methods? [ delete-cursor-surrounding t ] [ 3drop f ] if nip ; -: get-preedit-string ( im-context -- str cursor-pos ) - { pointer: gchar gint } [ f swap gtk_im_context_get_preedit_string ] - with-out-parameters - [ [ utf8 alien>string ] [ g_free ] bi ] dip ; - -: on-preedit-changed ( im-context win -- ) - window world-focus dup support-input-methods? [ - [ get-preedit-string ] dip set-preedit-string - ] [ 2drop ] if ; - : on-commit ( im-context str win -- ) [ drop ] [ utf8 alien>string ] [ window ] tri* user-input ; -: gadget-location ( gadget -- loc ) - [ loc>> ] [ parent>> [ gadget-location v+ ] when* ] bi ; - : gadget-cursor-location ( gadget -- rectangle ) - [ gadget-location ] [ get-cursor-loc&dim ] bi [ v+ ] dip - [ first2 ] bi@ - ! fixnum ] bi@ ] bi@ cairo_rectangle_int_t ; - ! workaround> - ! GdkRectangle ; : update-cursor-location ( im-context gadget -- ) gadget-cursor-location gtk_im_context_set_cursor_location ; @@ -373,8 +352,6 @@ M: editor get-cursor-loc&dim GtkIMContext:retrieve-surrounding win connect-signal-with-data im "delete-surrounding" [ on-delete-surrounding yield ] GtkIMContext:delete-surrounding win connect-signal-with-data - im "preedit-changed" [ on-preedit-changed yield ] - GtkIMContext:preedit-changed win connect-signal-with-data win "key-press-event" [ im-on-key-event yield ] GtkWidget:key-press-event im connect-signal-with-data From aa82d106ce31822dbb8296c7db5a4fffa70e3fb7 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Mon, 15 Nov 2010 21:51:49 +0600 Subject: [PATCH 56/76] gobject-introspection: remove tests (because they don't work); --- .../tests/codegen.factor | 267 -- .../tests/everything/Everything-1.0.gir | 2340 ----------- .../tests/everything/everything.factor | 5 - .../tests/everything/ffi/ffi.factor | 19 - .../GIMarshallingTests-1.0.gir | 3600 ----------------- .../g-i-marshalling-tests/ffi/ffi.factor | 19 - .../g-i-marshalling-tests.factor | 5 - .../tests/marshalling.factor | 295 -- 8 files changed, 6550 deletions(-) delete mode 100644 basis/gobject-introspection/tests/codegen.factor delete mode 100644 basis/gobject-introspection/tests/everything/Everything-1.0.gir delete mode 100644 basis/gobject-introspection/tests/everything/everything.factor delete mode 100644 basis/gobject-introspection/tests/everything/ffi/ffi.factor delete mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir delete mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor delete mode 100644 basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor delete mode 100644 basis/gobject-introspection/tests/marshalling.factor diff --git a/basis/gobject-introspection/tests/codegen.factor b/basis/gobject-introspection/tests/codegen.factor deleted file mode 100644 index 0a28b68174..0000000000 --- a/basis/gobject-introspection/tests/codegen.factor +++ /dev/null @@ -1,267 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: glib.ffi gobject-introspection.tests.everything.ffi -io.streams.string see tools.test ; -IN: gobject-introspection.tests.godegen - -! Constants - -[ "IN: glib.ffi -CONSTANT: G_ASCII_DTOSTR_BUF_SIZE 39 inline -" ] [ - [ \ G_ASCII_DTOSTR_BUF_SIZE see ] with-string-writer -] unit-test - -[ "IN: glib.ffi -CONSTANT: G_CSET_a_2_z \"abcdefghijklmnopqrstuvwxyz\" inline -" ] [ - [ \ G_CSET_a_2_z see ] with-string-writer -] unit-test - -[ "IN: glib.ffi -CONSTANT: G_E 2.71828182846 inline -" ] [ - [ \ G_E see ] with-string-writer -] unit-test - -! Enumerations - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -TYPEDEF: int TestEnum -" ] [ - [ \ TestEnum see ] with-string-writer -] unit-test - -[ "IN: gobject-introspection.tests.everything.ffi -CONSTANT: TEST_VALUE1 0 inline -" ] [ - [ \ TEST_VALUE1 see ] with-string-writer -] unit-test - -[ "IN: gobject-introspection.tests.everything.ffi -CONSTANT: TEST_VALUE3 42 inline -" ] [ - [ \ TEST_VALUE3 see ] with-string-writer -] unit-test - -! Bitfields - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -TYPEDEF: int TestFlags -" ] [ - [ \ TestFlags see ] with-string-writer -] unit-test - -[ "IN: gobject-introspection.tests.everything.ffi -CONSTANT: TEST_FLAG2 2 inline -" ] [ - [ \ TEST_FLAG2 see ] with-string-writer -] unit-test - -! Functions - -[ "USING: alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - gint test_int ( gint in ) ; -" ] [ - [ \ test_int see ] with-string-writer -] unit-test - -! - throws - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - gboolean test_torture_signature_1 - ( int x, double* y, int* z, char* foo, int* q, guint m, - GError** error ) ; -" ] [ - [ \ test_torture_signature_1 see ] with-string-writer -] unit-test - -! Records - -[ "USING: alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -C-TYPE: TestSimpleBoxedA -" ] [ - [ \ TestSimpleBoxedA see ] with-string-writer -] unit-test - -[ "USING: classes.struct glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -STRUCT: TestBoxed - { some_int8 gint8 initial: 0 } - { nested_a TestSimpleBoxedA } { priv TestBoxedPrivate* } ; -" ] [ - [ \ TestBoxed see ] with-string-writer -] unit-test - -! - constructors - -[ "USING: alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - TestBoxed* test_boxed_new ( ) ; -" ] [ - [ \ test_boxed_new see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - TestBoxed* test_boxed_new_alternative_constructor1 - ( int i ) ; -" ] [ - [ \ test_boxed_new_alternative_constructor1 see ] with-string-writer -] unit-test - -! - functions - -! - methods - -[ "USING: alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - TestBoxed* test_boxed_copy ( TestBoxed* self ) ; -" ] [ - [ \ test_boxed_copy see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - void test_struct_a_clone - ( TestStructA* self, TestStructA* a_out ) ; -" ] [ - [ \ test_struct_a_clone see ] with-string-writer -] unit-test - -! Classes - -[ "USING: alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -C-TYPE: TestObj -" ] [ - [ \ TestObj see ] with-string-writer -] unit-test - -! - get_type - -[ "USING: alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - GType test_obj_get_type ( ) ; -" ] [ - [ \ test_obj_get_type see ] with-string-writer -] unit-test - -! - constructors - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - TestObj* test_obj_new_from_file ( char* x, GError** error ) - ; -" ] [ - [ \ test_obj_new_from_file see ] with-string-writer -] unit-test - -[ "USING: alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - TestObj* test_obj_new_callback - ( TestCallbackUserData callback, gpointer user_data, - GDestroyNotify notify ) ; -" ] [ - [ \ test_obj_new_callback see ] with-string-writer -] unit-test - -! - functions - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - double test_obj_static_method ( int x ) ; -" ] [ - [ \ test_obj_static_method see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - void test_obj_static_method_callback - ( TestCallback callback ) ; -" ] [ - [ \ test_obj_static_method_callback see ] with-string-writer -] unit-test - -! - methods - -[ "USING: alien.c-types alien.syntax gobject.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - void test_obj_set_bare ( TestObj* self, GObject* bare ) ; -" ] [ - [ \ test_obj_set_bare see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - int test_obj_instance_method ( TestObj* self ) ; -" ] [ - [ \ test_obj_instance_method see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything FUNCTION: - gboolean test_obj_torture_signature_1 - ( TestObj* self, int x, double* y, int* z, char* foo, int* - q, guint m, GError** error ) ; -" ] [ - [ \ test_obj_torture_signature_1 see ] with-string-writer -] unit-test - -! - signals - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything CALLBACK: - void TestObj:test ( TestObj* sender, gpointer user_data ) ; -" ] [ - [ \ TestObj:test see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything CALLBACK: - void TestObj:test-with-static-scope-arg - ( TestObj* sender, TestSimpleBoxedA* object, gpointer - user_data ) ; -" ] [ - [ \ TestObj:test-with-static-scope-arg see ] with-string-writer -] unit-test - -! Callbacks - -[ "USING: alien.c-types alien.syntax ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything CALLBACK: - int TestCallback ( ) ; -" ] [ - [ \ TestCallback see ] with-string-writer -] unit-test - -[ "USING: alien.c-types alien.syntax glib.ffi ; -IN: gobject-introspection.tests.everything.ffi -LIBRARY: gobject-introspection.tests.everything CALLBACK: - int TestCallbackUserData ( gpointer user_data ) ; -" ] [ - [ \ TestCallbackUserData see ] with-string-writer -] unit-test - diff --git a/basis/gobject-introspection/tests/everything/Everything-1.0.gir b/basis/gobject-introspection/tests/everything/Everything-1.0.gir deleted file mode 100644 index aa7de3b4b6..0000000000 --- a/basis/gobject-introspection/tests/everything/Everything-1.0.gir +++ /dev/null @@ -1,2340 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This method is virtual. Notably its name differs from the virtual -slot name, which makes it useful for testing bindings handle this -case. - - - - - - Meaningless string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This function throws an error if m is odd. - - - - - - - - - - - - - - - - - - - - - - - - - - This method is virtual. Notably its name differs from the virtual -slot name, which makes it useful for testing bindings handle this -case. - - - - - - Meaningless string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Meaningless string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Make a copy of a TestStructA - - - - - - the cloned structure - - - - - - - - - - - - - - Make a copy of a TestStructB - - - - - - the cloned structure - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - the sum of the items in @ints - - - - - a list of 5 integers - - - - - - - - - - - - - a list of 5 integers ranging from 0 to 4 - - - - - - - - - a list of 5 integers ranging from 0 to 4 - - - - - - - - - - - - - - - List of ints - - - - - - - - - - - - - - - - List of ints - - - - - - - - - - - - - - - - List of ints - - - - - - - - - - - - - - - - List of ints - - - - - - - - - string representation of provided types - - - - - - - - List of types - - - - - - - - - a new array of integers. - - - - - - - length of the returned array. - - - - - - - - - - - - - - List of ints - - - - - - - - - - - - - - - - List of ints - - - - - - - - - - - - - the length of @ints - - - - a list of integers whose items will be increased by 1, except the first that will be dropped - - - - - - - - - a static array of integers. - - - - - - - length of the returned array. - - - - - - - - - - - - - - - - length - - - - - - - - - - - - - - - - length - - - - - - - - - - - the length of @ints - - - - a list of 5 integers, from 0 to 4 in consecutive order - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Notified - callback persists until a DestroyNotify delegate -is invoked. - - - - - - - - - - - - - - - - - - - - - - Invokes all callbacks installed by #test_callback_destroy_notify(), -adding up their return values, and removes them, invoking the -corresponding destroy notfications. - - Sum of the return values of the invoked callbacks. - - - - - Call - callback parameter persists for the duration of the method -call and can be released on return. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - list of strings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Specify nested parameterized types directly with the (type ) annotation. - - - - - - - - - - - - element-type annotation. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - A #TestObj - - - - - - - - - - - A #TestObj - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - No annotations here. We want the default to Do The Right Thing. - - - - - - - - No annotations here. We want the default to Do The Right Thing. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This function throws an error if m is odd. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <const char*> UTF-8 string - - - - - - - - - - - - - - - - - - - - - - - - - - <char*> UTF-8 string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - a copy of "first" - - - - - a copy of "second" - - - - - - - - - - - a copy of "first" - - - - a copy of "second" - - - - - - - - - - - - - - - - - the int wrapped in a GValue. - - - - - an int - - - - - - - - - - - - - - - - - - - diff --git a/basis/gobject-introspection/tests/everything/everything.factor b/basis/gobject-introspection/tests/everything/everything.factor deleted file mode 100644 index bfb94a842c..0000000000 --- a/basis/gobject-introspection/tests/everything/everything.factor +++ /dev/null @@ -1,5 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: gobject-introspection.tests.everything.ffi ; -IN: gobject-introspection.tests.everything - diff --git a/basis/gobject-introspection/tests/everything/ffi/ffi.factor b/basis/gobject-introspection/tests/everything/ffi/ffi.factor deleted file mode 100644 index d4a7c2ff34..0000000000 --- a/basis/gobject-introspection/tests/everything/ffi/ffi.factor +++ /dev/null @@ -1,19 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system -gobject-introspection cairo.ffi gio.ffi glib.ffi gobject.ffi ; -IN: gobject-introspection.tests.everything.ffi - -<< -"gobject-introspection.tests.everything" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgirepository-everything-1.0.so" cdecl add-library ] } -} cond ->> - -IMPLEMENT-STRUCTS: TestBoxed ; - -GIR: vocab:gobject-introspection/tests/everything/Everything-1.0.gir - diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir b/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir deleted file mode 100644 index 56d62773c6..0000000000 --- a/basis/gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir +++ /dev/null @@ -1,3600 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - an array of strings - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor b/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor deleted file mode 100644 index 3bf08bd601..0000000000 --- a/basis/gobject-introspection/tests/g-i-marshalling-tests/ffi/ffi.factor +++ /dev/null @@ -1,19 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system -gobject-introspection glib.ffi gobject.ffi ; -IN: gobject-introspection.tests.g-i-marshalling-tests.ffi - -<< -"gobject-introspection.tests.g-i-marshalling-tests" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgirepository-gimarshallingtests-1.0.so" cdecl add-library ] } -} cond ->> - -IMPLEMENT-STRUCTS: GIMarshallingTestsSimpleStruct ; - -GIR: vocab:gobject-introspection/tests/g-i-marshalling-tests/GIMarshallingTests-1.0.gir - diff --git a/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor b/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor deleted file mode 100644 index bde6d26e4c..0000000000 --- a/basis/gobject-introspection/tests/g-i-marshalling-tests/g-i-marshalling-tests.factor +++ /dev/null @@ -1,5 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: gobject-introspection.tests.g-i-marshalling-tests.ffi ; -IN: gobject-introspection.tests.g-i-marshalling-tests - diff --git a/basis/gobject-introspection/tests/marshalling.factor b/basis/gobject-introspection/tests/marshalling.factor deleted file mode 100644 index eecf21a381..0000000000 --- a/basis/gobject-introspection/tests/marshalling.factor +++ /dev/null @@ -1,295 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien.c-types alien.data alien.strings -alien.syntax arrays classes.struct destructors -gobject-introspection.tests.g-i-marshalling-tests.ffi -glib.ffi gobject.ffi io.encodings.utf8 kernel literals -sequences specialized-arrays tools.test ; -IN: gobject-introspection.tests.marshalling - -SPECIALIZED-ARRAYS: gint gshort void* -GIMarshallingTestsSimpleStruct ; - -CONSTANT: G_I_MARSHALLING_TESTS_CONSTANT_NUMBER 42 - -CONSTANT: G_I_MARSHALLING_TESTS_CONSTANT_UTF8 "const ♥ utf8" - -! gboolean - -[ t ] [ g_i_marshalling_tests_boolean_return_true ] unit-test -[ f ] [ g_i_marshalling_tests_boolean_return_false ] unit-test - -: boolean-out-true ( -- out ) - { gboolean } [ g_i_marshalling_tests_boolean_out_true ] - with-out-parameters ; -[ t ] [ boolean-out-true ] unit-test - -: boolean-out-false ( -- out ) - { gboolean } [ g_i_marshalling_tests_boolean_out_false ] - with-out-parameters ; -[ f ] [ boolean-out-false ] unit-test - -! gint8 - -[ $ G_MAXINT8 ] [ g_i_marshalling_tests_int8_return_max ] unit-test -[ $ G_MININT8 ] [ g_i_marshalling_tests_int8_return_min ] unit-test - -: int8-out-max ( -- out ) - { gint8 } [ g_i_marshalling_tests_int8_out_max ] - with-out-parameters ; -[ $ G_MAXINT8 ] [ int8-out-max ] unit-test - -: int8-out-min ( -- out ) - { gint8 } [ g_i_marshalling_tests_int8_out_min ] - with-out-parameters ; -[ $ G_MININT8 ] [ int8-out-min ] unit-test - -: int8-inout-max-min ( -- out ) - { { gint8 initial: $ G_MAXINT8 } } - [ g_i_marshalling_tests_int8_inout_max_min ] - with-out-parameters ; -[ $ G_MININT8 ] [ int8-inout-max-min ] unit-test - -! guint8 - -[ $ G_MAXUINT8 ] [ g_i_marshalling_tests_uint8_return ] unit-test - -: uint8-out ( -- out ) - { guint8 } [ g_i_marshalling_tests_uint8_out ] - with-out-parameters ; -[ $ G_MAXUINT8 ] [ uint8-out ] unit-test - -: uint8-inout ( -- out ) - { { guint8 initial: $ G_MAXUINT8 } } - [ g_i_marshalling_tests_uint8_inout ] - with-out-parameters ; -[ 0 ] [ uint8-inout ] unit-test - -! gint16 - -[ $ G_MAXINT16 ] [ g_i_marshalling_tests_int16_return_max ] unit-test -[ $ G_MININT16 ] [ g_i_marshalling_tests_int16_return_min ] unit-test - -: int16-out-max ( -- out ) - { gint16 } [ g_i_marshalling_tests_int16_out_max ] - with-out-parameters ; -[ $ G_MAXINT16 ] [ int16-out-max ] unit-test - -: int16-out-min ( -- out ) - { gint16 } [ g_i_marshalling_tests_int16_out_min ] - with-out-parameters ; -[ $ G_MININT16 ] [ int16-out-min ] unit-test - -: int16-inout-max-min ( -- out ) - { { gint16 initial: $ G_MAXINT16 } } - [ g_i_marshalling_tests_int16_inout_max_min ] - with-out-parameters ; -[ $ G_MININT16 ] [ int16-inout-max-min ] unit-test - -! guint16 - -[ $ G_MAXUINT16 ] [ g_i_marshalling_tests_uint16_return ] unit-test - -: uint16-out ( -- out ) - { guint16 } [ g_i_marshalling_tests_uint16_out ] - with-out-parameters ; -[ $ G_MAXUINT16 ] [ uint16-out ] unit-test - -: uint16-inout ( -- out ) - { { guint16 initial: $ G_MAXUINT16 } } - [ g_i_marshalling_tests_uint16_inout ] - with-out-parameters ; -[ 0 ] [ uint16-inout ] unit-test - -! gint32 - -[ $ G_MAXINT32 ] [ g_i_marshalling_tests_int32_return_max ] unit-test -[ $ G_MININT32 ] [ g_i_marshalling_tests_int32_return_min ] unit-test - -: int32-out-max ( -- out ) - { gint32 } [ g_i_marshalling_tests_int32_out_max ] - with-out-parameters ; -[ $ G_MAXINT32 ] [ int32-out-max ] unit-test - -: int32-out-min ( -- out ) - { gint32 } [ g_i_marshalling_tests_int32_out_min ] - with-out-parameters ; -[ $ G_MININT32 ] [ int32-out-min ] unit-test - -: int32-inout-max-min ( -- out ) - { { gint32 initial: $ G_MAXINT32 } } - [ g_i_marshalling_tests_int32_inout_max_min ] - with-out-parameters ; -[ $ G_MININT32 ] [ int32-inout-max-min ] unit-test - -! guint32 - -[ $ G_MAXUINT32 ] [ g_i_marshalling_tests_uint32_return ] unit-test - -: uint32-out ( -- out ) - { guint32 } [ g_i_marshalling_tests_uint32_out ] - with-out-parameters ; -[ $ G_MAXUINT32 ] [ uint32-out ] unit-test - -: uint32-inout ( -- out ) - { { guint32 initial: $ G_MAXUINT32 } } - [ g_i_marshalling_tests_uint32_inout ] - with-out-parameters ; -[ 0 ] [ uint32-inout ] unit-test - -! gint64 - -[ $ G_MAXINT64 ] [ g_i_marshalling_tests_int64_return_max ] unit-test -[ $ G_MININT64 ] [ g_i_marshalling_tests_int64_return_min ] unit-test - -: int64-out-max ( -- out ) - { gint64 } [ g_i_marshalling_tests_int64_out_max ] - with-out-parameters ; -[ $ G_MAXINT64 ] [ int64-out-max ] unit-test - -: int64-out-min ( -- out ) - { gint64 } [ g_i_marshalling_tests_int64_out_min ] - with-out-parameters ; -[ $ G_MININT64 ] [ int64-out-min ] unit-test - -: int64-inout-max-min ( -- out ) - { { gint64 initial: $ G_MAXINT64 } } - [ g_i_marshalling_tests_int64_inout_max_min ] - with-out-parameters ; -[ $ G_MININT64 ] [ int64-inout-max-min ] unit-test - -! guint64 - -[ $ G_MAXUINT64 ] [ g_i_marshalling_tests_uint64_return ] unit-test - -: uint64-out ( -- out ) - { guint64 } [ g_i_marshalling_tests_uint64_out ] - with-out-parameters ; -[ $ G_MAXUINT64 ] [ uint64-out ] unit-test - -: uint64-inout ( -- out ) - { { guint64 initial: $ G_MAXUINT64 } } - [ g_i_marshalling_tests_uint64_inout ] - with-out-parameters ; -[ 0 ] [ uint64-inout ] unit-test - -! gssize -! gsize -! gfloat -! gdouble -! time_t - -! gtype - -[ $ G_TYPE_NONE ] -[ g_i_marshalling_tests_gtype_return ] unit-test - -: gtype-out ( -- out ) - { GType } [ g_i_marshalling_tests_gtype_out ] - with-out-parameters ; -[ $ G_TYPE_NONE ] [ gtype-out ] unit-test - -: gtype-inout ( -- out ) - { { GType initial: $ G_TYPE_NONE } } - [ g_i_marshalling_tests_gtype_inout ] - with-out-parameters ; -[ $ G_TYPE_INT ] [ gtype-inout ] unit-test - -! strings - -[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] -[ g_i_marshalling_tests_utf8_none_return utf8 alien>string ] unit-test - -[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] [ - [ - g_i_marshalling_tests_utf8_full_return &g_free - utf8 alien>string - ] with-destructors -] unit-test - -: utf8-none-out ( -- out ) - { pointer: gchar } - [ g_i_marshalling_tests_utf8_none_out ] - with-out-parameters ; -[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] -[ utf8-none-out utf8 alien>string ] unit-test - -: utf8-full-out ( -- out ) - { pointer: gchar } - [ g_i_marshalling_tests_utf8_full_out ] - with-out-parameters ; -[ $ G_I_MARSHALLING_TESTS_CONSTANT_UTF8 ] [ - [ utf8-full-out &g_free utf8 alien>string ] with-destructors -] unit-test - -: utf8-dangling-out ( -- out ) - { { pointer: gchar initial: f } } - [ g_i_marshalling_tests_utf8_dangling_out ] - with-out-parameters ; -[ f ] -[ utf8-dangling-out ] unit-test - -! arrays - -[ int-array{ -1 0 1 2 } ] -[ - g_i_marshalling_tests_array_fixed_int_return - 4 >int-array -] unit-test - -[ short-array{ -1 0 1 2 } ] -[ - g_i_marshalling_tests_array_fixed_short_return - 4 >short-array -] unit-test - -: array-fixed-out ( -- out ) - { pointer: gint } - [ g_i_marshalling_tests_array_fixed_out ] - with-out-parameters ; -[ int-array{ -1 0 1 2 } ] -[ - array-fixed-out - 4 >int-array -] unit-test - -: array-fixed-out-struct ( -- out ) - { pointer: gint } - [ g_i_marshalling_tests_array_fixed_out_struct ] - with-out-parameters ; -[ { { 7 6 } { 6 7 } } ] -[ - array-fixed-out-struct - 2 - [ [ long_>> ] [ int8>> ] bi 2array ] { } map-as -] unit-test - -: array-return ( -- array length ) - { gint } - [ g_i_marshalling_tests_array_return ] - with-out-parameters ; -[ int-array{ -1 0 1 2 } ] -[ array-return >int-array ] unit-test - -: array-out ( -- array length ) - { pointer: gint gint } - [ g_i_marshalling_tests_array_out ] - with-out-parameters ; -[ int-array{ -1 0 1 2 } ] -[ array-out >int-array ] unit-test - -[ { "0" "1" "2" f } ] -[ - g_i_marshalling_tests_array_zero_terminated_return - 4 [ utf8 alien>string ] { } map-as -] unit-test - -: array-zero-terminated-out ( -- out ) - { pointer: pointer: gchar } - [ g_i_marshalling_tests_array_zero_terminated_out ] - with-out-parameters ; -[ { "0" "1" "2" f } ] -[ - array-zero-terminated-out - 4 [ utf8 alien>string ] { } map-as -] unit-test From 1ac8afc236056a3df2cc9cf2cd710f1628edb168 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 20 Nov 2010 21:15:50 +0600 Subject: [PATCH 57/76] move gtk samples from extra/gir/samples/lowlevel to gtk-samples; fix gtk-samples; --- extra/gir/samples/lowlevel/lowlevel.factor | 78 ------------------- extra/gir/samples/lowlevel/opengl/authors.txt | 1 - .../hello-world}/authors.txt | 0 .../hello-world/hello-world.factor | 13 ++-- .../opengl}/authors.txt | 0 .../opengl/opengl.factor | 10 +-- 6 files changed, 13 insertions(+), 89 deletions(-) delete mode 100644 extra/gir/samples/lowlevel/lowlevel.factor delete mode 100644 extra/gir/samples/lowlevel/opengl/authors.txt rename extra/{gir/samples/lowlevel => gtk-samples/hello-world}/authors.txt (100%) rename extra/{gir/samples/lowlevel => gtk-samples}/hello-world/hello-world.factor (77%) rename extra/{gir/samples/lowlevel/hello-world => gtk-samples/opengl}/authors.txt (100%) rename extra/{gir/samples/lowlevel => gtk-samples}/opengl/opengl.factor (91%) diff --git a/extra/gir/samples/lowlevel/lowlevel.factor b/extra/gir/samples/lowlevel/lowlevel.factor deleted file mode 100644 index 795d3cfba4..0000000000 --- a/extra/gir/samples/lowlevel/lowlevel.factor +++ /dev/null @@ -1,78 +0,0 @@ -! Copyright (C) 2010 Anton Gorenko. -! See http://factorcode.org/license.txt for BSD license. -USING: alien.c-types alien.strings byte-arrays classes.struct -glib.ffi gobject.ffi gtk.ffi io.encodings.utf8 kernel -literals locals make math prettyprint sequences specialized-arrays -gir.samples.lowlevel.hello-world -gir.samples.lowlevel.opengl -gir.samples.lowlevel.gstreamer ; -IN: gir.samples.lowlevel - -SPECIALIZED-ARRAY: ulong - -CONSTANT: samples { - { "hello-world" "Simple 'Hello world!' program" [ hello-world-win ] } - { "opengl" "GtkGLExt sample program" [ opengl-win ] } - { "gstreamer" "Small GStreamer-based multimedia player " [ gstreamer-win ] } -} - -:: list-on-row-activited ( sender path column user_data -- ) - path gtk_tree_path_get_indices *int samples nth last - call( -- win ) gtk_widget_show_all ; - -:: main ( -- ) - f f gtk_init - - GTK_WINDOW_TOPLEVEL gtk_window_new :> window - - window - [ "Low-level Gtk samples" utf8 string>alien gtk_window_set_title ] - [ 300 400 gtk_window_set_default_size ] - [ GTK_WIN_POS_CENTER gtk_window_set_position ] tri - - gtk_tree_view_new :> list - list f gtk_tree_view_set_headers_visible - - gtk_cell_renderer_text_new :> renderer - gtk_tree_view_column_new :> column - column "Sample" utf8 string>alien gtk_tree_view_column_set_title - column renderer t gtk_tree_view_column_pack_start - column renderer "markup" utf8 string>alien 0 gtk_tree_view_column_add_attribute - list column gtk_tree_view_append_column drop - - ulong-array{ $ G_TYPE_STRING } - [ length ] keep gtk_list_store_newv :> store - - list store gtk_tree_view_set_model - - store g_object_unref - - GtkTreeIter :> iter - GValue :> value - value G_TYPE_STRING g_value_init drop - samples [ - first2 swap [ "" % % "\n" % % ] "" make - value swap utf8 string>alien g_value_set_string - store iter gtk_list_store_append - store iter 0 value gtk_list_store_set_value - ] each - - list 300 300 gtk_widget_set_size_request - - window list gtk_container_add - - list "row-activated" - utf8 string>alien - [ list-on-row-activited ] GtkTreeView:row-activated - f f 0 g_signal_connect_data drop - - window "destroy" utf8 string>alien - [ 2drop gtk_main_quit ] GtkObject:destroy - f f 0 g_signal_connect_data drop - - window gtk_widget_show_all - - gtk_main ; - -MAIN: main - diff --git a/extra/gir/samples/lowlevel/opengl/authors.txt b/extra/gir/samples/lowlevel/opengl/authors.txt deleted file mode 100644 index ce9bcc8313..0000000000 --- a/extra/gir/samples/lowlevel/opengl/authors.txt +++ /dev/null @@ -1 +0,0 @@ -Anton Gorenko \ No newline at end of file diff --git a/extra/gir/samples/lowlevel/authors.txt b/extra/gtk-samples/hello-world/authors.txt similarity index 100% rename from extra/gir/samples/lowlevel/authors.txt rename to extra/gtk-samples/hello-world/authors.txt diff --git a/extra/gir/samples/lowlevel/hello-world/hello-world.factor b/extra/gtk-samples/hello-world/hello-world.factor similarity index 77% rename from extra/gir/samples/lowlevel/hello-world/hello-world.factor rename to extra/gtk-samples/hello-world/hello-world.factor index b1bcf029d5..fd0b609160 100644 --- a/extra/gir/samples/lowlevel/hello-world/hello-world.factor +++ b/extra/gtk-samples/hello-world/hello-world.factor @@ -2,8 +2,11 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien.strings gobject.ffi gtk.ffi io.encodings.utf8 kernel locals ; -IN: gir.samples.lowlevel.hello-world +IN: gtk-samples.hello-world +: on-button-clicked ( button label-user-data -- ) + nip "Hello! :)" utf8 string>alien gtk_label_set_text ; + :: hello-world-win ( -- window ) GTK_WINDOW_TOPLEVEL gtk_window_new :> window @@ -23,8 +26,8 @@ IN: gir.samples.lowlevel.hello-world frame label 120 110 gtk_fixed_put button "clicked" utf8 string>alien - [ nip "Hello! :)" utf8 string>alien gtk_label_set_text t ] GtkButton:clicked - label f 0 g_signal_connect_data drop + [ on-button-clicked ] GtkButton:clicked label + g_signal_connect drop window ; @@ -33,8 +36,8 @@ IN: gir.samples.lowlevel.hello-world hello-world-win :> window window "destroy" utf8 string>alien - [ 2drop gtk_main_quit ] GtkObject:destroy - f f 0 g_signal_connect_data drop + [ 2drop gtk_main_quit ] GtkObject:destroy f + g_signal_connect drop window gtk_widget_show_all diff --git a/extra/gir/samples/lowlevel/hello-world/authors.txt b/extra/gtk-samples/opengl/authors.txt similarity index 100% rename from extra/gir/samples/lowlevel/hello-world/authors.txt rename to extra/gtk-samples/opengl/authors.txt diff --git a/extra/gir/samples/lowlevel/opengl/opengl.factor b/extra/gtk-samples/opengl/opengl.factor similarity index 91% rename from extra/gir/samples/lowlevel/opengl/opengl.factor rename to extra/gtk-samples/opengl/opengl.factor index 52d658c0b8..619e95ede5 100644 --- a/extra/gir/samples/lowlevel/opengl/opengl.factor +++ b/extra/gtk-samples/opengl/opengl.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: alien.strings gdk.gl.ffi gobject.ffi gtk.ffi gtk.gl.ffi io.encodings.utf8 kernel locals opengl.gl ; -IN: gir.samples.lowlevel.opengl +IN: gtk-samples.opengl ! This sample is based on ! http://code.valaide.org/content/simple-opengl-sample-using-gtkglext @@ -55,12 +55,12 @@ IN: gir.samples.lowlevel.opengl gtk_widget_set_gl_capability drop window "configure-event" utf8 string>alien - [ on-configure ] GtkWidget:configure-event - f f 0 g_signal_connect_data drop + [ on-configure ] GtkWidget:configure-event f + g_signal_connect drop window "expose-event" utf8 string>alien - [ on-expose ] GtkWidget:expose-event - f f 0 g_signal_connect_data drop + [ on-expose ] GtkWidget:expose-event f + g_signal_connect drop window ; From 8352fdf59a53079df4a3cbb70a75a3a7cec04c04 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 20 Nov 2010 21:27:47 +0600 Subject: [PATCH 58/76] clutter: update; --- extra/clutter/Clutter-1.0.gir | 38733 +++++++++++++++-------- extra/clutter/cogl/Cogl-1.0.gir | 6718 ++-- extra/clutter/cogl/ffi/ffi.factor | 20 +- extra/clutter/ffi/ffi.factor | 17 +- extra/clutter/gtk/GtkClutter-0.10.gir | 583 +- extra/clutter/gtk/ffi/ffi.factor | 13 +- extra/clutter/json/ClutterJson-1.0.gir | 1549 - extra/clutter/json/Json-1.0.gir | 2925 ++ extra/clutter/json/ffi/ffi.factor | 13 +- 9 files changed, 33359 insertions(+), 17212 deletions(-) delete mode 100644 extra/clutter/json/ClutterJson-1.0.gir create mode 100644 extra/clutter/json/Json-1.0.gir diff --git a/extra/clutter/Clutter-1.0.gir b/extra/clutter/Clutter-1.0.gir index fd67f1e174..e8fc46fe3f 100644 --- a/extra/clutter/Clutter-1.0.gir +++ b/extra/clutter/Clutter-1.0.gir @@ -2,298 +2,316 @@ - - + + + - - - + + c:identifier-prefixes="Clutter" + c:symbol-prefixes="clutter"> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + The <structname>ClutterAction</structname> structure contains only +private data and should be accessed using the provided API + + + + + + The <structname>ClutterActionClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Base class for actors. + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Called by the parent of an actor to assign the actor its size. +Should never be called by applications (except when implementing +a container or layout manager). +Actors can know from their allocation box whether they have moved +with respect to their parent actor. The @flags parameter describes +additional information about the allocation, for instance whether +the parent has moved with respect to the stage, for example because +a grandparent's origin has moved. + new allocation of the actor, in parent-relative coordinates + flags that control the allocation @@ -308,406 +326,333 @@ to the parent implementation." - + + Returns the accessible object that describes the actor to an +assistive technology. +If no class-specific #AtkObject implementation is available for the +actor instance in question, it will inherit an #AtkObject +implementation from the first ancestor class for which such an +implementation is defined. +The documentation of the <ulink +url="http://developer.gnome.org/doc/API/2.0/atk/index.html">ATK</ulink> +library contains more information about accessible objects and +their uses. + + the #AtkObject associated with @actor + + + + + Computes the requested minimum and natural heights for an actor, +or if they are already computed, returns the cached values. +An actor may not get its request - depending on the layout +manager that's in effect. +A request should not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. - - + + available width to assume in computing desired height, or a negative value to indicate that no width is defined + + + + return location for minimum height, or %NULL + + + + return location for natural height, or %NULL + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Computes the requested minimum and natural widths for an actor, optionally depending on the specified height, or if they are already computed, returns the cached values. An actor may not get its request - depending on the layout -manager that's in effect. -A request should not incorporate the actor's scale or anchor point; -those transformations do not affect layout, only rendering." - version="0.8"> +manager that's in effect. +A request should not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. - - + + available height when computing the preferred width, or a negative value to indicate that no height is defined + - + allow-none="1"> + return location for minimum width, or %NULL + - + allow-none="1"> + return location for the natural width, or %NULL + - - + + + Calls clutter_actor_hide() on all child actors (if any). + + + + + + Sets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly maps +and realizes its children if they are visible. Does nothing if the +actor is not visible. +#ClutterActor <function>map()</function> virtual function in an actor +and you need to map the children of that actor. It is not necessary +to call this if you implement #ClutterContainer because the default +implementation will automatically map children of containers. +When overriding map, it is mandatory to chain up to the parent +implementation. + + + + + + Calls clutter_actor_show() on all children of an actor (if any). + + + + + + Unsets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly +unmaps its children if they were mapped. +#ClutterActor <function>unmap()</function> virtual function in an actor +and you need to unmap the children of that actor. It is not necessary +to call this if you implement #ClutterContainer because the default +implementation will automatically unmap children of containers. +When overriding unmap, it is mandatory to chain up to the parent +implementation. + + + + + + Adds @action to the list of actions applied to @self +A #ClutterAction can only belong to one actor at a time +The #ClutterActor will hold a reference on @action until either +clutter_actor_remove_action() or clutter_actor_clear_actions() +is called - - - - - - - - + + a #ClutterAction + - + + A convenience function for setting the name of a #ClutterAction +while adding it to the list of actions applied to @self +This function is the logical equivalent of: +|[ +clutter_actor_meta_set_name (CLUTTER_ACTOR_META (action), name); +clutter_actor_add_action (self, action); +]| - - + + the name to set on the action + - - + + a #ClutterAction + - - + + + + Adds @constraint to the list of #ClutterConstraint<!-- -->s applied +to @self +The #ClutterActor will hold a reference on the @constraint until +either clutter_actor_remove_constraint() or +clutter_actor_clear_constraints() is called. + + + + + + a #ClutterConstraint + - - + + + + A convenience function for setting the name of a #ClutterConstraint +while adding it to the list of constraints applied to @self +This function is the logical equivalent of: +|[ +clutter_actor_meta_set_name (CLUTTER_ACTOR_META (constraint), name); +clutter_actor_add_constraint (self, constraint); +]| + + + + + + the name to set on the constraint + + + + a #ClutterConstraint + + + + + + Adds @effect to the list of #ClutterEffect<!-- -->s applied to @self +The #ClutterActor will hold a reference on the @effect until either +clutter_actor_remove_effect() or clutter_actor_clear_effects() is +called. + + + + + + a #ClutterEffect + + + + + + A convenience function for setting the name of a #ClutterEffect +while adding it to the list of effectss applied to @self +This function is the logical equivalent of: +|[ +clutter_actor_meta_set_name (CLUTTER_ACTOR_META (effect), name); +clutter_actor_add_effect (self, effect); +]| + + + + + + the name to set on the effect + + + + a #ClutterEffect + + Called by the parent of an actor to assign the actor its size. Should never be called by applications (except when implementing a container or layout manager). Actors can know from their allocation box whether they have moved with respect to their parent actor. The @flags parameter describes additional information about the allocation, for instance whether the parent has moved with respect to the stage, for example because -a grandparent's origin has moved." - version="0.8"> +a grandparent's origin has moved. + new allocation of the actor, in parent-relative coordinates + flags that control the allocation - + + Allocates @self by taking into consideration the available allocation +area; an alignment factor on either axis; and whether the actor should +fill the allocation on either axis. +The @box should contain the available allocation width and height; +if the x1 and y1 members of #ClutterActorBox are not set to 0, the +allocation will be offset by their value. +This function takes into consideration the geometry request specified by +the #ClutterActor:request-mode property, and the text direction. +This function is useful for fluid layout managers, like #ClutterBinLayout +or #ClutterTableLayout + + a #ClutterActorBox, containing the available width and height + + + + the horizontal alignment, between 0 and 1 + + + + the vertical alignment, between 0 and 1 + + + + whether the actor should fill horizontally + + + + whether the actor should fill vertically + + + allocation flags to be passed to clutter_actor_allocate() + Allocates @self taking into account the #ClutterActor<!-- -->'s preferred size, but limiting it to the maximum available width and height provided. This function will do the right thing when dealing with the -actor's request mode. +actor's request mode. The implementation of this function is equivalent to: |[ if (request_mode == CLUTTER_REQUEST_HEIGHT_FOR_WIDTH) @@ -738,1539 +683,94 @@ box.y2 = box.y1 + available_height; clutter_actor_allocate (self, &amp;box, flags); ]| This function can be used by fluid layout managers to allocate -an actor's preferred size without making it bigger than the area -available for the container." - version="1.0"> +an actor's preferred size without making it bigger than the area +available for the container. - + the actor's X coordinate + - + the actor's Y coordinate + - - + + the maximum available width, or -1 to use the actor's natural width + - - + + the maximum available height, or -1 to use the actor's natural height + + flags controlling the allocation - + Allocates the natural size of @self. +This function is a utility call for #ClutterActor implementations +that allocates the actor's preferred natural size. It can be used +by fixed layout managers (like #ClutterGroup or so called +'composite actors') inside the ClutterActor::allocate +implementation to give each child exactly how much space it +requires. +This function is not meant to be used by applications. It is also +not meant to be used outside the implementation of the +ClutterActor::allocate virtual function. - - + + flags controlling the allocation + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Animates the given list of properties of @actor between the current value for each property and a new final value. The animation has a definite duration and a speed given by the @mode. For example, this: |[ clutter_actor_animate (rectangle, CLUTTER_LINEAR, 250, -"width", 100.0, -"height", 100.0, +"width", 100.0, +"height", 100.0, NULL); ]| -will make width and height properties of the #ClutterActor "rectangle" +will make width and height properties of the #ClutterActor "rectangle" grow linearly between the current value and 100 pixels, in 250 milliseconds. The animation @mode is a logical id, either from the #ClutterAnimationMode enumeration of from clutter_alpha_register_func(). All the properties specified will be animated between the current value and the final value. If a property should be set at the beginning of the animation but not updated during the animation, it should be prefixed -by the "fixed::" string, for instance: +by the "fixed::" string, for instance: |[ clutter_actor_animate (actor, CLUTTER_EASE_IN_SINE, 100, -"rotation-angle-z", 360.0, -"fixed::rotation-center-z", &amp;center, +"rotation-angle-z", 360.0, +"fixed::rotation-center-z", &amp;center, NULL); ]| -Will animate the "rotation-angle-z" property between the current value -and 360 degrees, and set the "rotation-center-z" property to the fixed -value of the #ClutterVertex "center". +Will animate the "rotation-angle-z" property between the current value +and 360 degrees, and set the "rotation-center-z" property to the fixed +value of the #ClutterVertex "center". This function will implicitly create a #ClutterAnimation object which will be assigned to the @actor and will be returned to the developer to control the animation or to know when the animation has been completed. -If a name argument starts with "signal::", "signal-after::", -"signal-swapped::" or "signal-swapped-after::" the two following arguments +If a name argument starts with "signal::", "signal-after::", +"signal-swapped::" or "signal-swapped-after::" the two following arguments are used as callback function and data for a signal handler installed on the #ClutterAnimation object for the specified signal name, for instance: |[ @@ -2281,25 +781,25 @@ ClutterActor *actor) clutter_actor_hide (actor); } clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 100, -"opacity", 0, -"signal::completed", on_animation_completed, actor, +"opacity", 0, +"signal::completed", on_animation_completed, actor, NULL); ]| or, to automatically destroy an actor at the end of the animation: |[ clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 100, -"opacity", 0, -"signal-swapped-after::completed", +"opacity", 0, +"signal-swapped-after::completed", clutter_actor_destroy, actor, NULL); ]| -The "signal::" modifier is the equivalent of using g_signal_connect(); -the "signal-after::" modifier is the equivalent of using +The "signal::" modifier is the equivalent of using g_signal_connect(); +the "signal-after::" modifier is the equivalent of using g_signal_connect_after() or g_signal_connect_data() with the -%G_CONNECT_AFTER; the "signal-swapped::" modifier is the equivalent +%G_CONNECT_AFTER; the "signal-swapped::" modifier is the equivalent of using g_signal_connect_swapped() or g_signal_connect_data() with the -%G_CONNECT_SWAPPED flah; finally, the "signal-swapped-after::" modifier +%G_CONNECT_SWAPPED flah; finally, the "signal-swapped-after::" modifier is the equivalent of using g_signal_connect_data() with both the %G_CONNECT_AFTER and %G_CONNECT_SWAPPED flags. The clutter_actor_animate() function will not keep track of multiple connections to the same signal, @@ -2310,22 +810,22 @@ will cause the current animation to change with the new final values, the new easing mode and the new duration - that is, this code: |[ clutter_actor_animate (actor, CLUTTER_LINEAR, 250, -"width", 100.0, -"height", 100.0, +"width", 100.0, +"height", 100.0, NULL); clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500, -"x", 100.0, -"y", 100.0, -"width", 200.0, +"x", 100.0, +"y", 100.0, +"width", 200.0, NULL); ]| is the equivalent of: |[ clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 500, -"x", 100.0, -"y", 100.0, -"width", 200.0, -"height", 100.0, +"x", 100.0, +"y", 100.0, +"width", 200.0, +"height", 100.0, NULL); ]| <note>Unless the animation is looping, the #ClutterAnimation created by @@ -2343,66 +843,37 @@ on_animation_completed (ClutterAnimation *animation, ClutterActor *actor) { clutter_actor_animate (actor, CLUTTER_EASE_OUT_CUBIC, 250, -"x", 500.0, -"y", 500.0, +"x", 500.0, +"y", 500.0, NULL); } ... animation = clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 250, -"x", 100.0, -"y", 100.0, +"x", 100.0, +"y", 100.0, NULL); -g_signal_connect (animation, "completed", +g_signal_connect (animation, "completed", G_CALLBACK (on_animation_completed), actor); ... ]| owned by the #ClutterActor and should not be unreferenced with -g_object_unref()" - version="1.0"> - +g_object_unref() + + a #ClutterAnimation object. The object is - + an animation mode logical id + - - - - - - - - - - - - - - - - - - - - - + duration of the animation, in milliseconds + + the name of a property @@ -2413,23 +884,26 @@ g_object_unref()" + Animates the given list of properties of @actor between the current value for each property and a new final value. The animation has a definite behaviour given by the passed @alpha. See clutter_actor_animate() for further details. This function is useful if you want to use an existing #ClutterAlpha to animate @actor. -#ClutterActor and should not be unreferenced with g_object_unref()" - version="1.0"> - +#ClutterActor and should not be unreferenced with g_object_unref() + + a #ClutterAnimation object. The object is owned by the + a #ClutterAlpha + the name of a property @@ -2438,96 +912,10 @@ to animate @actor. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Animates the given list of properties of @actor between the current value for each property and a new final value. The animation has a definite behaviour given by the passed @alpha. See clutter_actor_animate() for further details. @@ -2536,233 +924,2564 @@ to animate @actor. This is the vector-based variant of clutter_actor_animate_with_alpha(), useful for language bindings. <warning>Unlike clutter_actor_animate_with_alpha(), this function will -not allow you to specify "signal::" names and callbacks.</warning> -#ClutterActor and should not be unreferenced with g_object_unref()" - version="1.0"> - +not allow you to specify "signal::" names and callbacks.</warning> +#ClutterActor and should not be unreferenced with g_object_unref() + + a #ClutterAnimation object. The object is owned by the + a #ClutterAlpha - + number of property names and values + - + + a vector containing the property names to set + + + + + + a vector containing the property values to set + + + + + + + + Animates the given list of properties of @actor between the current +value for each property and a new final value. The animation has a +definite duration given by @timeline and a speed given by the @mode. +See clutter_actor_animate() for further details. +This function is useful if you want to use an existing timeline +to animate @actor. +owned by the #ClutterActor and should not be unreferenced with +g_object_unref() + + a #ClutterAnimation object. The object is + + + + + an animation mode logical id + + + + a #ClutterTimeline + + + + the name of a property + + + + + + + + + + Animates the given list of properties of @actor between the current +value for each property and a new final value. The animation has a +definite duration given by @timeline and a speed given by the @mode. +See clutter_actor_animate() for further details. +This function is useful if you want to use an existing timeline +to animate @actor. +This is the vector-based variant of clutter_actor_animate_with_timeline(), +useful for language bindings. +<warning>Unlike clutter_actor_animate_with_timeline(), this function +will not allow you to specify "signal::" names and callbacks.</warning> +owned by the #ClutterActor and should not be unreferenced with +g_object_unref() + + a #ClutterAnimation object. The object is + + + + + an animation mode logical id + + + + a #ClutterTimeline + + + + number of property names and values + + + + a vector containing the property names to set - + + a vector containing the property values to set + + Animates the given list of properties of @actor between the current +value for each property and a new final value. The animation has a +definite duration and a speed given by the @mode. +This is the vector-based variant of clutter_actor_animate(), useful +for language bindings. +<warning>Unlike clutter_actor_animate(), this function will not +allow you to specify "signal::" names and callbacks.</warning> +owned by the #ClutterActor and should not be unreferenced with +g_object_unref() + + a #ClutterAnimation object. The object is + + + + + an animation mode logical id + + + + duration of the animation, in milliseconds + + + + number of property names and values + + + + a vector containing the property names to set + + + + + + a vector containing the property values to set + + + + + + + + Transforms @point in coordinates relative to the actor into +ancestor-relative coordinates using the relevant transform +stack (i.e. scale, rotation, etc). +If @ancestor is %NULL the ancestor will be the #ClutterStage. In +this case, the coordinates returned will be the coordinates on +the stage before the projection is applied. This is different from +the behaviour of clutter_actor_apply_transform_to_point(). + + + + + + A #ClutterActor ancestor, or %NULL to use the default #ClutterStage + + + + A point as #ClutterVertex + + + + The translated #ClutterVertex + + + + + + Transforms @point in coordinates relative to the actor +into screen-relative coordinates with the current actor +transformation (i.e. scale, rotation, etc) + + + + + + A point as #ClutterVertex + + + + The translated #ClutterVertex + + + + + + Clears the list of actions applied to @self + + + + + + Clears the list of constraints applied to @self + + + + + + Clears the list of effects applied to @self + + + + + + Determines if @descendant is contained inside @self (either as an +immediate child, or as a deeper descendant). + + whether @descendent is contained within @self + + + + + A #ClutterActor, possibly contained in @self + + + + + + Creates a #PangoContext for the given actor. The #PangoContext +is already configured using the appropriate font map, resolution +and font options. +See also clutter_actor_get_pango_context(). +Use g_object_unref() on the returned value to deallocate its +resources + + the newly created #PangoContext. + + + + + Creates a new #PangoLayout from the same #PangoContext used +by the #ClutterActor. The #PangoLayout is already configured +with the font map, resolution and font options, and the +given @text. +If you want to keep around a #PangoLayout created by this +function you will have to connect to the #ClutterBackend::font-changed +and #ClutterBackend::resolution-changed signals, and call +pango_layout_context_changed() in response to them. +Use g_object_unref() when done + + the newly created #PangoLayout. + + + + + (allow-none) the text to set on the #PangoLayout, or %NULL + + + + + + Destroys an actor. When an actor is destroyed, it will break any +references it holds to other objects. If the actor is inside a +container, the actor will be removed. +When you destroy a container, its children will be destroyed as well. +clutter_stage_get_default(). + + + + + + Detaches the #ClutterAnimation used by @actor, if clutter_actor_animate() +has been called on @actor. +Once the animation has been detached, it loses a reference. If it was +the only reference then the #ClutterAnimation becomes invalid. +The #ClutterAnimation::completed signal will not be emitted. + + + + + + This function is used to emit an event on the main stage. +You should rarely need to use this function, except for +synthetising events. +if the actor handled the event, or %FALSE if the event was +not handled + + the return value from the signal emission: %TRUE + + + + + a #ClutterEvent + + + + TRUE if event in in capture phase, FALSE otherwise. + + + + + + Calculates the transformed screen coordinates of the four corners of +the actor; the returned vertices relate to the #ClutterActorBox +coordinates as follows: +<itemizedlist> +<listitem><para>v[0] contains (x1, y1)</para></listitem> +<listitem><para>v[1] contains (x2, y1)</para></listitem> +<listitem><para>v[2] contains (x1, y2)</para></listitem> +<listitem><para>v[3] contains (x2, y2)</para></listitem> +</itemizedlist> + + + + + + Pointer to a location of an array of 4 #ClutterVertex where to store the result. + + + + + + + + Returns the accessible object that describes the actor to an +assistive technology. +If no class-specific #AtkObject implementation is available for the +actor instance in question, it will inherit an #AtkObject +implementation from the first ancestor class for which such an +implementation is defined. +The documentation of the <ulink +url="http://developer.gnome.org/doc/API/2.0/atk/index.html">ATK</ulink> +library contains more information about accessible objects and +their uses. + + the #AtkObject associated with @actor + + + + + Retrieves the #ClutterAction with the given name in the list +of actions applied to @self +name, or %NULL. The returned #ClutterAction is owned by the +actor and it should not be unreferenced directly + + a #ClutterAction for the given + + + + + the name of the action to retrieve + + + + + + Retrieves the list of actions applied to @self +of the list of #ClutterAction<!-- -->s. The contents of the list are +owned by the #ClutterActor. Use g_list_free() to free the resources +allocated by the returned #GList + + a copy + + + + + + + Gets the layout box an actor has been assigned. The allocation can +only be assumed valid inside a paint() method; anywhere else, it +may be out-of-date. +An allocation does not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. +<note>Do not call any of the clutter_actor_get_allocation_*() family +of functions inside the implementation of the get_preferred_width() +or get_preferred_height() virtual functions.</note> + + + + + + the function fills this in with the actor's allocation + + + + + + Gets the layout box an actor has been assigned. The allocation can +only be assumed valid inside a paint() method; anywhere else, it +may be out-of-date. +An allocation does not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. +The returned rectangle is in pixels. + + + + + + allocation geometry in pixels + + + + + + Calculates the transformed coordinates of the four corners of the +actor in the plane of @ancestor. The returned vertices relate to +the #ClutterActorBox coordinates as follows: +<itemizedlist> +<listitem><para>@verts[0] contains (x1, y1)</para></listitem> +<listitem><para>@verts[1] contains (x2, y1)</para></listitem> +<listitem><para>@verts[2] contains (x1, y2)</para></listitem> +<listitem><para>@verts[3] contains (x2, y2)</para></listitem> +</itemizedlist> +If @ancestor is %NULL the ancestor will be the #ClutterStage. In +this case, the coordinates returned will be the coordinates on +the stage before the projection is applied. This is different from +the behaviour of clutter_actor_get_abs_allocation_vertices(). + + + + + + A #ClutterActor to calculate the vertices against, or %NULL to use the #ClutterStage + + + + return location for an array of 4 #ClutterVertex in which to store the result + + + + + + + + Gets the current anchor point of the @actor in pixels. + + + + + + return location for the X coordinate of the anchor point + + + + return location for the Y coordinate of the anchor point + + + + + + Retrieves the anchor position expressed as a #ClutterGravity. If +the anchor point was specified using pixels or units this will +return %CLUTTER_GRAVITY_NONE. + + the #ClutterGravity used by the anchor point + + + - + Retrieves the #ClutterAnimation used by @actor, if clutter_actor_animate() +has been called on @actor. + + a #ClutterAnimation, or %NULL - + Gets the clip area for @self, if any is set + + + + + + return location for the X offset of the clip rectangle, or %NULL + + + + return location for the Y offset of the clip rectangle, or %NULL + + + + return location for the width of the clip rectangle, or %NULL + + + + return location for the height of the clip rectangle, or %NULL + + + + + + Retrieves the value set using clutter_actor_set_clip_to_allocation() + + %TRUE if the #ClutterActor is clipped to its allocation + + + + + Retrieves the #ClutterConstraint with the given name in the list +of constraints applied to @self +name, or %NULL. The returned #ClutterConstraint is owned by the +actor and it should not be unreferenced directly + + a #ClutterConstraint for the given + + + + + the name of the constraint to retrieve + + + + + + Retrieves the list of constraints applied to @self +of the list of #ClutterConstraint<!-- -->s. The contents of the list are +owned by the #ClutterActor. Use g_list_free() to free the resources +allocated by the returned #GList + + a copy + + + + + + + Retrieves the depth of @self. + + the depth of the actor + + + + + Retrieves the #ClutterEffect with the given name in the list +of effects applied to @self +name, or %NULL. The returned #ClutterEffect is owned by the +actor and it should not be unreferenced directly + + a #ClutterEffect for the given + + + + + the name of the effect to retrieve + + + + + + Retrieves the #ClutterEffect<!-- -->s applied on @self, if any +of #ClutterEffect<!-- -->s, or %NULL. The elements of the returned +list are owned by Clutter and they should not be freed. You should +free the returned list using g_list_free() when done + + a list + + + + + + + Checks whether an actor has a fixed position set (and will thus be +unaffected by any layout manager). + + %TRUE if the fixed position is set on the actor + + + + + Retrieves the flags set on @self + + a bitwise or of #ClutterActorFlags or 0 + + + + + Gets the size and position of an actor relative to its parent +actor. This is the same as calling clutter_actor_get_position() and +clutter_actor_get_size(). It tries to "do what you mean" and get the +requested size and position if the actor's allocation is invalid. + + + + + + A location to store actors #ClutterGeometry + + + + + + Retrieves the unique id for @self. + + Globally unique value for this object instance. + + + + + Retrieves the height of a #ClutterActor. +If the actor has a valid allocation, this function will return the +height of the allocated area given to the actor. +If the actor does not have a valid allocation, this function will +return the actor's natural height, that is the preferred height of +the actor. +If you care whether you get the preferred height or the height that +has been assigned to the actor, you should probably call a different +function like clutter_actor_get_allocation_box() to retrieve the +allocated size or clutter_actor_get_preferred_height() to retrieve the +preferred height. +If an actor has a fixed height, for instance a height that has been +assigned using clutter_actor_set_height(), the height returned will +be the same value. + + the height of the actor, in pixels + + + + + Retrieves the name of @self. +owned by the actor and should not be modified or freed. + + the name of the actor, or %NULL. The returned string is + + + + + Retrieves the opacity value of an actor, as set by +clutter_actor_set_opacity(). +For retrieving the absolute opacity of the actor inside a paint +virtual function, see clutter_actor_get_paint_opacity(). + + the opacity of the actor + + + + + Retrieves the absolute opacity of the actor, as it appears on the stage. +This function traverses the hierarchy chain and composites the opacity of +the actor with that of its parents. +This function is intended for subclasses to use in the paint virtual +function, to paint themselves with the correct opacity. + + The actor opacity value. + + + + + Retrieves the 'paint' visibility of an actor recursively checking for non +visible parents. +This is by definition the same as CLUTTER_ACTOR_IS_MAPPED(). + + TRUE if the actor is visibile and will be painted. + + + + + Retrieves the #PangoContext for @self. The actor's #PangoContext +is already configured using the appropriate font map, resolution +and font options. +Unlike clutter_actor_create_pango_context(), this context is owend +by the #ClutterActor and it will be updated each time the options +stored by the #ClutterBackend change. +You can use the returned #PangoContext to create a #PangoLayout +and render text using cogl_pango_render_layout() to reuse the +glyphs cache also used by Clutter. +The returned #PangoContext is owned by the actor and should not be +unreferenced by the application code + + the #PangoContext for a #ClutterActor. + + + + + Retrieves the parent of @self. +if no parent is set + + The #ClutterActor parent, or %NULL + + + + + This function tries to "do what you mean" and tell you where the +actor is, prior to any transformations. Retrieves the fixed +position of an actor in pixels, if one has been set; otherwise, if +the allocation is valid, returns the actor's allocated position; +otherwise, returns 0,0. +The returned position is in pixels. + + + + + + return location for the X coordinate, or %NULL + + + + return location for the Y coordinate, or %NULL + + + + + + Computes the requested minimum and natural heights for an actor, +or if they are already computed, returns the cached values. +An actor may not get its request - depending on the layout +manager that's in effect. +A request should not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. + + + + + + available width to assume in computing desired height, or a negative value to indicate that no width is defined + + + + return location for minimum height, or %NULL + + + + return location for natural height, or %NULL + + + + + + Computes the preferred minimum and natural size of an actor, taking into +account the actor's geometry management (either height-for-width +or width-for-height). +The width and height used to compute the preferred height and preferred +width are the actor's natural ones. +If you need to control the height for the preferred width, or the width for +the preferred height, you should use clutter_actor_get_preferred_width() +and clutter_actor_get_preferred_height(), and check the actor's preferred +geometry management using the #ClutterActor:request-mode property. + + + + + + return location for the minimum width, or %NULL + + + + return location for the minimum height, or %NULL + + + + return location for the natural width, or %NULL + + + + return location for the natural height, or %NULL + + + + + + Computes the requested minimum and natural widths for an actor, +optionally depending on the specified height, or if they are +already computed, returns the cached values. +An actor may not get its request - depending on the layout +manager that's in effect. +A request should not incorporate the actor's scale or anchor point; +those transformations do not affect layout, only rendering. + + + + + + available height when computing the preferred width, or a negative value to indicate that no height is defined + + + + return location for minimum width, or %NULL + + + + return location for the natural width, or %NULL + + + + + + Checks whether @actor is marked as reactive. + + %TRUE if the actor is reactive + + + + + Retrieves the geometry request mode of @self + + the request mode for the actor + + + + + Retrieves the angle and center of rotation on the given axis, +set using clutter_actor_set_rotation(). + + the angle of rotation + + + + + the axis of rotation + + + + return value for the X coordinate of the center of rotation + + + + return value for the Y coordinate of the center of rotation + + + + return value for the Z coordinate of the center of rotation + + + + + + Retrieves an actors scale factors. + + + + + + Location to store horizonal scale factor, or %NULL. + + + + Location to store vertical scale factor, or %NULL. + + + + + + Retrieves the scale center coordinate in pixels relative to the top +left corner of the actor. If the scale center was specified using a +#ClutterGravity this will calculate the pixel offset using the +current size of the actor. + + + + + + Location to store the X position of the scale center, or %NULL. + + + + Location to store the Y position of the scale center, or %NULL. + + + + + + Retrieves the scale center as a compass direction. If the scale +center was specified in pixels or units this will return +%CLUTTER_GRAVITY_NONE. + + the scale gravity + + + + + Queries the currently set #ClutterShader on @self. +or %NULL if no shader is set. + + The currently set #ClutterShader + + + + + This function tries to "do what you mean" and return +the size an actor will have. If the actor has a valid +allocation, the allocation will be returned; otherwise, +the actors natural size request will be returned. +If you care whether you get the request vs. the allocation, you +should probably call a different function like +clutter_actor_get_allocation_box() or +clutter_actor_get_preferred_width(). + + + + + + return location for the width, or %NULL. + + + + return location for the height, or %NULL. + + + + + + Retrieves the #ClutterStage where @actor is contained. + + the stage containing the actor, or %NULL + + + + + Retrieves the value set using clutter_actor_set_text_direction() +If no text direction has been previously set, the default text +direction, as returned by clutter_get_default_text_direction(), will +be returned instead + + the #ClutterTextDirection for the actor + + + + + Retrieves the transformations applied to @self relative to its +parent. + + + + + + the return location for a #CoglMatrix + + + + + + Gets the absolute position of an actor, in pixels relative to the stage. + + + + + + return location for the X coordinate, or %NULL + + + + return location for the Y coordinate, or %NULL + + + + + + Gets the absolute size of an actor in pixels, taking into account the +scaling factors. +If the actor has a valid allocation, the allocated size will be used. +If the actor has not a valid allocation then the preferred size will +be transformed and returned. +If you want the transformed allocation, see +clutter_actor_get_abs_allocation_vertices() instead. +<note>When the actor (or one of its ancestors) is rotated around the +X or Y axis, it no longer appears as on the stage as a rectangle, but +as a generic quadrangle; in that case this function returns the size +of the smallest rectangle that encapsulates the entire quad. Please +note that in this case no assumptions can be made about the relative +position of this envelope to the absolute position of the actor, as +returned by clutter_actor_get_transformed_position(); if you need this +information, you need to use clutter_actor_get_abs_allocation_vertices() +to get the coords of the actual quadrangle.</note> + + + + + + return location for the width, or %NULL + + + + return location for the height, or %NULL + + + + + + Retrieves the width of a #ClutterActor. +If the actor has a valid allocation, this function will return the +width of the allocated area given to the actor. +If the actor does not have a valid allocation, this function will +return the actor's natural width, that is the preferred width of +the actor. +If you care whether you get the preferred width or the width that +has been assigned to the actor, you should probably call a different +function like clutter_actor_get_allocation_box() to retrieve the +allocated size or clutter_actor_get_preferred_width() to retrieve the +preferred width. +If an actor has a fixed width, for instance a width that has been +assigned using clutter_actor_set_width(), the width returned will +be the same value. + + the width of the actor, in pixels + + + + + + + + + + + + + + + Retrieves the center for the rotation around the Z axis as a +compass direction. If the center was specified in pixels or units +this will return %CLUTTER_GRAVITY_NONE. + + the Z rotation center + + + + + Sets the key focus of the #ClutterStage including @self +to this #ClutterActor. + + + + + + Checks if the actor has an up-to-date allocation assigned to +visible and has a parent. It also means that there is no +outstanding relayout request in progress for the actor or its +children (There might be other outstanding layout requests in +progress that will cause the actor to get a new allocation +when the stage is laid out, however). +If this function returns %FALSE, then the actor will normally +be allocated before it is next drawn on the screen. + + %TRUE if the actor has an up-to-date allocation + + + + + Determines whether the actor has a clip area set or not. + + %TRUE if the actor has a clip area set. + + + + + Checks whether @self is the #ClutterActor that has key focus + + %TRUE if the actor has key focus, and %FALSE otherwise + + + + + Checks whether an actor contains the the pointer of a +#ClutterInputDevice +%FALSE otherwise + + %TRUE if the actor contains the pointer, and + + + + + Flags an actor to be hidden. A hidden actor will not be +rendered on the stage. +Actors are visible by default. +If this function is called on an actor without a parent, the +#ClutterActor:show-on-set-parent property will be set to %FALSE +as a side-effect. + + + + + + Calls clutter_actor_hide() on all child actors (if any). + + + + + + Checks whether @self is being currently painted by a #ClutterClone +This function is useful only inside the ::paint virtual function +implementations or within handlers for the #ClutterActor::paint +signal +This function should not be used by applications +by a #ClutterClone, and %FALSE otherwise + + %TRUE if the #ClutterActor is currently being painted + + + + + Checks whether any rotation is applied to the actor. + + %TRUE if the actor is rotated. + + + + + Checks whether the actor is scaled in either dimension. + + %TRUE if the actor is scaled. + + + + + Puts @self below @above. +Both actors must have the same parent, and the parent must implement +the #ClutterContainer interface. +This function is the equivalent of clutter_container_lower_child(). + + + + + + A #ClutterActor to lower below + + + + + + Lowers @self to the bottom. +This function calls clutter_actor_lower() internally. + + + + + + Sets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly maps +and realizes its children if they are visible. Does nothing if the +actor is not visible. +#ClutterActor <function>map()</function> virtual function in an actor +and you need to map the children of that actor. It is not necessary +to call this if you implement #ClutterContainer because the default +implementation will automatically map children of containers. +When overriding map, it is mandatory to chain up to the parent +implementation. + + + + + + Sets an anchor point for the actor, and adjusts the actor postion so that +the relative position of the actor toward its parent remains the same. + + + + + + X coordinate of the anchor point + + + + Y coordinate of the anchor point + + + + + + Sets an anchor point on the actor based on the given gravity, adjusting the +actor postion so that its relative position within its parent remains +unchanged. +Since version 1.0 the anchor point will be stored as a gravity so +that if the actor changes size then the anchor point will move. For +example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST +and later double the size of the actor, the anchor point will move +to the bottom right. + + + + + + #ClutterGravity. + + + + + + Moves an actor by the specified distance relative to its current +position in pixels. +This function modifies the fixed position of an actor and thus removes +it from any layout management. Another way to move an actor is with an +anchor point, see clutter_actor_set_anchor_point(). + + + + + + Distance to move Actor on X axis. + + + + Distance to move Actor on Y axis. + + + + + + Renders the actor to display. +This function should not be called directly by applications. +Call clutter_actor_queue_redraw() to queue paints, instead. +This function is context-aware, and will either cause a +regular paint or a pick paint. +This function will emit the #ClutterActor::paint signal or +the #ClutterActor::pick signal, depending on the context. +This function does not paint the actor if the actor is set to 0, +unless it is performing a pick paint. + + + + + + Disables the effects of clutter_actor_pop_internal() + + + + + + Should be used by actors implementing the #ClutterContainer and with +internal children added through clutter_actor_set_parent(), for instance: +|[ +static void +my_actor_init (MyActor *self) +{ +self->priv = SELF_ACTOR_GET_PRIVATE (self); +clutter_actor_push_internal (CLUTTER_ACTOR (self)); +/&ast; calling clutter_actor_set_parent() now will result in +&ast; the internal flag being set on a child of MyActor +&ast;/ +/&ast; internal child - a background texture &ast;/ +self->priv->background_tex = clutter_texture_new (); +clutter_actor_set_parent (self->priv->background_tex, +CLUTTER_ACTOR (self)); +/&ast; internal child - a label &ast;/ +self->priv->label = clutter_text_new (); +clutter_actor_set_parent (self->priv->label, +CLUTTER_ACTOR (self)); +clutter_actor_pop_internal (CLUTTER_ACTOR (self)); +/&ast; calling clutter_actor_set_parent() now will not result in +&ast; the internal flag being set on a child of MyActor +&ast;/ +} +]| +This function will be used by Clutter to toggle an "internal child" +flag whenever clutter_actor_set_parent() is called; internal children +are handled differently by Clutter, specifically when destroying their +parent. +Call clutter_actor_pop_internal() when you finished adding internal +children. +Nested calls to clutter_actor_push_internal() are allowed, but each +one must by followed by a clutter_actor_pop_internal() call. + + + + + + Queues up a redraw of an actor and any children. The redraw occurs +once the main loop becomes idle (after the current batch of events +has been processed, roughly). +Applications rarely need to call this, as redraws are handled +automatically by modification functions. +This function will not do anything if @self is not visible, or +if the actor is inside an invisible part of the scenegraph. +Also be aware that painting is a NOP for actors with an opacity of +0 +When you are implementing a custom actor you must queue a redraw +whenever some private state changes that will affect painting or +picking of your actor. + + + + + + Indicates that the actor's size request or other layout-affecting +properties may have changed. This function is used inside #ClutterActor +subclass implementations, not by applications directly. +Queueing a new layout automatically queues a redraw as well. + + + + + + Puts @self above @below. +Both actors must have the same parent, and the parent must implement +the #ClutterContainer interface +This function is the equivalent of clutter_container_raise_child(). + + + + + + A #ClutterActor to raise above. + + + + + + Raises @self to the top. +This function calls clutter_actor_raise() internally. + + + + + + Realization informs the actor that it is attached to a stage. It +can use this to allocate resources if it wanted to delay allocation +until it would be rendered. However it is perfectly acceptable for +an actor to create resources before being realized because Clutter +only ever has a single rendering context so that actor is free to +be moved from one stage to another. +This function does nothing if the actor is already realized. +Because a realized actor must have realized parent actors, calling +clutter_actor_realize() will also realize all parents of the actor. +This function does not realize child actors, except in the special +case that realizing the stage, when the stage is visible, will +suddenly map (and thus realize) the children of the stage. + + + + + + Removes @action from the list of actions applied to @self +The reference held by @self on the #ClutterAction will be released + + + + + + a #ClutterAction + + + + + + Removes the #ClutterAction with the given name from the list +of actions applied to @self + + + + + + the name of the action to remove + + + + + + + + + + + Removes @constraint from the list of constraints applied to @self +The reference held by @self on the #ClutterConstraint will be released + + + + + + a #ClutterConstraint + + + + + + Removes the #ClutterConstraint with the given name from the list +of constraints applied to @self + + + + + + the name of the constraint to remove + + + + + + Removes @effect from the list of effects applied to @self +The reference held by @self on the #ClutterEffect will be released + + + + + + a #ClutterEffect + + + + + + Removes the #ClutterEffect with the given name from the list +of effects applied to @self + + + + + + the name of the effect to remove + + + + + + This function resets the parent actor of @self. It is +logically equivalent to calling clutter_actor_unparent() +and clutter_actor_set_parent(), but more efficiently +implemented, ensures the child is not finalized +when unparented, and emits the parent-set signal only +one time. + + + + + + the new #ClutterActor parent + + + + + + Sets an anchor point for @self. The anchor point is a point in the +coordinate space of an actor to which the actor position within its +parent is relative; the default is (0, 0), i.e. the top-left corner +of the actor. + + + + + + X coordinate of the anchor point + + + + Y coordinate of the anchor point + + + + + + Sets an anchor point on the actor, based on the given gravity (this is a +convenience function wrapping clutter_actor_set_anchor_point()). +Since version 1.0 the anchor point will be stored as a gravity so +that if the actor changes size then the anchor point will move. For +example, if you set the anchor point to %CLUTTER_GRAVITY_SOUTH_EAST +and later double the size of the actor, the anchor point will move +to the bottom right. + + + + + + #ClutterGravity. + + + + + + Sets clip area for @self. The clip area is always computed from the +upper left corner of the actor, even if the anchor point is set +otherwise. + + + + + + X offset of the clip rectangle + + + + Y offset of the clip rectangle + + + + Width of the clip rectangle + + + + Height of the clip rectangle + + + + + + Sets whether @self should be clipped to the same size as its +allocation + + + + + + %TRUE to apply a clip tracking the allocation + + + + + + Sets the Z coordinate of @self to @depth. +The unit used by @depth is dependant on the perspective setup. See +also clutter_stage_set_perspective(). + + + + + + Z co-ord + + + + + + Sets whether an actor has a fixed position set (and will thus be +unaffected by any layout manager). + + + + + + whether to use fixed position + + + + + + Sets @flags on @self +This function will emit notifications for the changed properties + + + + + + the flags to set + + + + + + Sets the actor's fixed position and forces its minimum and natural +size, in pixels. This means the untransformed actor will have the +given geometry. This is the same as calling clutter_actor_set_position() +and clutter_actor_set_size(). + + + + + + A #ClutterGeometry + + + + + + + + + + + + + + + + Sets the given name to @self. The name can be used to identify +a #ClutterActor. + + + + + + Textual tag to apply to actor + + + + + + Sets the actor's opacity, with zero being completely transparent and +255 (0xff) being fully opaque. + + + + + + New opacity value for the actor. + + + + + + Sets the parent of @self to @parent. The opposite function is +clutter_actor_unparent(). +This function should not be used by applications, but by custom +container actor subclasses. + + + + + + A new #ClutterActor parent + + + + + + + + + + + + + + + + + + + Sets @actor as reactive. Reactive actors will receive events. + + + + + + whether the actor should be reactive to events + + + + + + Sets the geometry request mode of @self. +The @mode determines the order for invoking +clutter_actor_get_preferred_width() and +clutter_actor_get_preferred_height() + + + + + + the request mode + + + + + + Sets the rotation angle of @self around the given axis. +The rotation center coordinates used depend on the value of @axis: +<itemizedlist> +<listitem><para>%CLUTTER_X_AXIS requires @y and @z</para></listitem> +<listitem><para>%CLUTTER_Y_AXIS requires @x and @z</para></listitem> +<listitem><para>%CLUTTER_Z_AXIS requires @x and @y</para></listitem> +</itemizedlist> +The rotation coordinates are relative to the anchor point of the +actor, set using clutter_actor_set_anchor_point(). If no anchor +point is set, the upper left corner is assumed as the origin. + + + + + + the axis of rotation + + + + the angle of rotation + + + + X coordinate of the rotation center + + + + Y coordinate of the rotation center + + + + Z coordinate of the rotation center + + + + + + Scales an actor with the given factors. The scaling is relative to +the scale center and the anchor point. The scale center is +unchanged by this function and defaults to 0,0. + + + + + + double factor to scale actor by horizontally. + + + + double factor to scale actor by vertically. + + + + + + Scales an actor with the given factors around the given center +point. The center point is specified in pixels relative to the +anchor point (usually the top left corner of the actor). + + + + + + double factor to scale actor by horizontally. + + + + double factor to scale actor by vertically. + + + + X coordinate of the center of the scale. + + + + Y coordinate of the center of the scale + + + + + + Scales an actor with the given factors around the given +center point. The center point is specified as one of the compass +directions in #ClutterGravity. For example, setting it to north +will cause the top of the actor to remain unchanged and the rest of +the actor to expand left, right and downwards. + + + + + + double factor to scale actor by horizontally. + + + + double factor to scale actor by vertically. + + + + the location of the scale center expressed as a compass direction. + + + + + + Sets the #ClutterShader to be used when rendering @self. +If @shader is %NULL it will unset any currently set shader +for the actor. + + %TRUE if the shader was successfully applied + + + + + a #ClutterShader or %NULL to unset the shader. + + + + + + Sets the value for a named parameter of the shader applied +to @actor. + + + + + + the name of the parameter + + + + the value of the parameter + + + + + + Sets the value for a named float parameter of the shader applied +to @actor. + + + + + + the name of the parameter + + + + the value of the parameter + + + + + + Sets the value for a named int parameter of the shader applied to + + + + + + the name of the parameter + + + + the value of the parameter + + + + + + + + + + + + + + + + + + + Sets the #ClutterTextDirection for an actor +The passed text direction must not be %CLUTTER_TEXT_DIRECTION_DEFAULT +If @self implements #ClutterContainer then this function will recurse +inside all the children of @self (including the internal ones). +Composite actors not implementing #ClutterContainer, or actors requiring +special handling when the text direction changes, should connect to +the #GObject::notify signal for the #ClutterActor:text-direction property + + + + + + the text direction for @self + + + + + + + + + + + + + + + + Sets the actor's X coordinate, relative to its parent, in pixels. +Overrides any layout manager and forces a fixed position for +the actor. + + + + + + the actor's position on the X axis + + + + + + Sets the actor's Y coordinate, relative to its parent, in pixels.# +Overrides any layout manager and forces a fixed position for +the actor. + + + + + + the actor's position on the Y axis + + + + + + Sets the rotation angle of @self around the Z axis using the center +point specified as a compass point. For example to rotate such that +the center of the actor remains static you can use +%CLUTTER_GRAVITY_CENTER. If the actor changes size the center point +will move accordingly. + + + + + + the angle of rotation + + + + the center point of the rotation + + + + + + Should be called inside the implementation of the +#ClutterActor::pick virtual function in order to check whether +the actor should paint itself in pick mode or not. +This function should never be called directly by applications. +%FALSE otherwise + + %TRUE if the actor should paint its silhouette, + + + + + Flags an actor to be displayed. An actor that isn't shown will not +be rendered on the stage. +Actors are visible by default. +If this function is called on an actor without a parent, the +#ClutterActor:show-on-set-parent will be set to %TRUE as a side +effect. + + + + + + Calls clutter_actor_show() on all children of an actor (if any). + + + + + + This function translates screen coordinates (@x, @y) to +coordinates relative to the actor. For example, it can be used to translate +screen events from global screen coordinates into actor-local coordinates. +The conversion can fail, notably if the transform stack results in the +actor being projected on the screen as a mere line. +The conversion should not be expected to be pixel-perfect due to the +nature of the operation. In general the error grows when the skewing +of the actor rectangle on screen increases. +<note><para>This function can be computationally intensive.</para></note> +<note><para>This function only works when the allocation is up-to-date, +i.e. inside of paint().</para></note> + + %TRUE if conversion was successful. + + + + + x screen coordinate of the point to unproject + + + + y screen coordinate of the point to unproject + + + + return location for the unprojected x coordinance + + + + return location for the unprojected y coordinance + + + + + + Unsets the %CLUTTER_ACTOR_MAPPED flag on the actor and possibly +unmaps its children if they were mapped. +#ClutterActor <function>unmap()</function> virtual function in an actor +and you need to unmap the children of that actor. It is not necessary +to call this if you implement #ClutterContainer because the default +implementation will automatically unmap children of containers. +When overriding unmap, it is mandatory to chain up to the parent +implementation. + + + + + + Removes the parent of @self. +This function should not be used in applications. It should be called by +implementations of container actors, to dissociate a child from the +container. + + + + + + Unrealization informs the actor that it may be being destroyed or +moved to another stage. The actor may want to destroy any +underlying graphics resources at this point. However it is +perfectly acceptable for it to retain the resources until the actor +is destroyed because Clutter only ever uses a single rendering +context and all of the graphics resources are valid on any stage. +Because mapped actors must be realized, actors may not be +unrealized if they are mapped. This function hides the actor to be +sure it isn't mapped, an application-visible side effect that you +may not be expecting. +This function should not be called by application code. + + + + + + Unsets @flags on @self +This function will emit notifications for the changed properties + + + + + + the flags to unset + + + + + + Adds a #ClutterAction to the actor + + + + The allocation for the actor, in pixels This is property is read-only, but you might monitor it to know when an -actor moves or resizes"> - +actor moves or resizes + - + transfer-ownership="none"> + The anchor point expressed as a #ClutterGravity + - + transfer-ownership="none"> + The X coordinate of an actor's anchor point, relative to +the actor coordinate space, in pixels + - + transfer-ownership="none"> + The Y coordinate of an actor's anchor point, relative to +the actor coordinate space, in pixels + - + The clip region for the actor, in actor-relative coordinates Every part of the actor outside the clip region will not be -painted"> - +painted + + Whether the clip region should track the allocated area of the actor. This property is ignored if a clip area has been explicitly -set using clutter_actor_set_clip()."> - +set using clutter_actor_set_clip(). + + + + Adds a #ClutterConstraint to the actor + - + transfer-ownership="none"> + The position of the actor on the Z axis + + + + Adds #ClutterEffect to the list of effects be applied on a #ClutterActor + - + transfer-ownership="none"> + This flag controls whether the #ClutterActor:fixed-x and +#ClutterActor:fixed-y properties are used + + The fixed X position of the actor in pixels. Writing this property sets #ClutterActor:fixed-position-set -property as well, as a side effect"> - +property as well, as a side effect + + The fixed Y position of the actor in pixels. Writing this property sets the #ClutterActor:fixed-position-set -property as well, as a side effect"> - +property as well, as a side effect + - - + + Whether the actor has the #ClutterActor:clip property set or not + - - + + Whether the actor contains the pointer of a #ClutterInputDevice +or not. + - + Height of the actor (in pixels). If written, forces the minimum and natural size request of the actor to the given height. If read, returns -the allocated height if available, otherwise the height request."> - +the allocated height if available, otherwise the height request. + - - + + Whether the actor is mapped (will be painted when the stage +to which it belongs is mapped) + + A forced minimum height request for the actor, in pixels Writing this property sets the #ClutterActor:min-height-set property as well, as a side effect. This property overrides the usual height -request of the actor."> - +request of the actor. + - + transfer-ownership="none"> + This flag controls whether the #ClutterActor:min-height property +is used + + A forced minimum width request for the actor, in pixels Writing this property sets the #ClutterActor:min-width-set property as well, as a side effect. -his property overrides the usual width request of the actor."> - +This property overrides the usual width request of the actor. + - + transfer-ownership="none"> + This flag controls whether the #ClutterActor:min-width property +is used + - + transfer-ownership="none"> + The name of the actor + + A forced natural height request for the actor, in pixels Writing this property sets the #ClutterActor:natural-height-set property as well, as a side effect. This property overrides the -usual height request of the actor"> - +usual height request of the actor + - + transfer-ownership="none"> + This flag controls whether the #ClutterActor:natural-height property +is used + + A forced natural width request for the actor, in pixels Writing this property sets the #ClutterActor:natural-width-set property as well, as a side effect. This property overrides the -usual width request of the actor"> - +usual width request of the actor + - + transfer-ownership="none"> + This flag controls whether the #ClutterActor:natural-width property +is used + - - + + Opacity of an actor, between 0 (fully transparent) and +255 (fully opaque) + - + transfer-ownership="none"> + Whether the actor is reactive to events or not +Only reactive actors will emit event-related signals + - - + + Whether the actor has been realized + + Request mode for the #ClutterActor. The request mode determines the type of geometry management used by the actor, either height for width (the default) or width for height. For actors implementing height for width, the parent container should get @@ -2795,363 +3514,377 @@ clutter_actor_get_preferred_width (child, natural_height, } ]| will retrieve the minimum and natural width and height depending on the -preferred request mode of the #ClutterActor "child". +preferred request mode of the #ClutterActor "child". The clutter_actor_get_preferred_size() function will implement this -check for you."> - +check for you. + - + transfer-ownership="none"> + The rotation angle on the X axis + - + transfer-ownership="none"> + The rotation angle on the Y axis + - + transfer-ownership="none"> + The rotation angle on the Z axis + - + transfer-ownership="none"> + The rotation center on the X axis. + - + transfer-ownership="none"> + The rotation center on the Y axis. + - + transfer-ownership="none"> + The rotation center on the Z axis. + - + transfer-ownership="none"> + The rotation center on the Z axis expressed as a #ClutterGravity. + - + transfer-ownership="none"> + The horizontal center point for scaling + - + transfer-ownership="none"> + The vertical center point for scaling + - + transfer-ownership="none"> + The center point for scaling expressed as a #ClutterGravity + - + transfer-ownership="none"> + The horizontal scale of the actor + - + transfer-ownership="none"> + The vertical scale of the actor + + If %TRUE, the actor is automatically shown when parented. Calling clutter_actor_hide() on an actor which has not been -parented will set this property to %FALSE as a side effect."> - +parented will set this property to %FALSE as a side effect. + - - + + - - + + Whether the actor is set to be visible or not +See also #ClutterActor:mapped + - + Width of the actor (in pixels). If written, forces the minimum and natural size request of the actor to the given width. If read, returns -the allocated width if available, otherwise the width request."> - +the allocated width if available, otherwise the width request. + - + X coordinate of the actor in pixels. If written, forces a fixed position for the actor. If read, returns the fixed position if any, -otherwise the allocation if available, otherwise 0."> - +otherwise the allocation if available, otherwise 0. + - + Y coordinate of the actor in pixels. If written, forces a fixed position for the actor. If read, returns the fixed position if -any, otherwise the allocation if available, otherwise 0."> - +any, otherwise the allocation if available, otherwise 0. + - + - + - + The ::allocation-changed signal is emitted when the #ClutterActor:allocation property changes. Usually, application code should just use the notifications for the :allocation property but if you want to track the allocation flags as well, for instance to know whether the absolute origin of @actor changed, then you might -want use this signal instead." - version="1.0"> - - +want use this signal instead. + + - - + + a #ClutterActorBox with the new allocation + - - + + #ClutterAllocationFlags for the allocation + - + The ::button-press-event signal is emitted each time a mouse button is pressed on @actor. -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterButtonEvent + - + The ::button-release-event signal is emitted each time a mouse button is released on @actor. -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterButtonEvent + - + The ::captured-event signal is emitted when an event is captured by Clutter. This signal will be emitted starting from the top-level container (the #ClutterStage) to the actor which received the event going down the hierarchy. This signal can be used to intercept every event before the specialized events (like ClutterActor::button-press-event or ::key-released-event) are emitted. -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterEvent + - + The ::destroy signal is emitted when an actor is destroyed, either by direct invocation of clutter_actor_destroy() or -when the #ClutterGroup that contains the actor is destroyed." - version="0.2"> - - +when the #ClutterGroup that contains the actor is destroyed. + + - - - + + The ::enter-event signal is emitted when the pointer enters the @actor +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterCrossingEvent + - + The ::event signal is emitted each time an event is received by the @actor. This signal will be emitted on every actor, following the hierarchy chain, until it reaches the top-level container (the #ClutterStage). -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterEvent + - - - + + The ::hide signal is emitted when an actor is no longer rendered +on the stage. + + - - - + + The ::key-focus-in signal is emitted when @actor receives key focus. + + - - - + + The ::key-focus-out signal is emitted when @actor loses key focus. + + - + The ::key-press-event signal is emitted each time a keyboard button is pressed while @actor has key focus (see clutter_stage_set_key_focus()). -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterKeyEvent + - + The ::key-release-event signal is emitted each time a keyboard button is released while @actor has key focus (see clutter_stage_set_key_focus()). -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterKeyEvent + - - - + + The ::leave-event signal is emitted when the pointer leaves the @actor. +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterCrossingEvent + - + The ::motion-event signal is emitted each time the mouse pointer is moved over @actor. -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterMotionEvent + - + The ::paint signal is emitted each time an actor is being painted. Subclasses of #ClutterActor should override the class signal handler and paint themselves in that function. It is possible to connect a handler to the ::paint signal in order -to set up some custom aspect of a paint." - version="0.8"> - - +to set up some custom aspect of a paint. + + - - - + + This signal is emitted when the parent of the actor changes. + + - - + + the previous parent of the actor, or %NULL + - + The ::pick signal is emitted each time an actor is being painted +in "pick mode". The pick mode is used to identify the actor during the event handling phase, or by clutter_stage_get_actor_at_pos(). The actor should paint its shape using the passed @pick_color. Subclasses of #ClutterActor should override the class signal handler and paint themselves in that function. It is possible to connect a handler to the ::pick signal in order -to set up some custom aspect of a paint in pick mode." - version="1.0"> - - +to set up some custom aspect of a paint in pick mode. + + - - + + the #ClutterColor to be used when picking + - + The ::queue_redraw signal is emitted when clutter_actor_queue_redraw() is called on @origin. The default implementation for #ClutterActor chains up to the -parent actor and queues a redraw on the parent, thus "bubbling" +parent actor and queues a redraw on the parent, thus "bubbling" the redraw queue up through the actor graph. The default implementation for #ClutterStage queues a clutter_redraw() in a main loop idle handler. @@ -3172,7 +3905,7 @@ static void on_stage_queue_redraw (ClutterStage *stage) { /&ast; this prevents the default handler to run &ast;/ -g_signal_stop_emission_by_name (stage, "queue-redraw"); +g_signal_stop_emission_by_name (stage, "queue-redraw"); /&ast; queue a redraw with the host toolkit and call &ast; a function when the redraw has been completed &ast;/ @@ -3182,171 +3915,205 @@ queue_a_redraw (G_CALLBACK (on_redraw_complete)); <note><para>This signal is emitted before the Clutter paint pipeline is executed. If you want to know when the pipeline has been completed you should connect to the ::paint signal on the -Stage with g_signal_connect_after().</para></note>" - version="1.0"> - - +Stage with g_signal_connect_after().</para></note> + + - - + + the actor which initiated the redraw request + - - + + - - - + + The ::realize signal is emitted each time an actor is being +realized. + + - + The ::scroll-event signal is emitted each time the mouse is scrolled on @actor -or %FALSE to continue the emission." - version="0.6"> - - +or %FALSE to continue the emission. + + %TRUE if the event has been handled by the actor, + - - + + a #ClutterScrollEvent + - - - + + The ::show signal is emitted when an actor is visible and +rendered on the stage. + + - - - + + The ::unrealize signal is emitted each time an actor is being +unrealized. + + + glib:get-type="clutter_actor_box_get_type" + c:symbol-prefix="actor_box"> + Bounding box of an actor. The coordinates of the top left and right bottom +corners of an actor. The coordinates of the two points are expressed in +pixels with sub-pixel precision - + - + - + - + + Allocates a new #ClutterActorBox using the passed coordinates +for the top left and bottom right points +clutter_actor_box_free() to free the resources + the newly allocated #ClutterActorBox. Use - + X coordinate of the top left point + - + Y coordinate of the top left point + - + X coordinate of the bottom right point + - + Y coordinate of the bottom right point + - - - - - - + + Clamps the components of @box to the nearest integer + + Checks whether a point with @x, @y coordinates is contained +withing @box + + %TRUE if the point is contained by the #ClutterActorBox + + + + + X coordinate of the point + + + + Y coordinate of the point + + + + + + Copies @box +clutter_actor_box_free() to free the allocated resources + + a newly allocated copy of #ClutterActorBox. Use + + + + Checks @box_a and @box_b for equality - + %TRUE if the passed #ClutterActorBox are equal + + a #ClutterActorBox - + + Frees a #ClutterActorBox allocated using clutter_actor_box_new() +or clutter_actor_box_copy() - + - + Calculates the bounding box represented by the four vertices; for details +of the vertex array see clutter_actor_get_abs_allocation_vertices(). - + + + + array of four #ClutterVertex + + + + + - + Retrieves the area of @box - + the area of a #ClutterActorBox, in pixels + + Retrieves the height of the @box - + the height of the box + + Retrieves the origin of @box @@ -3355,24 +4122,24 @@ or clutter_actor_box_copy()" direction="out" caller-allocates="0" transfer-ownership="full" - allow-none="1" - doc="return location for the X coordinate, or %NULL"> - + allow-none="1"> + return location for the X coordinate, or %NULL + - + allow-none="1"> + return location for the Y coordinate, or %NULL + + Retrieves the size of @box @@ -3381,106 +4148,84 @@ or clutter_actor_box_copy()" direction="out" caller-allocates="0" transfer-ownership="full" - allow-none="1" - doc="return location for the width, or %NULL"> - + allow-none="1"> + return location for the width, or %NULL + - + allow-none="1"> + return location for the height, or %NULL + - + Retrieves the width of the @box - + the width of the box + - + Retrieves the X coordinate of the origin of @box - + the X coordinate of the origin + - - - - - - - - - + Retrieves the Y coordinate of the origin of @box - + the Y coordinate of the origin + - - - - - - - + Interpolates between @initial and @final #ClutterActorBox<!-- -->es +using @progress + the final #ClutterActorBox - + the interpolation progress + + transfer-ownership="none"> + return location for the interpolation - - - - - + glib:is-gtype-struct-for="Actor"> + Base class for actors. - + @@ -3492,7 +4237,7 @@ using @progress" - + @@ -3504,7 +4249,7 @@ using @progress" - + @@ -3516,7 +4261,7 @@ using @progress" - + @@ -3528,7 +4273,7 @@ using @progress" - + @@ -3540,7 +4285,7 @@ using @progress" - + @@ -3552,7 +4297,7 @@ using @progress" - + @@ -3564,7 +4309,7 @@ using @progress" - + @@ -3576,7 +4321,7 @@ using @progress" - + @@ -3588,7 +4333,7 @@ using @progress" - + @@ -3603,7 +4348,7 @@ using @progress" - + @@ -3615,7 +4360,7 @@ using @progress" - + @@ -3630,7 +4375,7 @@ using @progress" - + @@ -3645,7 +4390,7 @@ using @progress" - + @@ -3654,25 +4399,30 @@ using @progress" - + available height when computing the preferred width, or a negative value to indicate that no height is defined + - + transfer-ownership="full" + allow-none="1"> + return location for minimum width, or %NULL + - + transfer-ownership="full" + allow-none="1"> + return location for the natural width, or %NULL + - + @@ -3681,25 +4431,30 @@ using @progress" - + available width to assume in computing desired height, or a negative value to indicate that no width is defined + - + transfer-ownership="full" + allow-none="1"> + return location for minimum height, or %NULL + - + transfer-ownership="full" + allow-none="1"> + return location for natural height, or %NULL + - + @@ -3708,16 +4463,18 @@ using @progress" + new allocation of the actor, in parent-relative coordinates + flags that control the allocation - + @@ -3732,9 +4489,9 @@ using @progress" - + - + @@ -3747,9 +4504,9 @@ using @progress" - + - + @@ -3762,9 +4519,9 @@ using @progress" - + - + @@ -3777,9 +4534,9 @@ using @progress" - + - + @@ -3792,9 +4549,9 @@ using @progress" - + - + @@ -3807,9 +4564,9 @@ using @progress" - + - + @@ -3822,9 +4579,9 @@ using @progress" - + - + @@ -3837,9 +4594,9 @@ using @progress" - + - + @@ -3852,9 +4609,9 @@ using @progress" - + - + @@ -3867,9 +4624,9 @@ using @progress" - + - + @@ -3882,7 +4639,7 @@ using @progress" - + @@ -3894,7 +4651,7 @@ using @progress" - + @@ -3906,7 +4663,7 @@ using @progress" - + @@ -3917,17 +4674,30 @@ using @progress" + + + + the #AtkObject associated with @actor + + + + + + + + + - - + + + Flags used to signal the state of an actor. - + + The <structname>ClutterActorMeta</structname> structure contains only +private data and should be accessed using the provided API + + + + + + + + + + + + Retrieves a pointer to the #ClutterActor that owns @meta + + a pointer to a #ClutterActor or %NULL + + + + + Retrieves whether @meta is enabled + + %TRUE if the #ClutterActorMeta instance is enabled + + + + + Retrieves the name set using clutter_actor_meta_set_name() +instance, or %NULL if none was set. The returned string is owned +by the #ClutterActorMeta instance and it should not be modified +or freed + + the name of the #ClutterActorMeta + + + + + Sets whether @meta should be enabled or not + + + + + + whether @meta is enabled + + + + + + Sets the name of @meta +The name can be used to identify the #ClutterActorMeta instance + + + + + + the name of @meta + + + + + + The #ClutterActor attached to the #ClutterActorMeta instance + + + + Whether or not the #ClutterActorMeta is enabled + + + + The unique name to access the #ClutterActorMeta + + + + + + + + + + + The <structname>ClutterActorMetaClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + + + Specifies the axis on which #ClutterAlignConstraint should maintain +the alignment + + + + + <structname>ClutterAlignConstraint</structname> is an opaque structure +whose members cannot be directly accesses + + Creates a new constraint, aligning a #ClutterActor's position with +regards of the size of the actor to @source, with the given +alignment @factor + + the newly created #ClutterAlignConstraint + + + + + the #ClutterActor to use as the source of the alignment, or %NULL + + + + the axis to be used to compute the alignment + + + + the alignment factor, between 0.0 and 1.0 + + + + + + Retrieves the value set using clutter_align_constraint_set_align_axis() + + the alignment axis + + + + + Retrieves the factor set using clutter_align_constraint_set_factor() + + the alignment factor + + + + + Retrieves the source of the alignment +of the alignment + + the #ClutterActor used as the source + + + + + Sets the axis to which the alignment refers to + + + + + + the axis to which the alignment refers to + + + + + + Sets the alignment factor of the constraint +The factor depends on the #ClutterAlignConstraint:align-axis property +and it is a value between 0.0 (meaning left, when +#ClutterAlignConstraint:align-axis is set to %CLUTTER_ALIGN_X_AXIS; or +meaning top, when #ClutterAlignConstraint:align-axis is set to +%CLUTTER_ALIGN_Y_AXIS) and 1.0 (meaning right, when +#ClutterAlignConstraint:align-axis is set to %CLUTTER_ALIGN_X_AXIS; or +meaning bottom, when #ClutterAlignConstraint:align-axis is set to +%CLUTTER_ALIGN_Y_AXIS). A value of 0.5 aligns in the middle in either +cases + + + + + + the alignment factor, between 0.0 and 1.0 + + + + + + Sets the source of the alignment constraint + + + + + + a #ClutterActor, or %NULL to unset the source + + + + + + The axis to be used to compute the alignment + + + + The alignment factor, as a normalized value between 0.0 and 1.0 +The factor depends on the #ClutterAlignConstraint:align-axis property: +with an align-axis value of %CLUTTER_ALIGN_X_AXIS, 0.0 means left and +1.0 means right; with a value of %CLUTTER_ALIGN_Y_AXIS, 0.0 means top +and 1.0 means bottom. + + + + The #ClutterActor used as the source for the alignment + + + + Flags passed to the #ClutterActor::allocate() virtual function and +to the clutter_actor_allocate() function + #ClutterAlpha combines a #ClutterTimeline and a function. +The contents of the #ClutterAlpha structure are private and should +only be accessed using the provided API. - + Creates a new #ClutterAlpha instance. You must set a function to compute the alpha value using clutter_alpha_set_func() and bind a #ClutterTimeline object to the #ClutterAlpha instance using clutter_alpha_set_timeline(). You should use the newly created #ClutterAlpha instance inside -a #ClutterBehaviour object." - version="0.2"> - +a #ClutterBehaviour object. + + the newly created empty #ClutterAlpha instance. - + Creates a new #ClutterAlpha instance and sets the timeline +and animation mode. +See also clutter_alpha_set_timeline() and clutter_alpha_set_mode(). + + the newly created #ClutterAlpha + #ClutterTimeline timeline - + animation mode + + Creates a new #ClutterAlpha instances and sets the timeline and the alpha function. This function will not register @func as a global alpha function. -See also clutter_alpha_set_timeline() and clutter_alpha_set_func()." - version="1.0"> - +See also clutter_alpha_set_timeline() and clutter_alpha_set_func(). + + the newly created #ClutterAlpha + a #ClutterTimeline + a #ClutterAlphaFunc - + data to pass to the function, or %NULL + - + + function to call when removing the alpha function, or %NULL - - - - - - - - - - - - - + #GClosure variant of clutter_alpha_register_func(). Registers a global alpha function and returns its logical id to be used by clutter_alpha_set_mode() or by #ClutterAnimation. -The logical id is always greater than %CLUTTER_ANIMATION_LAST." - version="1.0"> +The logical id is always greater than %CLUTTER_ANIMATION_LAST. - + the logical id of the alpha function + + a #GClosure + + Registers a global alpha function and returns its logical id +to be used by clutter_alpha_set_mode() or by #ClutterAnimation. +The logical id is always greater than %CLUTTER_ANIMATION_LAST. + + the logical id of the alpha function + + + + + a #ClutterAlphaFunc + + + + user data to pass to @func, or %NULL + + + + + Query the current alpha value. - + The current alpha value for the alpha + + + Retrieves the #ClutterAnimationMode used by @alpha. + + the animation mode + + + + + Gets the #ClutterTimeline bound to @alpha. + + a #ClutterTimeline instance + + + + + Sets the #GClosure used to compute the alpha value at each +frame of the #ClutterTimeline bound to @alpha. + + + + + + A #GClosure + + + + + Sets the #ClutterAlphaFunc function used to compute the alpha value at each frame of the #ClutterTimeline bound to @alpha. -This function will not register @func as a global alpha function." - version="0.2"> +This function will not register @func as a global alpha function. @@ -4106,101 +5268,76 @@ This function will not register @func as a global alpha function." + closure="1" + destroy="2"> + A #ClutterAlphaFunc - + user data to be passed to the alpha function, or %NULL + - + + notify function used when disposing the alpha function - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the progress function of @alpha using the symbolic value +of @mode, as taken by the #ClutterAnimationMode enumeration or +using the value returned by clutter_alpha_register_func(). - + a #ClutterAnimationMode + - + + Binds @alpha to @timeline. - + + + + A #ClutterTimeline + + + - + The alpha value as computed by the alpha function. The linear interval is 0.0 to 1.0, but the Alpha allows overshooting by -one unit in each direction, so the valid interval is -1.0 to 2.0."> - +one unit in each direction, so the valid interval is -1.0 to 2.0. + + The progress function logical id - either a value from the #ClutterAnimationMode enumeration or a value returned by clutter_alpha_register_func(). If %CLUTTER_CUSTOM_MODE is used then the function set using clutter_alpha_set_closure() or clutter_alpha_set_func() -will be used."> - +will be used. + - + transfer-ownership="none"> + A #ClutterTimeline instance used to drive the alpha function. + @@ -4212,139 +5349,268 @@ will be used."> + Base class for #ClutterAlpha - - + + - - + + - - + + - - + + - - + + - + + A function returning a value depending on the position of +the #ClutterTimeline bound to @alpha. - + a floating point value + + a #ClutterAlpha - + user data passed to the function + - + - + - + - + - + #ClutterAnimatable is an opaque structure whose members cannot be directly +accessed + + Calls the animate_property() virtual function for @animatable. +The @initial_value and @final_value #GValue<!-- -->s must contain +the same type; @value must have been initialized to the same +type of @initial_value and @final_value. +All implementation of the #ClutterAnimatable interface must +implement this function. +be applied to the #ClutterAnimatable, and %FALSE otherwise - + %TRUE if the value has been validated and can + + a #ClutterAnimation + the name of the animated property + the initial value of the animation interval + the final value of the animation interval - + the progress factor + + return location for the animation value + + + + + + Finds the #GParamSpec for @property_name +or %NULL + + The #GParamSpec for the given property + + + + + the name of the animatable property to find + + + + + + Retrieves the current state of @property_name and sets @value with it + + + + + + the name of the animatable property to retrieve + + + + a #GValue initialized to the type of the property to retrieve + + + + + + Sets the current state of @property_name to @value + + + + + + the name of the animatable property to set + + + + the value of the animatable property to set + Calls the animate_property() virtual function for @animatable. The @initial_value and @final_value #GValue<!-- -->s must contain the same type; @value must have been initialized to the same type of @initial_value and @final_value. All implementation of the #ClutterAnimatable interface must implement this function. -be applied to the #ClutterAnimatable, and %FALSE otherwise" - version="1.0"> +be applied to the #ClutterAnimatable, and %FALSE otherwise - + %TRUE if the value has been validated and can + + a #ClutterAnimation + the name of the animated property + the initial value of the animation interval + the final value of the animation interval - + the progress factor + + return location for the animation value + + + + + + Finds the #GParamSpec for @property_name +or %NULL + + The #GParamSpec for the given property + + + + + the name of the animatable property to find + + + + + + Retrieves the current state of @property_name and sets @value with it + + + + + + the name of the animatable property to retrieve + + + + a #GValue initialized to the type of the property to retrieve + + + + + + Sets the current state of @property_name to @value + + + + + + the name of the animatable property to set + + + + the value of the animatable property to set @@ -4353,37 +5619,101 @@ be applied to the #ClutterAnimatable, and %FALSE otherwise" + Base interface for #GObject<!-- -->s that can be animated by a +a #ClutterAnimation. - + - + %TRUE if the value has been validated and can + + a #ClutterAnimation + the name of the animated property + the initial value of the animation interval + the final value of the animation interval - + the progress factor + + return location for the animation value + + + + + + + + + The #GParamSpec for the given property + + + + + + + + the name of the animatable property to find + + + + + + + + + + + + + + + + the name of the animatable property to retrieve + + + + a #GValue initialized to the type of the property to retrieve + + + + + + + + + + + + + + + + the name of the animatable property to set + + + + the value of the animatable property to set @@ -4391,18 +5721,20 @@ a #ClutterAnimation." + The #ClutterAnimation structure contains only private data and should +be accessed using the provided functions. + Creates a new #ClutterAnimation instance. You should set the #GObject to be animated using clutter_animation_set_object(), set the duration with clutter_animation_set_duration() and the easing mode using clutter_animation_set_mode(). @@ -4413,326 +5745,351 @@ The clutter_actor_animate() and relative family of functions provide an easy way to animate a #ClutterActor and automatically manage the lifetime of a #ClutterAnimation instance, so you should consider using those functions instead of manually creating an animation. -to release the associated resources" - version="1.0"> +to release the associated resources + the newly created #ClutterAnimation. Use g_object_unref() - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a single property with name @property_name to the animation @animation. For more information about animations, see clutter_actor_animate(). This method returns the animation primarily to make chained -calls convenient in language bindings." - version="1.0"> - +calls convenient in language bindings. + + The animation itself. + the property to control + The final value of the property + Binds @interval to the @property_name of the #GObject attached to @animation. The #ClutterAnimation will take ownership of the passed #ClutterInterval. For more information about animations, see clutter_actor_animate(). If you need to update the interval instance use -clutter_animation_update_property() instead." - version="1.0"> - +clutter_animation_update_property() instead. + + The animation itself. + the property to control - + + a #ClutterInterval - + Emits the ::completed signal on @animation +When using this function with a #ClutterAnimation created +by the clutter_actor_animate() family of functions, @animation +will be unreferenced and it will not be valid anymore, +unless g_object_ref() was called before calling this function +or unless a reference was taken inside a handler for the +#ClutterAnimation::completed signal - + + + + + Retrieves the #ClutterAlpha used by @animation. + + the alpha object used by the animation + + + + + Retrieves the duration of @animation, in milliseconds. + + the duration of the animation + + + + + Retrieves the #ClutterInterval associated to @property_name +inside @animation. +property with the same name was found. The returned interval is +owned by the #ClutterAnimation and should not be unreferenced + + a #ClutterInterval or %NULL if no + + name of the property + + + + + + Retrieves whether @animation is looping. + + %TRUE if the animation is looping + + + + + Retrieves the animation mode of @animation, as set by +clutter_animation_set_mode(). + + the mode for the animation + + + + + Retrieves the #GObject attached to @animation. + + a #GObject + + + + + Retrieves the #ClutterTimeline used by @animation + + the timeline used by the animation + + + + + Checks whether @animation is controlling @property_name. +#ClutterAnimation, %FALSE otherwise + + %TRUE if the property is animated by the + + + + + name of the property + + + + + + Sets @alpha as the #ClutterAlpha used by @animation. +If @alpha is not %NULL, the #ClutterAnimation will take ownership +of the #ClutterAlpha instance. + + + + + + a #ClutterAlpha, or %NULL to unset the current #ClutterAlpha + + + + + + Sets the duration of @animation in milliseconds. +This function will set #ClutterAnimation:alpha and +#ClutterAnimation:timeline if needed. + + + + + + the duration in milliseconds + + + + + + Sets whether @animation should loop over itself once finished. +A looping #ClutterAnimation will not emit the #ClutterAnimation::completed +signal when finished. +This function will set #ClutterAnimation:alpha and +#ClutterAnimation:timeline if needed. + + + + + + %TRUE if the animation should loop + + + + + + Sets the animation @mode of @animation. The animation @mode is +a logical id, either coming from the #ClutterAnimationMode enumeration +or the return value of clutter_alpha_register_func(). +This function will also set #ClutterAnimation:alpha if needed. + + + + + + an animation mode logical id + + + + + + Attaches @animation to @object. The #ClutterAnimation will take a +reference on @object. + + + + + + a #GObject + + + + + + Sets the #ClutterTimeline used by @animation. + + + + + + a #ClutterTimeline, or %NULL to unset the current #ClutterTimeline + + + + + + Removes @property_name from the list of animated properties. + + + + + + name of the property - + Updates the @final value of the interval for @property_name + + The animation itself. + name of the property + The final value of the property + Changes the @interval for @property_name. The #ClutterAnimation +will take ownership of the passed #ClutterInterval. + name of the property + a #ClutterInterval - - - - - - - - - - - - - - - - - - - - - - - - - - + transfer-ownership="none"> + The #ClutterAlpha used by the animation. + - + transfer-ownership="none"> + The duration of the animation, expressed in milliseconds. + - + transfer-ownership="none"> + Whether the animation should loop. + + The animation mode, either a value from #ClutterAnimationMode or a value returned by clutter_alpha_register_func(). The -default value is %CLUTTER_LINEAR."> - +default value is %CLUTTER_LINEAR. + - + transfer-ownership="none"> + The #GObject to which the animation applies. + - + transfer-ownership="none"> + The #ClutterTimeline used by the animation. + @@ -4740,36 +6097,34 @@ default value is %CLUTTER_LINEAR."> - + The ::completed signal is emitted once the animation has been completed. The @animation instance is guaranteed to be valid for the entire -duration of the signal emission chain." - version="1.0"> - - +duration of the signal emission chain. + + - - - + + The ::started signal is emitted once the animation has been +started + + + The #ClutterAnimationClass structure contains only private data and +should be accessed using the provided functions. - + @@ -4781,7 +6136,7 @@ should be accessed using the provided functions." - + @@ -4792,57 +6147,57 @@ should be accessed using the provided functions." - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -4850,16 +6205,16 @@ should be accessed using the provided functions." + The animation modes used by #ClutterAlpha and #ClutterAnimation. This +enumeration can be expanded in later versions of Clutter. See the +#ClutterAlpha documentation for a graph of all the animation modes. +Every global alpha function registered using clutter_alpha_register_func() +or clutter_alpha_register_closure() will have a logical id greater than +%CLUTTER_ANIMATION_LAST. - + + The #ClutterAnimator structure contains only private data and +should be accessed using the provided API + Creates a new #ClutterAnimator instance + a new #ClutterAnimator. - - - + Compute the value for a managed property at a given progress. +If the property is an ease-in property, the current value of the property +on the object will be used as the starting point for computation. +an error occurs or the progress is before any of the keys) %FALSE is +returned and the #GValue is left untouched + + %TRUE if the computation yields has a value, otherwise (when + + a #GObject + the name of the property on object to check - - - - - + + a value between 0.0 and 1.0 + + an initialized value to store the computed result + + Retrieves the current duration of an animator + + the duration of the animation, in milliseconds + + + + + Returns a list of pointers to opaque structures with accessor functions +that describe the keys added to an animator. +list of #ClutterAnimatorKey<!-- -->s; the contents of the list are owned +by the #ClutterAnimator, but you should free the returned list when done, +using g_list_free() + + a + + + + + + + a #GObject to search for, or %NULL for all objects + + + + a specific property name to query for, or %NULL for all properties + + + + a specific progress to search for, or a negative value for all progresses + + + + + + Get the timeline hooked up for driving the #ClutterAnimator + + the #ClutterTimeline that drives the animator + + + + + Checks if a property value is to be eased into the animation. + + %TRUE if the property is eased in + + + + + a #GObject + + + + the name of a property on object + + + + + + Get the interpolation used by animator for a property on a particular +object. + + a ClutterInterpolation value. + + + + + a #GObject + + + + the name of a property on object + + + + + + Sets whether a property value is to be eased into the animation. + + + + + + a #GObject + + + + the name of a property on object + + + + we are going to be easing in this property + + + + + + Set the interpolation method to use, %CLUTTER_INTERPOLATION_LINEAR causes +the values to linearly change between the values, and +%CLUTTER_INTERPOLATION_CUBIC causes the values to smoothly change between +the values. + + + + + + a #GObject + + + + the name of a property on object + + + + the #ClutterInterpolation to use + + + + + + Removes all keys matching the conditions specificed in the arguments. + + + + + + a #GObject to search for, or %NULL for all + + + + a specific property name to query for, or %NULL for all + + + + a specific progress to search for or a negative value for all + + + + + Adds multiple keys to a #ClutterAnimator, specifying the value a given property should have at a given progress of the animation. The mode specified is the mode used when going to this key from the previous key of the @property_name If a given (object, property, progress) tuple already exist the mode and -value will be replaced with the new values." - version="1.2"> +value will be replaced with the new values. - + a #GObject + + the property to specify a key for - + the id of the alpha function to use + - - + + at which stage of the animation this value applies; the range is a normalized floating point value between 0 and 1 + @@ -5073,230 +6598,91 @@ value will be replaced with the new values." - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Runs the timeline of the #ClutterAnimator with a duration in msecs +as specified. - + milliseconds a run of the animator should last. + - + Sets a single key in the #ClutterAnimator for the @property_name of - + The animator instance + + a #GObject + the property to specify a key for + + the id of the alpha function to use + + + + the normalized range at which stage of the animation this value applies + + + + the value property_name should have at progress. + + - + Sets an external timeline that will be used for driving the animation - - - - - - - - + + a #ClutterTimeline + - - - - - - - - - - - - - - + + Start the ClutterAnimator, this is a thin wrapper that rewinds +and starts the animators current timeline. +the animator. The returned timeline is owned by the #ClutterAnimator +and it should not be unreferenced - + the #ClutterTimeline that drives + - - - - - - - - - - - - + transfer-ownership="none"> + The duration of the #ClutterTimeline used by the #ClutterAnimator +to drive the animation + - + transfer-ownership="none"> + The #ClutterTimeline used by the #ClutterAnimator to drive the +animation + @@ -5308,99 +6694,106 @@ animation"> + The #ClutterAnimatorClass structure contains only private data - + + glib:get-type="clutter_animator_key_get_type" + c:symbol-prefix="animator_key"> + A key frame inside a #ClutterAnimator + + Retrieves the mode of a #ClutterAnimator key, for the first key of a +property for an object this represents the whether the animation is +open ended and or curved for the remainding keys for the property it +represents the easing mode. + + the mode of a #ClutterAnimatorKey + + + - + Retrieves the object a key applies to. + + the object an animator_key exist for. + + Retrieves the progress of an clutter_animator_key + + the progress defined for a #ClutterAnimator key. + + + + Retrieves the name of the property a key applies to. + the name of the property an animator_key exist for. + Retrieves the #GType of the property a key applies to You can use this type to initialize the #GValue to pass to -clutter_animator_key_get_value()" - version="1.2"> +clutter_animator_key_get_value() + the #GType of the property - - - - - - - - - - + Retrieves a copy of the value for a #ClutterAnimatorKey. The passed in #GValue needs to be already initialized for the value type of the key or to a type that allow transformation from the value type of the key. Use g_value_unset() when done. -%FALSE otherwise" - version="1.2"> +%FALSE otherwise - + %TRUE if the passed #GValue was successfully set, and + + a #GValue initialized with the correct type for the animator key - + - + + Common members for a #ClutterEvent - + @@ -5413,555 +6806,634 @@ Use g_value_unset() when done. - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + + + + + + + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - + + @@ -5970,6 +7442,36 @@ Use g_value_unset() when done. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -5980,19 +7482,14 @@ Use g_value_unset() when done. - + - + - - - - - - - - + + + @@ -6005,154 +7502,160 @@ Use g_value_unset() when done. - + + Retrieves the distance used to verify a double click event - + a distance, in pixels. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + version="0.4" + deprecated="Use #ClutterSettings:double-click-time instead" + deprecated-version="1.4"> + Gets the maximum time between two button press events, as set +by clutter_backend_set_double_click_time(). - + a time in milliseconds + + + + + Retrieves the default font name as set by +clutter_backend_set_font_name(). +owned by the #ClutterBackend and should never be modified or freed + + the font name for the backend. The returned string is + + + + + Retrieves the font options for @backend. +The returned #cairo_font_options_t is owned by the backend and should +not be modified or freed + + the font options of the #ClutterBackend. + + + + + Gets the resolution for font handling on the screen. +The resolution is a scale factor between points specified in a +#PangoFontDescription and cairo units. The default value is 96.0, +meaning that a 10 point font will be 13 units +high (10 * 96. / 72. = 13.3). +Clutter will set the resolution using the current backend when +initializing; the resolution is also stored in the +#ClutterSettings:font-dpi property. +has been set. + + the current resolution, or -1 if no resolution + + version="0.4" + deprecated="Use #ClutterSettings:double-click-distance instead" + deprecated-version="1.4"> + Sets the maximum distance used to verify a double click event. - + a distance, in pixels + - - - - - - + + Sets the maximum time between two button press events, used to +verify whether it's a double click event or not. - - + + milliseconds between two button press events + - - - - - + Sets the default font to be used by Clutter. The @font_name string must either be %NULL, which means that the font name from the default #ClutterBackend will be used; or be something that can -be parsed by the pango_font_description_from_string() function." - version="1.0"> +be parsed by the pango_font_description_from_string() function. + the name of the font - + + Sets the new font options for @backend. The #ClutterBackend will +copy the #cairo_font_options_t. +If @options is %NULL, the first following call to +clutter_backend_get_font_options() will return the default font +options for @backend. +This function is intended for actors creating a Pango layout +using the PangoCairo API. - + + + + Cairo font options for the backend, or %NULL + + + + + + Sets the resolution for font handling on the screen. This is a +scale factor between points specified in a #PangoFontDescription +and cairo units. The default value is 96, meaning that a 10 point +font will be 13 units high. (10 * 96. / 72. = 13.3). +Applications should never need to call this function. + + + + + + the resolution in "dots per inch" (Physical inches aren't actually involved; the terminology is conventional). + + + @@ -6161,13 +7664,18 @@ owned by the #ClutterBackend and should never be modified or freed" - - + + - - + + + + + + + @@ -6178,9 +7686,9 @@ owned by the #ClutterBackend and should never be modified or freed" - + - + @@ -6190,9 +7698,9 @@ owned by the #ClutterBackend and should never be modified or freed" - + - + @@ -6201,9 +7709,9 @@ owned by the #ClutterBackend and should never be modified or freed" - - - + + + @@ -6217,7 +7725,7 @@ owned by the #ClutterBackend and should never be modified or freed" - + @@ -6229,7 +7737,7 @@ owned by the #ClutterBackend and should never be modified or freed" - + @@ -6241,7 +7749,7 @@ owned by the #ClutterBackend and should never be modified or freed" - + @@ -6256,8 +7764,8 @@ owned by the #ClutterBackend and should never be modified or freed" - - + + @@ -6268,7 +7776,7 @@ owned by the #ClutterBackend and should never be modified or freed" - + @@ -6283,9 +7791,9 @@ owned by the #ClutterBackend and should never be modified or freed" - + - + @@ -6295,7 +7803,7 @@ owned by the #ClutterBackend and should never be modified or freed" - + @@ -6309,9 +7817,9 @@ owned by the #ClutterBackend and should never be modified or freed" - - - + + + @@ -6321,8 +7829,41 @@ owned by the #ClutterBackend and should never be modified or freed" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -6334,7 +7875,19 @@ owned by the #ClutterBackend and should never be modified or freed" - + + + + + + + + + + + + + @@ -6346,21 +7899,25 @@ owned by the #ClutterBackend and should never be modified or freed" - + + + + - + + #ClutterBehaviour-struct contains only private data and should +be accessed with the functions below. @@ -6368,49 +7925,14 @@ be accessed with the functions below." - + - - - - - - - - - - - - - - - - - - - - - - - - - + Calls @func for every actor driven by @behave. @@ -6418,46 +7940,42 @@ the actor." + closure="1"> + a function called for each actor - + optional data to be passed to the function, or %NULL + - + Applies @behave to @actor. This function adds a reference on +the actor. - - - - - - + - - + + a #ClutterActor + + Retrieves all the actors to which @behave applies. It is not recommended +for derived classes to use this in there alpha notify method but use #clutter_behaviour_actors_foreach as it avoids alot of needless allocations. actors. You should free the returned list with g_slist_free() when -finished using it." - version="0.2"> - +finished using it. + + a list of @@ -6465,54 +7983,104 @@ finished using it." - + Retrieves the #ClutterAlpha object bound to @behave. +object has been bound to this behaviour. + + a #ClutterAlpha object, or %NULL if no alpha - + Gets the number of actors this behaviour is applied too. - + The number of applied actors + + + + + Gets an actor the behaviour was applied to referenced by index num. + + A Clutter actor or NULL if @index_ is invalid. + - - + + the index of an actor this behaviour is applied too. + + Check if @behave applied to @actor. - + TRUE if actor has behaviour. FALSE otherwise. + + a #ClutterActor + + Removes @actor from the list of #ClutterActor<!-- -->s to which + + + + + + a #ClutterActor + + + + + + Removes every actor from the list that @behave holds. + + + + + + Binds @alpha to a #ClutterBehaviour. The #ClutterAlpha object +used by #ClutterAlpha a new value of the alpha parameter is +computed by the alpha function; the value should be used by +the #ClutterBehaviour to update one or more properties of the +actors to which the behaviour applies. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. + + + + + + a #ClutterAlpha or %NULL to unset a previously set alpha + + + + + The #ClutterAlpha object used to drive this behaviour. A #ClutterAlpha object binds a #ClutterTimeline and a function which computes a value -(the "alpha") depending on the time. Each time the alpha value changes -the alpha-notify virtual function is called."> - +(the "alpha") depending on the time. Each time the alpha value changes +the alpha-notify virtual function is called. + @@ -6520,28 +8088,29 @@ the alpha-notify virtual function is called."> - - - + + The ::apply signal is emitted each time the behaviour is applied +to an actor. + + - - + + the actor the behaviour was applied to. + - - - + + The ::removed signal is emitted each time a behaviour is not applied +to an actor anymore. + + - - + + the removed actor + @@ -6553,7 +8122,7 @@ to an actor anymore."> - + @@ -6562,13 +8131,13 @@ to an actor anymore."> - + - + @@ -6583,7 +8152,7 @@ to an actor anymore."> - + @@ -6597,43 +8166,43 @@ to an actor anymore."> - - + + - - + + - - + + - - + + - - + + - - + + @@ -6641,55 +8210,47 @@ to an actor anymore."> + The #ClutterBehaviourDepth structure contains only private data +and should be accessed using the provided API + Creates a new #ClutterBehaviourDepth which can be used to control +the ClutterActor:depth property of a set of #ClutterActor<!-- -->s. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + the newly created behaviour + - + + a #ClutterAlpha instance, or %NULL - + initial value of the depth + - + final value of the depth + - - - - - - - - - - - - - + Gets the boundaries of the @behaviour @@ -6698,27 +8259,49 @@ the ClutterActor:depth property of a set of #ClutterActor<!-- -->s." direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the initial depth value, or %NULL + - + return location for the final depth value, or %NULL + + + + + + Sets the boundaries of the @behaviour. + + + + + + initial value of the depth + + + + final value of the depth + - + transfer-ownership="none"> + End depth level to apply to the actors. + - + transfer-ownership="none"> + Start depth level to apply to the actors. + @@ -6731,83 +8314,115 @@ the ClutterActor:depth property of a set of #ClutterActor<!-- -->s." + The #ClutterBehaviourDepthClass structure contains only private data - + + The #ClutterBehaviourEllipse struct contains only private data +and should be accessed using the provided API + Creates a behaviour that drives actors along an elliptical path with given center, width and height; the movement starts at @start -degrees (with 0 corresponding to 12 o'clock) and ends at @end +degrees (with 0 corresponding to 12 o'clock) and ends at @end degrees. Angles greated than 360 degrees get clamped to the canonical interval <0, 360); if @start is equal to @end, the behaviour will -rotate by exacly 360 degrees." - version="0.4"> +rotate by exacly 360 degrees. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + the newly created #ClutterBehaviourEllipse + - + + a #ClutterAlpha instance, or %NULL - + x coordinace of the center + - + y coordiance of the center + - + width of the ellipse + - + height of the ellipse + + #ClutterRotateDirection of rotation - + angle in degrees at which movement starts, between 0 and 360 + - + angle in degrees at which movement ends, between 0 and 360 + - + Gets the at which movements ends. - + angle in degrees + + + + + Gets the angle at which movements starts. + + angle in degrees + + + + + Gets the tilt of the ellipse around the center in the given axis. + + angle in degrees. + - - - - - + + a #ClutterRotateAxis + + Gets the center of the elliptical path path. @@ -6816,156 +8431,40 @@ rotate by exacly 360 degrees." direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the X coordinate of the center, or %NULL + - + return location for the Y coordinate of the center, or %NULL + - + Retrieves the #ClutterRotateDirection used by the ellipse behaviour. - + the rotation direction + - - - - - - - - - - - - - - - - - - - - + Gets the height of the elliptical path. - + the height of the path + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Gets the tilt of the ellipse around the center in Y axis. @@ -6974,96 +8473,226 @@ to the canonical interval <0, 360)." direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for tilt angle on the X axis, or %NULL. + - + return location for tilt angle on the Y axis, or %NULL. + - + return location for tilt angle on the Z axis, or %NULL. + - - - + Gets the width of the elliptical path. + + the width of the path + + + Sets the angle at which movement ends; angles >= 360 degress get clamped +to the canonical interval <0, 360). + + + + + + angle at which movement ends in degrees, between 0 and 360. + + + + + + Sets the angle at which movement starts; angles >= 360 degress get clamped +to the canonical interval <0, 360). + + + + + + angle at which movement starts in degrees, between 0 and 360. + + + + + + Sets the angle at which the ellipse should be tilted around it's center. + + + + + + a #ClutterRotateAxis + + + + tilt of the elipse around the center in the given axis in degrees. + + + + + + Sets the center of the elliptical path to the point represented by knot. + + + + + + x coordinace of centre + + + + y coordinace of centre + + + + + Sets the rotation direction used by the ellipse behaviour. + the rotation direction + + Sets the height of the elliptical path. + + + + + + height of the ellipse + + + + + + Sets the angles at which the ellipse should be tilted around it's center. + + + + + + tilt of the elipse around the center in X axis in degrees. + + + + tilt of the elipse around the center in Y axis in degrees. + + + + tilt of the elipse around the center in Z axis in degrees. + + + + + + Sets the width of the elliptical path. + + + + + + width of the ellipse + + + + - + transfer-ownership="none"> + The final angle to where the rotation should end. + - + transfer-ownership="none"> + The initial angle from where the rotation should start. + - + transfer-ownership="none"> + The tilt angle for the rotation around center in X axis + - + transfer-ownership="none"> + The tilt angle for the rotation around center in Y axis + - + transfer-ownership="none"> + The tilt angle for the rotation on the Z axis + - + transfer-ownership="none"> + The center of the ellipse. + - + transfer-ownership="none"> + The direction of the rotation. + - + transfer-ownership="none"> + Height of the ellipse, in pixels + - + transfer-ownership="none"> + Width of the ellipse, in pixels + @@ -7076,115 +8705,135 @@ to the canonical interval <0, 360)." + The #ClutterBehaviourEllipseClass struct contains only private data + c:type="ClutterBehaviourEllipsePrivate" + disguised="1"> + This function is passed to clutter_behaviour_foreach_actor() and +will be called for each actor driven by @behaviour. + the #ClutterBehaviour + an actor driven by @behaviour - + optional data passed to the function + + The #ClutterBehaviourOpacity structure contains only private data and +should be accessed using the provided API + Creates a new #ClutterBehaviourOpacity object, driven by @alpha +which controls the opacity property of every actor, making it +change in the interval between @opacity_start and @opacity_end. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + the newly created #ClutterBehaviourOpacity + - + + a #ClutterAlpha instance, or %NULL - + minimum level of opacity + - + maximum level of opacity + - + Gets the initial and final levels of the opacity applied by @behaviour +on each actor it controls. - - + + return location for the minimum level of opacity, or %NULL + - - + + return location for the maximum level of opacity, or %NULL + - + Sets the initial and final levels of the opacity applied by @behaviour +on each actor it controls. - - - + minimum level of opacity + - - - + maximum level of opacity + - + transfer-ownership="none"> + Final opacity level of the behaviour. + - + transfer-ownership="none"> + Initial opacity level of the behaviour. + @@ -7197,109 +8846,132 @@ on each actor it controls." + The #ClutterBehaviourOpacityClass structure contains only private data + c:type="ClutterBehaviourOpacityPrivate" + disguised="1"> + The #ClutterBehaviourPath structure contains only private data +and should be accessed using the provided API + Creates a new path behaviour. You can use this behaviour to drive actors along the nodes of a path, described by @path. This will claim the floating reference on the #ClutterPath so you -do not need to unref if it." - version="0.2"> +do not need to unref if it. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + a #ClutterBehaviour + - + + a #ClutterAlpha instance, or %NULL + a #ClutterPath or %NULL for an empty path + Creates a new path behaviour using the path described by @desc. See +clutter_path_add_string() for a description of the format. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + a #ClutterBehaviour + - + + a #ClutterAlpha instance, or %NULL + a string description of the path + Creates a new path behaviour that will make the actors visit all of the given knots in order with straight lines in between. A path will be created where the first knot is used in a %CLUTTER_PATH_MOVE_TO and the subsequent knots are used in -%CLUTTER_PATH_LINE_TO<!-- -->s." - version="1.0"> +%CLUTTER_PATH_LINE_TO<!-- -->s. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + a #ClutterBehaviour + - + + a #ClutterAlpha instance, or %NULL + an array of #ClutterKnot<!-- -->s - + number of entries in @knots + + + Get the current path of the behaviour + + the path + + + + Change the path that the actors will follow. This will take the +floating reference on the #ClutterPath so you do not need to unref +it. + the new path to follow - - - - - - - + + @@ -7308,16 +8980,16 @@ it." - - - + + This signal is emitted each time a node defined inside the path +is reached. + + - - + + the index of the #ClutterKnot reached + @@ -7329,7 +9001,7 @@ is reached." - + @@ -7338,87 +9010,128 @@ is reached." - + - - + + - - + + - - + + - - + + - + - + + The #ClutterBehaviourRotate struct contains only private data and +should be accessed using the provided API + Creates a new #ClutterBehaviourRotate. This behaviour will rotate actors bound to it on @axis, following @direction, between @angle_start and <0, 360), if angle_start == angle_end, the behaviour will carry out a -single rotation of 360 degrees." - version="0.4"> +single rotation of 360 degrees. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + the newly created #ClutterBehaviourRotate. + - + + a #ClutterAlpha instance, or %NULL + the rotation axis + the rotation direction - + the starting angle in degrees, between 0 and 360. + - + the final angle in degrees, between 0 and 360. + + + Retrieves the #ClutterRotateAxis used by the rotate behaviour. + + the rotation axis + + + + + Retrieves the rotation boundaries of the rotate behaviour. + + + + + + return value for the initial angle + + + + return value for the final angle + + + + + Retrieves the center of rotation set using +clutter_behaviour_rotate_set_center(). @@ -7427,164 +9140,152 @@ clutter_behaviour_rotate_set_center()." direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the X center of rotation + - + return location for the Y center of rotation + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + return location for the Z center of rotation + - + Retrieves the #ClutterRotateDirection used by the rotate behaviour. + + the rotation direction - + Sets the axis used by the rotate behaviour. - - - - - - - - - - - - - - - + + a #ClutterRotateAxis + + Sets the initial and final angles of a rotation behaviour; angles >= 360 +degrees get clamped to the canonical interval <0, 360). - + initial angle in degrees, between 0 and 360. + - + final angle in degrees, between 0 and 360. + + + + + + Sets the center of rotation. The coordinates are relative to the plane +normal to the rotation axis set with clutter_behaviour_rotate_set_axis(). + + + + + + X axis center of rotation + + + + Y axis center of rotation + + + + Z axis center of rotation + + + + + + Sets the rotation direction used by the rotate behaviour. + + + + + + the rotation direction + - + transfer-ownership="none"> + The final angle to where the rotation should end. + - + transfer-ownership="none"> + The initial angle from whence the rotation should start. + - + transfer-ownership="none"> + The axis of rotation. + - + transfer-ownership="none"> + The x center of rotation. + - + transfer-ownership="none"> + The y center of rotation. + - + transfer-ownership="none"> + The z center of rotation. + - + transfer-ownership="none"> + The direction of the rotation. + @@ -7597,76 +9298,65 @@ degrees get clamped to the canonical interval <0, 360)." + The #ClutterBehaviourRotateClass struct contains only private data + c:type="ClutterBehaviourRotatePrivate" + disguised="1"> + The #ClutterBehaviourScale struct contains only private data and +should be accessed using the provided API + Creates a new #ClutterBehaviourScale instance. +If @alpha is not %NULL, the #ClutterBehaviour will take ownership +of the #ClutterAlpha instance. In the case when @alpha is %NULL, +it can be set later with clutter_behaviour_set_alpha(). - + the newly created #ClutterBehaviourScale + - + + a #ClutterAlpha instance, or %NULL - + initial scale factor on the X axis + - + initial scale factor on the Y axis + - + final scale factor on the X axis + - + final scale factor on the Y axis + - - - - - - - - - - - - - - - - - - - + Retrieves the bounds used by scale behaviour. @@ -7674,56 +9364,86 @@ should be accessed using the provided API" - + transfer-ownership="full"> + return location for the initial scale factor on the X axis, or %NULL + - + transfer-ownership="full"> + return location for the initial scale factor on the Y axis, or %NULL + - + transfer-ownership="full"> + return location for the final scale factor on the X axis, or %NULL + - + transfer-ownership="full"> + return location for the final scale factor on the Y axis, or %NULL + + + + + + Sets the bounds used by scale behaviour. + + + + + + initial scale factor on the X axis + + + + initial scale factor on the Y axis + + + + final scale factor on the X axis + + + + final scale factor on the Y axis + - + transfer-ownership="none"> + The final scaling factor on the X axis for the actors. + - + transfer-ownership="none"> + The initial scaling factor on the X axis for the actors. + - + transfer-ownership="none"> + The final scaling factor on the Y axis for the actors. + - + transfer-ownership="none"> + The initial scaling factor on the Y axis for the actors. + @@ -7736,20 +9456,22 @@ should be accessed using the provided API" + The #ClutterBehaviourScaleClass struct contains only private data - + + The alignment policies available on each axis for #ClutterBinLayout + The #ClutterBinLayout structure contains only private data +and should be accessed using the provided API - - + Creates a new #ClutterBinLayout layout manager + + the newly created layout manager + - + + the default alignment policy to be used on the horizontal axis - + + the default alignment policy to be used on the vertical axis - + + Adds a #ClutterActor to the container using @self and +sets the alignment policies for it +This function is equivalent to clutter_container_add_actor() +and clutter_layout_manager_child_set_property() but it does not +require a pointer to the #ClutterContainer associated to the +#ClutterBinLayout - + + a #ClutterActor - + + horizontal alignment policy for @child - + + vertical alignment policy for @child + Retrieves the horizontal and vertical alignment policies for a child of @self If @child is %NULL the default alignment policies will be returned -instead" - version="1.2"> +instead - + + a child of @container + allow-none="1"> + return location for the horizontal alignment policy + allow-none="1"> + return location for the vertical alignment policy - + Sets the horizontal and vertical alignment policies to be applied +to a @child of @self +If @child is %NULL then the @x_align and @y_align values will +be set as the default alignment policies - + + a child of @container + the horizontal alignment policy to be used for the @child inside @container + the vertical aligment policy to be used on the @child inside @container @@ -7891,16 +9608,18 @@ require a pointer to the #ClutterContainer associated to the - + transfer-ownership="none"> + The default horizontal alignment policy for actors managed +by the #ClutterBinLayout + - + transfer-ownership="none"> + The default vertical alignment policy for actors managed +by the #ClutterBinLayout + @@ -7912,68 +9631,238 @@ by the #ClutterBinLayout"> + The #ClutterBinLayoutClass structure contains only private +data and should be accessed using the provided API - + + + <structname>ClutterBindConstraint</structname> is an opaque structure +whose members cannot be directly accessed + + Creates a new constraint, binding a #ClutterActor's position to +the given @coordinate of the position of @source + + the newly created #ClutterBindConstraint + + + + + the #ClutterActor to use as the source of the binding, or %NULL + + + + the coordinate to bind + + + + the offset to apply to the binding, in pixels + + + + + + Retrieves the bound coordinate of the constraint + + the bound coordinate + + + + + Retrieves the offset set using clutter_bind_constraint_set_offset() + + the offset, in pixels + + + + + Retrieves the #ClutterActor set using clutter_bind_constraint_set_source() + + a pointer to the source actor + + + + + Sets the coordinate to bind in the constraint + + + + + + the coordinate to bind + + + + + + Sets the offset to be applied to the constraint + + + + + + the offset to apply, in pixels + + + + + + Sets the source #ClutterActor for the constraint + + + + + + a #ClutterActor, or %NULL to unset the source + + + + + + The coordinate to be bound + + + + The offset, in pixels, to be applied to the binding + + + + The #ClutterActor used as the source for the binding + + + + + Specifies which property should be used in a binding + + + + + + The prototype for the callback function registered with clutter_binding_pool_install_action() and invoked by clutter_binding_pool_activate(). -binding has been handled, and return %FALSE otherwise" - version="1.0"> +binding has been handled, and return %FALSE otherwise - + the function should return %TRUE if the key + + a #GObject + the name of the action - + the key symbol + + bitmask of the modifier flags + Container of key bindings. The #ClutterBindingPool struct is +private. + Creates a new #ClutterBindingPool that can be used to store key bindings for an actor. The @name must be a unique identifier for the binding pool, so that clutter_binding_pool_find() will be able to return the correct binding pool. -name. Use g_object_unref() when done." - version="1.0"> +name. Use g_object_unref() when done. + the newly created binding pool with the given + the name of the binding pool + + Finds the #ClutterBindingPool with @name. + + a pointer to the #ClutterBindingPool, or %NULL + + + + + the name of the binding pool to find + + + + + Retrieves the #ClutterBindingPool for the given #GObject class and, eventually, creates it. This function is a wrapper around clutter_binding_pool_new() and uses the class type name as the unique name for the binding pool. @@ -7985,205 +9874,22 @@ clutter_binding_pool_find() with the class type name: pool = clutter_binding_pool_find (G_OBJECT_TYPE_NAME (instance)); ]| The returned #ClutterBindingPool is owned by Clutter and should not -be freed directly" - version="1.0"> - +be freed directly + + the binding pool for the given class. - + a #GObjectClass pointer + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Activates the callback associated to the action that is bound to the @key_val and @modifiers pair. The callback has the following signature: |[ @@ -8198,48 +9904,240 @@ is the one passed when installing the action with clutter_binding_pool_install_action(). If the action bound to the @key_val, @modifiers pair has been blocked using clutter_binding_pool_block_action(), the callback -will not be invoked, and this function will return %FALSE." - version="1.0"> +will not be invoked, and this function will return %FALSE. - + %TRUE if an action was found and was activated + - + the key symbol + + bitmask for the modifiers + a #GObject + Blocks all the actions with name @action_name inside @pool. + an action name + + Retrieves the name of the action matching the given key symbol +and modifiers bitmask. +returned string is owned by the binding pool and should never +be modified or freed + + the name of the action, if found, or %NULL. The + + + + + a key symbol + + + + a bitmask for the modifiers + + + + + + Installs a new action inside a #ClutterBindingPool. The action +is bound to @key_val and @modifiers. +The same action name can be used for multiple @key_val, @modifiers +pairs. +When an action has been activated using clutter_binding_pool_activate() +the passed @callback will be invoked (with @data). +Actions can be blocked with clutter_binding_pool_block_action() +and then unblocked using clutter_binding_pool_unblock_action(). + + + + + + the name of the action + + + + key symbol + + + + bitmask of modifiers + + + + function to be called when the action is activated + + + + data to be passed to @callback + + + + function to be called when the action is removed from the pool + + + + + + A #GClosure variant of clutter_binding_pool_install_action(). +Installs a new action inside a #ClutterBindingPool. The action +is bound to @key_val and @modifiers. +The same action name can be used for multiple @key_val, @modifiers +pairs. +When an action has been activated using clutter_binding_pool_activate() +the passed @closure will be invoked. +Actions can be blocked with clutter_binding_pool_block_action() +and then unblocked using clutter_binding_pool_unblock_action(). + + + + + + the name of the action + + + + key symbol + + + + bitmask of modifiers + + + + a #GClosure + + + + + + Allows overriding the action for @key_val and @modifiers inside a +#ClutterBindingPool. See clutter_binding_pool_install_action(). +When an action has been activated using clutter_binding_pool_activate() +the passed @callback will be invoked (with @data). +Actions can be blocked with clutter_binding_pool_block_action() +and then unblocked using clutter_binding_pool_unblock_action(). + + + + + + key symbol + + + + bitmask of modifiers + + + + function to be called when the action is activated + + + + data to be passed to @callback + + + + function to be called when the action is removed from the pool + + + + + + A #GClosure variant of clutter_binding_pool_override_action(). +Allows overriding the action for @key_val and @modifiers inside a +#ClutterBindingPool. See clutter_binding_pool_install_closure(). +When an action has been activated using clutter_binding_pool_activate() +the passed @callback will be invoked (with @data). +Actions can be blocked with clutter_binding_pool_block_action() +and then unblocked using clutter_binding_pool_unblock_action(). + + + + + + key symbol + + + + bitmask of modifiers + + + + a #GClosure + + + + + + Removes the action matching the given @key_val, @modifiers pair, +if any exists. + + + + + + a key symbol + + + + a bitmask for the modifiers + + + + + Unblockes all the actions with name @action_name inside @pool. Unblocking an action does not cause the callback bound to it to be invoked in case clutter_binding_pool_activate() was called on -an action previously blocked with clutter_binding_pool_block_action()." - version="1.0"> +an action previously blocked with clutter_binding_pool_block_action(). + an action name @@ -8248,83 +10146,77 @@ an action previously blocked with clutter_binding_pool_block_action()." version="1.0" writable="1" construct-only="1" - doc="The unique name of the #ClutterBindingPool."> - + transfer-ownership="none"> + The unique name of the #ClutterBindingPool. + + + + + + + + + <structname>ClutterBlurEffect</structname> is an opaque structure +whose members cannot be accessed directly + + Creates a new #ClutterBlurEffect to be used with +clutter_actor_add_effect() + + the newly created #ClutterBlurEffect or %NULL + + + + + + + - + + The #ClutterBox structure contains only private data and should +be accessed using the provided API + + - - - + + Creates a new #ClutterBox. The children of the box will be layed +out by the passed @manager + + the newly created #ClutterBox actor + + a #ClutterLayoutManager - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves the background color of @box +If the #ClutterBox:color-set property is set to %FALSE the +returned #ClutterColor is undefined @@ -8332,29 +10224,43 @@ returned #ClutterColor is undefined" + transfer-ownership="none"> + return location for a #ClutterColor + + Retrieves the #ClutterLayoutManager instance used by @box +#ClutterLayoutManager is owned by the #ClutterBox and it should not +be unreferenced + + a #ClutterLayoutManager. The returned + + + + Adds @actor to @box and sets layout properties at the same time, if the #ClutterLayoutManager used by @box has them This function is a wrapper around clutter_container_add_actor() and clutter_layout_manager_child_set() Language bindings should use the vector-based clutter_box_addv() -variant instead" - version="1.2"> +variant instead + a #ClutterActor + the name of the first property to set, or %NULL @@ -8363,91 +10269,30 @@ variant instead" - - - - - - - - - - - - - - - - - - - - - - - + Adds @actor to @box, placing it after @sibling, and sets layout properties at the same time, if the #ClutterLayoutManager used by If @sibling is %NULL then @actor is placed at the end of the list of children, to be allocated and painted after every other child This function is a wrapper around clutter_container_add_actor(), -clutter_container_raise_child() and clutter_layout_manager_child_set()" - version="1.2"> +clutter_container_raise_child() and clutter_layout_manager_child_set() + a #ClutterActor - - - - - - - - - - - - - - - - - - - - - + + a #ClutterActor or %NULL + the name of the first property to set, or %NULL @@ -8458,23 +10303,27 @@ clutter_container_lower_child() and clutter_layout_manager_child_set()" + Adds @actor to @box, placing it at @position, and sets layout properties at the same time, if the #ClutterLayoutManager used by If @position is a negative number, or is larger than the number of children of @box, the new child is added at the end of the list of -children" - version="1.2"> +children + a #ClutterActor - + the position to insert the @actor at + + the name of the first property to set, or %NULL @@ -8483,26 +10332,120 @@ children" + + Adds @actor to @box, placing it before @sibling, and sets layout +properties at the same time, if the #ClutterLayoutManager used by +If @sibling is %NULL then @actor is placed at the beginning of the +list of children, to be allocated and painted below every other child +This function is a wrapper around clutter_container_add_actor(), +clutter_container_lower_child() and clutter_layout_manager_child_set() + + + + + + a #ClutterActor + + + + a #ClutterActor or %NULL + + + + the name of the first property to set, or %NULL + + + + + + + + + + Vector-based variant of clutter_box_pack(), intended for language +bindings to use + + + + + + a #ClutterActor + + + + the number of properties to set + + + + a vector containing the property names to set + + + + + + a vector containing the property values to set + + + + + + + + Sets (or unsets) the background color for @box + + + + + + the background color, or %NULL to unset + + + + + + Sets the #ClutterLayoutManager for @box +A #ClutterLayoutManager is a delegate object that controls the +layout of the children of @box + + + + + + a #ClutterLayoutManager + + + + + The color to be used to paint the background of the #ClutterBox. Setting this property will set the -#ClutterBox:color-set property as a side effect"> - +#ClutterBox:color-set property as a side effect + - + transfer-ownership="none"> + Whether the #ClutterBox:color property has been set + - + transfer-ownership="none"> + The #ClutterLayoutManager used by the #ClutterBox + @@ -8512,11 +10455,11 @@ children" + The alignment policies available on each axis of the #ClutterBoxLayout + The #ClutterBoxClass structure contains only private data - - + + - - + + - - + + - - + + - - + + - - + + @@ -8582,366 +10525,431 @@ children" + The #ClutterBoxLayout structure contains only private data +and should be accessed using the provided API - - + Creates a new #ClutterBoxLayout layout manager + + the newly created #ClutterBoxLayout + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves the horizontal and vertical alignment policies for @actor +as set using clutter_box_layout_pack() or clutter_box_layout_set_alignment() + a #ClutterActor child of @layout + + + + return location for the horizontal alignment policy + + + + return location for the vertical alignment policy + + + + + + Retrieves the duration set using clutter_box_layout_set_easing_duration() + + the duration of the animations, in milliseconds + + + + + Retrieves the easing mode set using clutter_box_layout_set_easing_mode() + + an easing mode + + + + + Retrieves whether @actor should expand inside @layout + + %TRUE if the #ClutterActor should expand, %FALSE otherwise + + + + + a #ClutterActor child of @layout + + + + + + Retrieves the horizontal and vertical fill policies for @actor +as set using clutter_box_layout_pack() or clutter_box_layout_set_fill() + + + + + + a #ClutterActor child of @layout + + + + return location for the horizontal fill policy + + + + return location for the vertical fill policy + + + + + + Retrieves if the children sizes are allocated homogeneously. +homogeneously, and %FALSE otherwise + + %TRUE if the #ClutterBoxLayout is arranging its children + + + + + Retrieves the value set using clutter_box_layout_set_pack_start() +at the beginning of the layout, and %FALSE otherwise + + %TRUE if the #ClutterBoxLayout should pack children + + + + + Retrieves the spacing set using clutter_box_layout_set_spacing() + + the spacing between children of the #ClutterBoxLayout + + + + + Retrieves whether @layout should animate changes in the layout properties +Since clutter_box_layout_set_use_animations() + + %TRUE if the animations should be used, %FALSE otherwise + + + + + Retrieves the orientation of the @layout as set using the +clutter_box_layout_set_vertical() function +vertically, and %FALSE otherwise + + %TRUE if the #ClutterBoxLayout is arranging its children + + + + + Packs @actor inside the #ClutterContainer associated to @layout +and sets the layout properties + + + + + + a #ClutterActor - + whether the @actor should expand + - + whether the @actor should fill horizontally + - + whether the @actor should fill vertically + + the horizontal alignment policy for @actor + the vertical alignment policy for @actor + Sets the horizontal and vertical alignment policies for @actor +inside @layout + a #ClutterActor child of @layout + Horizontal alignment policy for @actor + Vertical alignment policy for @actor - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the duration of the animations used by @layout when animating changes in the layout properties Use clutter_box_layout_set_use_animations() to enable and disable the -animations" - version="1.2"> +animations - + the duration of the animations, in milliseconds + - + Sets the easing mode to be used by @layout when animating changes in layout +properties +Use clutter_box_layout_set_use_animations() to enable and disable the +animations - + + + + an easing mode, either from #ClutterAnimationMode or a logical id from clutter_alpha_register_func() + + + + + + Sets whether @actor should expand inside @layout + + + + + + a #ClutterActor child of @layout + + + + whether @actor should expand + + + + + + Sets the horizontal and vertical fill policies for @actor +inside @layout + + + + + + a #ClutterActor child of @layout + + + + whether @actor should fill horizontally the allocated space + + + + whether @actor should fill vertically the allocated space + + + + + + Sets whether the size of @layout children should be +homogeneous + + + + + + %TRUE if the layout should be homogeneous + + + + + + Sets whether children of @layout should be layed out by appending +them or by prepending them + + + + + + %TRUE if the @layout should pack children at the beginning of the layout + + + + + + Sets the spacing between children of @layout + + + + + + the spacing between children of the layout, in pixels + + + + + + Sets whether @layout should animate changes in the layout properties +The duration of the animations is controlled by +clutter_box_layout_set_easing_duration(); the easing mode to be used +by the animations is controlled by clutter_box_layout_set_easing_mode() + + + + + + %TRUE if the @layout should use animations + + + + + + Sets whether @layout should arrange its children vertically alongside +the Y axis, instead of horizontally alongside the X axis + + + + + + %TRUE if the layout should be vertical + + + + The duration of the animations, in case #ClutterBoxLayout:use-animations is set to %TRUE -The duration is expressed in milliseconds"> - +The duration is expressed in milliseconds + + The easing mode for the animations, in case #ClutterBoxLayout:use-animations is set to %TRUE either be a value from the #ClutterAnimationMode enumeration, like %CLUTTER_EASE_OUT_CUBIC, or a logical id as returned by clutter_alpha_register_func() -The default value is %CLUTTER_EASE_OUT_CUBIC"> - +The default value is %CLUTTER_EASE_OUT_CUBIC + + + + Whether the #ClutterBoxLayout should arrange its children +homogeneously, i.e. all childs get the same size + - + transfer-ownership="none"> + Whether the #ClutterBoxLayout should pack items at the start +or append them at the end + - + transfer-ownership="none"> + The spacing between children of the #ClutterBoxLayout, in pixels + - + transfer-ownership="none"> + Whether the #ClutterBoxLayout should animate changes in the +layout properties + - + transfer-ownership="none"> + Whether the #ClutterBoxLayout should arrange its children +alongside the Y axis, instead of alongside the X axis + @@ -8953,32 +10961,35 @@ alongside the Y axis, instead of alongside the X axis"> + The #ClutterBoxLayoutClass structure contains only private +data and should be accessed using the provided API - + - + - + - + + + + Button event. The event coordinates are relative to the stage that received the event, and can be transformed into actor-relative coordinates by -using clutter_actor_transform_stage_point()." - version="0.2"> +using clutter_actor_transform_stage_point(). - + @@ -8990,135 +11001,146 @@ using clutter_actor_transform_stage_point()." - + - + - + - + - + - + - + - + + + + - + - + - + - + + The #ClutterCairoTexture struct contains only private data. + + - - + Creates a new #ClutterCairoTexture actor, with a surface of @width by + + the newly created #ClutterCairoTexture actor + - + the width of the surface + - + the height of the surface + - - - + Clears @self's internal drawing surface, so that the next upload +will replace the previous contents of the #ClutterCairoTexture +rather than adding to it. + + - - - - - - - - - - - - - - + Creates a new Cairo context for the @cairo texture. It is similar to using clutter_cairo_texture_create_region() with @x_offset and @y_offset of 0, @width equal to the @cairo texture surface width and @height equal to the @cairo texture surface height. <warning><para>Do not call this function within the paint virtual function or from a callback to the #ClutterActor::paint signal.</para></warning> -to upload the contents of the context when done drawing" - version="1.0"> - +to upload the contents of the context when done drawing + + a newly created Cairo context. Use cairo_destroy() - - - + + Creates a new Cairo context that will updat the region defined +by @x_offset, @y_offset, @width and @height. +<warning><para>Do not call this function within the paint virtual +function or from a callback to the #ClutterActor::paint +signal.</para></warning> +to upload the contents of the context when done drawing + + a newly created Cairo context. Use cairo_destroy() + + + offset of the region on the X axis + + + + offset of the region on the Y axis + + - + width of the region, or -1 for the full surface width + - + height of the region, or -1 for the full surface height + + Retrieves the surface width and height for @self. @@ -9127,39 +11149,51 @@ to upload the contents of the context when done drawing" direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the surface width, or %NULL + - + return location for the surface height, or %NULL + - + Resizes the Cairo surface used by @self to @width and @height. + + + the new width of the surface + + + + the new height of the surface + + + - + transfer-ownership="none"> + The height of the Cairo surface used by the #ClutterCairoTexture +actor, in pixels. + - + transfer-ownership="none"> + The width of the Cairo surface used by the #ClutterCairoTexture +actor, in pixels. + @@ -9171,73 +11205,91 @@ actor, in pixels."> + The #ClutterCairoTextureClass struct contains only private data. - - + + - - + + - - + + - - + + - + - + + + + + + + + Generic callback + a #ClutterActor - + user data + - + - + - + - + - + + Base interface for container specific state for child actors. A child data is meant to be used when you need to keep track of information about each individual child added to a container. In order to use it you should create your own subclass of @@ -9261,42 +11313,40 @@ act like g_object_set() and g_object_get(). You can provide hooks for your own storage as well as control the instantiation by overriding #ClutterContainerIface::create_child_meta, #ClutterContainerIface::destroy_child_meta and -#ClutterContainerIface::get_child_meta." - version="0.8" - parent="GObject.Object" - abstract="1" - glib:type-name="ClutterChildMeta" - glib:get-type="clutter_child_meta_get_type" - glib:type-struct="ChildMetaClass"> - - - - - +#ClutterContainerIface::get_child_meta. - + Retrieves the actor wrapped by @data + + a #ClutterActor + + Retrieves the container using @data + + a #ClutterContainer + + + - + transfer-ownership="none"> + The #ClutterActor being wrapped by this #ClutterChildMeta + - + transfer-ownership="none"> + The #ClutterContainer that created this #ClutterChildMeta. + @@ -9311,66 +11361,220 @@ instantiation by overriding #ClutterContainerIface::create_child_meta, + The #ClutterChildMetaClass contains only private data - + + + + + + The <structname>ClutterClickAction</structname> structure contains +only private data and should be accessed using the provided API + + Creates a new #ClutterClickAction instance + + the newly created #ClutterClickAction + + + + + Retrieves the button that was pressed. + + the button value + + + + + Emulates a release of the pointer button, which ungrabs the pointer +and unsets the #ClutterClickAction:pressed state. +This function is useful to break a grab, for instance after a certain +amount of time has passed. + + + + + + Whether the clickable actor has the pointer grabbed + + + + Whether the clickable actor should be in "pressed" state + + + + + + + + + + The ::clicked signal is emitted when the #ClutterActor to which +a #ClutterClickAction has been applied should respond to a +pointer button press and release events + + + + + + the #ClutterActor attached to the @action + + + + + + + The <structname>ClutterClickActionClass</structname> structure +contains only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The #ClutterClone structure contains only private data +and should be accessed using the provided API + + - - - + + Creates a new #ClutterActor which clones @source/ + + the newly created #ClutterClone + + a #ClutterActor, or %NULL + + Retrieves the source #ClutterActor being cloned by @clone + + the actor source for the clone + + + + Sets @source as the source actor to be cloned by @clone. + a #ClutterActor, or %NULL - - - - - - + transfer-ownership="none"> + This property specifies the source actor being cloned. + @@ -9382,153 +11586,127 @@ and should be accessed using the provided API" + The #ClutterCloneClass structure contains only private data - - + + - - + + - - + + - - + + - + + + + - + - + + glib:get-type="clutter_color_get_type" + c:symbol-prefix="color"> + Color representation. - + - + - + - + - + + Creates a new #ClutterColor with the given values. +Use clutter_color_free() when done + the newly allocated color. - + red component of the color, between 0 and 255 + - + green component of the color, between 0 and 255 + - + blue component of the color, between 0 and 255 + - + alpha component of the color, between 0 and 255 + - + + Adds @a to @b and saves the resulting color inside @result. +The alpha channel of @result is set as as the maximum value +between the alpha channels of @a and @b. + + + + + + a #ClutterColor + + + + return location for the result + + + + + + Makes a copy of the color structure. The result must be +freed using clutter_color_free(). + an allocated copy of @color. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Darkens @color by a fixed amount, and saves the changed color +in @result. @@ -9536,86 +11714,137 @@ in @result."> + transfer-ownership="none"> + return location for the darker color - + + Frees a color structure created with clutter_color_copy(). + + + + + + Converts a color expressed in HLS (hue, luminance and saturation) +values into a #ClutterColor. - - + + hue value, in the 0 .. 360 range + + + + luminance value, in the 0 .. 1 range + + + + saturation value, in the 0 .. 1 range + - + + Converts @pixel from the packed representation of a four 8 bit channel +color to a #ClutterColor. - - - - - + + a 32 bit packed integer containing a color + - - - - - + Parses a string definition of a color, filling the +<structfield>red</structfield>, <structfield>green</structfield>, +<structfield>blue</structfield> and <structfield>alpha</structfield> channels of @color. If alpha is not specified it will be set full opaque. The @color is not allocated. The color may be defined by any of the formats understood by pango_color_from_string(); these include literal color names, like <literal>Red</literal> or <literal>DarkSlateGray</literal>, or hexadecimal specifications like <literal>&num;3050b2</literal> or -<literal>&num;333</literal>." - version="1.0"> +<literal>&num;333</literal>. - + %TRUE if parsing succeeded. + + a string specifiying a color (named color or #RRGGBBAA) - + + Lightens @color by a fixed amount, and saves the changed color +in @result. + + + + + + return location for the lighter color + + + + + + Shades @color by @factor and saves the modified color into @result. + + + + + + the shade factor to apply + + + + return location for the shaded color + + + + + + Subtracts @b from @a and saves the resulting color inside @result. +This function assumes that the components of @a are greater than the +components of @b; the result is, otherwise, undefined. +The alpha channel of @result is set as the minimum value +between the alpha channels of @a and @b. + + + + + + a #ClutterColor + + + + return location for the result + + + + + + Converts @color to the HLS format. +The @hue value is in the 0 .. 360 range. The @luminance and @@ -9624,71 +11853,235 @@ The @hue value is in the 0 .. 360 range. The @luminance and"> direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the hue value or %NULL + - + return location for the luminance value or %NULL + - + return location for the saturation value or %NULL + - + + Converts @color into a packed 32 bit integer, containing +all the four 8 bit channels used by #ClutterColor. - - - - - - - - - - - - - - - - - + a packed color + - - - + + Returns a textual specification of @color in the hexadecimal form +<literal>&num;rrggbbaa</literal>, where <literal>r</literal>, +<literal>g</literal>, <literal>b</literal> and <literal>a</literal> are +hex digits representing the red, green, blue and alpha components +respectively. + + a newly-allocated text string + - - - - - + + <structname>ClutterColorizeEffect</structname> is an opaque structure +whose members cannot be directly accessed +SinceL 1.4 + + Creates a new #ClutterColorizeEffect to be used with +clutter_actor_add_effect() + + the newly created #ClutterColorizeEffect or %NULL + + + + + the color to be used + + + + + + Retrieves the tint used by @effect + + + + + + return location for the color used + + + + + + Sets the tint to be used when colorizing + + + + + + the color to be used + + + + + + The tint to apply to the actor + + + + + + + + The <structname>ClutterConstraint</structname> structure contains only +private data and should be accessed using the provided API + + + + + + + + + + + + + + + + + + + The <structname>ClutterConstraintClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #ClutterContainer is an opaque structure whose members cannot be directly +accessed @@ -9699,52 +12092,101 @@ accessed" - + + Creates the #ClutterChildMeta wrapping @actor inside the +class member is not set to %G_TYPE_INVALID. +This function is only useful when adding a #ClutterActor to +a #ClutterContainer implementation outside of the +#ClutterContainer::add() virtual function implementation. +Applications should not call this function. + a #ClutterActor - + + Destroys the #ClutterChildMeta wrapping @actor inside the +This function is only useful when removing a #ClutterActor to +a #ClutterContainer implementation outside of the +#ClutterContainer::add() virtual function implementation. +Applications should not call this function. - + + a #ClutterActor + + + + + + Calls @callback for each child of @container that was added +by the application (with clutter_container_add_actor()). Does +not iterate over "internal" children that are part of the +container's own implementation, if any. + + + + + + a function to be called for each child - - + + data to be passed to the function, or %NULL + + invoker="foreach_with_internals" + version="1.0"> + Calls @callback for each child of @container, including "internal" +children built in to the container itself that were never added +by the application. - + + a function to be called for each child - - + + data to be passed to the function, or %NULL + - + + Retrieves the #ClutterChildMeta which contains the data about the +of @container or %NULL if the specifiec actor does not exist or the +container is not configured to provide #ClutterChildMeta<!-- -->s - + the #ClutterChildMeta for the @actor child + - - - + a #ClutterActor that is a child of @container. @@ -9762,12 +12204,20 @@ accessed" - + + + + + + + + + - + @@ -9777,38 +12227,29 @@ accessed" - + + Sorts a container's children using their depth. This function should not +be normally used by applications. - - - - - - - - - - - - - - - + Adds a list of #ClutterActor<!-- -->s to @container. Each time and +actor is added, the "actor-added" signal is emitted. Each actor should be parented to @container, which takes a reference on the actor. You -cannot add a #ClutterActor to more than one #ClutterContainer." - version="0.4"> +cannot add a #ClutterActor to more than one #ClutterContainer. + the first #ClutterActor to add @@ -9819,31 +12260,318 @@ cannot add a #ClutterActor to more than one #ClutterContainer." + Adds a #ClutterActor to @container. This function will emit the +"actor-added" signal. The actor should be parented to +#ClutterContainer. + the first #ClutterActor to add + + + + + + Alternative va_list version of clutter_container_add(). + + + + + + the first #ClutterActor to add + + + + list of actors to add, followed by %NULL + + + + + + Gets @container specific properties of an actor. +In general, a copy is made of the property contents and the caller is +responsible for freeing the memory in the appropriate manner for the type, for +instance by calling g_free() or g_object_unref(). + + + + + + a #ClutterActor that is a child of @container. + + + + name of the first property to be set. + + + + + + + + + + Gets a container specific property of a child of @container, In general, +a copy is made of the property contents and the caller is responsible for +freeing the memory by calling g_value_unset(). +Note that clutter_container_child_set_property() is really intended for +language bindings, clutter_container_child_set() is much more convenient +for C programming. + + + + + + a #ClutterActor that is a child of @container. + + + + the name of the property to set. + + + + the value. + + + + + + Sets container specific properties on the child of a container. + + + + + + a #ClutterActor that is a child of @container. + + + + name of the first property to be set. + + + + + + + + + + Sets a container-specific property on a child of @container. + + + + + + a #ClutterActor that is a child of @container. + + + + the name of the property to set. + + + + the value. + + + + + + Creates the #ClutterChildMeta wrapping @actor inside the +class member is not set to %G_TYPE_INVALID. +This function is only useful when adding a #ClutterActor to +a #ClutterContainer implementation outside of the +#ClutterContainer::add() virtual function implementation. +Applications should not call this function. + + + + + + a #ClutterActor + + + + + + Destroys the #ClutterChildMeta wrapping @actor inside the +This function is only useful when removing a #ClutterActor to +a #ClutterContainer implementation outside of the +#ClutterContainer::add() virtual function implementation. +Applications should not call this function. + + + + + + a #ClutterActor + + + + + + Finds a child actor of a container by its name. Search recurses +into any child container. +or %NULL if no actor with that name was found. + + The child actor with the requested name, + + + + + the name of the requested child. + + + + + + Calls @callback for each child of @container that was added +by the application (with clutter_container_add_actor()). Does +not iterate over "internal" children that are part of the +container's own implementation, if any. + + + + + + a function to be called for each child + + + + data to be passed to the function, or %NULL + + + + + + Calls @callback for each child of @container, including "internal" +children built in to the container itself that were never added +by the application. + + + + + + a function to be called for each child + + + + data to be passed to the function, or %NULL + + + + + + Retrieves the #ClutterChildMeta which contains the data about the +of @container or %NULL if the specifiec actor does not exist or the +container is not configured to provide #ClutterChildMeta<!-- -->s + + the #ClutterChildMeta for the @actor child + + + + + a #ClutterActor that is a child of @container. + + + + + + Retrieves all the children of @container. +of #ClutterActor<!-- -->s. Use g_list_free() on the returned +list when done. + + a list + + + + + + + Lowers @actor to @sibling level, in the depth ordering. + + + + + + the actor to raise + + + + the sibling to lower to, or %NULL to lower to the bottom + + + + + + Raises @actor to @sibling level, in the depth ordering. + + + + + + the actor to raise + + + + the sibling to raise to, or %NULL to raise to the top + Removes a %NULL terminated list of #ClutterActor<!-- -->s from around you must hold a reference to it yourself, using g_object_ref(). -Each time an actor is removed, the "actor-removed" signal is -emitted by @container." - version="0.4"> +Each time an actor is removed, the "actor-removed" signal is +emitted by @container. + first #ClutterActor to remove @@ -9854,309 +12582,89 @@ emitted by @container." + Removes @actor from @container. The actor should be unparented, so if you want to keep it around you must hold a reference to it yourself, using g_object_ref(). When the actor has been removed, -the "actor-removed" signal is emitted by @container." - version="0.4"> +the "actor-removed" signal is emitted by @container. + a #ClutterActor - - - - - - - - + + Alternative va_list version of clutter_container_remove(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the first #ClutterActor to add - - - - - - - - - - - - - - - + + list of actors to remove, followed by %NULL + + Sorts a container's children using their depth. This function should not +be normally used by applications. - + + The ::actor-added signal is emitted each time an actor +has been added to @container. - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the new child that has been added to @container + - - - + + The ::actor-removed signal is emitted each time an actor +is removed from @container. + + - - + + the child that has been removed from @container + - + The ::child-notify signal is emitted each time a property is being set through the clutter_container_child_set() and -clutter_container_child_set_property() calls." - version="0.8"> - - +clutter_container_child_set_property() calls. + + - - + + the child that has had a property set. + - - + + @@ -10164,15 +12672,15 @@ clutter_container_child_set_property() calls." + Base interface for container actors. The @add, @remove and @foreach +virtual functions must be provided by any implementation; the other +virtual functions are optional. - + @@ -10187,7 +12695,7 @@ virtual functions are optional." - + @@ -10202,7 +12710,7 @@ virtual functions are optional." - + @@ -10210,18 +12718,22 @@ virtual functions are optional." - + + a function to be called for each child - + data to be passed to the function, or %NULL + - + @@ -10229,17 +12741,22 @@ virtual functions are optional." - + + a function to be called for each child - + data to be passed to the function, or %NULL + - + @@ -10257,7 +12774,7 @@ virtual functions are optional." - + @@ -10275,7 +12792,7 @@ virtual functions are optional." - + @@ -10290,7 +12807,7 @@ virtual functions are optional." - + @@ -10299,13 +12816,14 @@ virtual functions are optional." + a #ClutterActor - + @@ -10314,14 +12832,16 @@ virtual functions are optional." + a #ClutterActor - - + + + the #ClutterChildMeta for the @actor child @@ -10329,13 +12849,14 @@ virtual functions are optional." + a #ClutterActor that is a child of @container. - + @@ -10350,7 +12871,7 @@ virtual functions are optional." - + @@ -10365,7 +12886,7 @@ virtual functions are optional." - + @@ -10383,21 +12904,25 @@ virtual functions are optional." + + + - + - + - + + + + + Event for the movement of the pointer across different actors - + @@ -10409,10 +12934,10 @@ virtual functions are optional." - + - + @@ -10422,377 +12947,648 @@ virtual functions are optional." - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + - + - + + + The <structname>ClutterDeformEffect</structname> structure contains +only private data and should be accessed using the provided API + + + + + + + + + + + + + + + + + + Retrieves the handle to the back face material used by @effect +The returned material is owned by the #ClutterDeformEffect and it +should not be freed directly + + a handle for the material, or %NULL. + + + + + Retrieves the number of horizontal and vertical tiles used to sub-divide +the actor's geometry during the effect + + + + + + return location for the number of horizontal tiles, or %NULL + + + + return location for the number of vertical tiles, or %NULL + + + + + + Invalidates the @effect<!-- -->'s vertices and, if it is associated +to an actor, it will queue a redraw + + + + + + Sets the material that should be used when drawing the back face +of the actor during a deformation +The #ClutterDeformEffect will take a reference on the material's +handle + + + + + + a handle to a Cogl material + + + + + + Sets the number of horizontal and vertical tiles to be used +when applying the effect +More tiles allow a finer grained deformation at the expenses +of computation + + + + + + number of horizontal tiles + + + + number of vertical tiles + + + + + + A material to be used when painting the back of the actor +to which this effect has been applied +By default, no material will be used + + + + The number of horizontal tiles. The bigger the number, the +smaller the tiles + + + + The number of vertical tiles. The bigger the number, the +smaller the tiles + + + + + + + + + + + The <structname>ClutterDeformEffectClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + <structname>ClutterDesaturateEffect</structname> is an opaque structure +whose members cannot be directly accessed + + Creates a new #ClutterDesaturateEffect to be used with +clutter_actor_add_effect() + + the newly created #ClutterDesaturateEffect or %NULL + + + + + the desaturation factor, between 0.0 and 1.0 + + + + + + Retrieves the desaturation factor of @effect + + the desaturation factor + + + + + Sets the desaturation factor for @effect, with 0.0 being "do not desaturate" +and 1.0 being "fully desaturate" + + + + + + the desaturation factor, between 0.0 and 1.0 + + + + + + The desaturation factor, between 0.0 (no desaturation) and 1.0 (full +desaturation). + + + + The #ClutterDeviceManager structure contains only private data - + Retrieves the device manager singleton +The returned instance is owned by Clutter and it should not be +modified or freed + + the #ClutterDeviceManager singleton. - - - - - - - - - - - - - - - - - - - - - - - - - @@ -10803,6 +13599,45 @@ modified or freed" + + Retrieves the core #ClutterInputDevice of type @device_type +Core devices are devices created automatically by the default +Clutter backend +returned device is owned by the #ClutterDeviceManager and should +not be modified or freed + + a #ClutterInputDevice or %NULL. The + + + + + + + + + + Retrieves the #ClutterInputDevice with the given @device_id +returned device is owned by the #ClutterDeviceManager and should +never be modified or freed + + a #ClutterInputDevice or %NULL. The + + + + + + + + + + + + + + + @@ -10813,12 +13648,48 @@ modified or freed" + + Retrieves the core #ClutterInputDevice of type @device_type +Core devices are devices created automatically by the default +Clutter backend +returned device is owned by the #ClutterDeviceManager and should +not be modified or freed + + a #ClutterInputDevice or %NULL. The + + + + + the type of the core device + + + + + + Retrieves the #ClutterInputDevice with the given @device_id +returned device is owned by the #ClutterDeviceManager and should +never be modified or freed + + a #ClutterInputDevice or %NULL. The + + + + + the integer id of a device + + + + + Lists all currently registered input devices +a newly allocated list of #ClutterInputDevice objects. Use +g_slist_free() to deallocate it when done @@ -10827,53 +13698,22 @@ g_slist_free() to deallocate it when done" + Lists all currently registered input devices a pointer to the internal list of #ClutterInputDevice objects. The returned list is owned by the #ClutterDeviceManager and should never -be modified or freed" - version="1.2"> +be modified or freed - - - - - - - - - - - - - - - - - - - - - - + + @@ -10882,29 +13722,29 @@ not be modified or freed" - - - + + The ::device-added signal is emitted each time a device has been +added to the #ClutterDeviceManager + + - - + + the newly added #ClutterInputDevice + - - - + + The ::device-removed signal is emitted each time a device has been +removed from the #ClutterDeviceManager + + - - + + the removed #ClutterInputDevice + @@ -10912,15 +13752,17 @@ removed from the #ClutterDeviceManager" + The #ClutterDeviceManagerClass structure contains only private data - + - + + + @@ -10930,8 +13772,9 @@ removed from the #ClutterDeviceManager" - - + + + a #ClutterInputDevice or %NULL. The @@ -10945,8 +13788,9 @@ removed from the #ClutterDeviceManager" - - + + + a #ClutterInputDevice or %NULL. The @@ -10954,13 +13798,13 @@ removed from the #ClutterDeviceManager" - + - + @@ -10975,7 +13819,7 @@ removed from the #ClutterDeviceManager" - + @@ -10991,103 +13835,633 @@ removed from the #ClutterDeviceManager" - + - + + + + + + + - + - + + + The <structname>ClutterDragAction</structname> structure contains only +private data and should be accessed using the provided API + + Creates a new #ClutterDragAction instance + + the newly created #ClutterDragAction + + + + + Retrieves the axis constraint set by clutter_drag_action_set_drag_axis() + + the axis constraint + + + + + Retrieves the drag handle set by clutter_drag_action_set_drag_handle() +handle, or %NULL if none was set + + a #ClutterActor, used as the drag + + + + + Retrieves the values set by clutter_drag_action_set_drag_threshold() + + + + + + return location for the horizontal drag threshold value, in pixels + + + + return location for the vertical drag threshold value, in pixels + + + + + + Retrieves the coordinates, in stage space, of the latest motion +event during the dragging + + + + + + return location for the latest motion event's X coordinate + + + + return location for the latest motion event's Y coordinate + + + + + + Retrieves the coordinates, in stage space, of the press event +that started the dragging + + + + + + return location for the press event's X coordinate + + + + return location for the press event's Y coordinate + + + + + + Restricts the dragging action to a specific axis + + + + + + the axis to constraint the dragging to + + + + + + Sets the actor to be used as the drag handle + + + + + + a #ClutterActor + + + + + + Sets the horizontal and vertical drag thresholds that must be +cleared by the pointer before @action can begin the dragging + + + + + + a distance on the horizontal axis, in pixels + + + + a distance on the vertical axis, in pixels + + + + + + Constraints the dragging action to the specified axis + + + + The #ClutterActor that is effectively being dragged +A #ClutterDragAction will, be default, use the #ClutterActor that +has been attached to the action; it is possible to create a +separate #ClutterActor and use it instead. +Setting this property has no effect on the #ClutterActor argument +passed to the #ClutterDragAction signals + + + + The horizontal threshold, in pixels, that begins a drag action +When set to a non-zero value, #ClutterDragAction will only emit +#ClutterDragAction::drag-begin if the pointer has moved +horizontally at least of the given amount of pixels since +the button press event + + + + The vertical threshold, in pixels, that begins a drag action +When set to a non-zero value, #ClutterDragAction will only emit +#ClutterDragAction::drag-begin if the pointer has moved +vertically at least of the given amount of pixels since +the button press event + + + + + + + + + + The ::drag-begin signal is emitted when the #ClutterDragAction +starts the dragging +The emission of this signal can be delayed by using the +#ClutterDragAction:x-drag-threshold and +#ClutterDragAction:y-drag-threshold properties + + + + + + the #ClutterActor attached to the action + + + + the X coordinate (in stage space) of the press event + + + + the Y coordinate (in stage space) of the press event + + + + the modifiers of the press event + + + + + + The ::drag-end signal is emitted at the end of the dragging, +when the pointer button's is released +This signal is emitted if and only if the #ClutterDragAction::drag-begin +signal has been emitted first + + + + + + the #ClutterActor attached to the action + + + + the X coordinate (in stage space) of the release event + + + + the Y coordinate (in stage space) of the release event + + + + the modifiers of the release event + + + + + + + + + + + + + + + + + + + + + + + The <structname>ClutterDragActionClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The axis of the constraint that should be applied on the +dragging action + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + The #ClutterEffect structure contains only private data and should +be accessed using the provided API + + + + + + + + + + + + + + + + The #ClutterEffectClass structure contains only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + + + + - + - + - + - + - + - + - + + glib:get-type="clutter_event_get_type" + c:symbol-prefix="event"> + Generic event wrapper. @@ -11112,124 +14486,54 @@ removed from the #ClutterDeviceManager" - + + Creates a new #ClutterEvent of the specified type. + A newly allocated #ClutterEvent. + The type of event. - - - - - - + + Copies @event. + A newly allocated #ClutterEvent - + + Frees all resources used by @event. - - - - - - - - - - - + Retrieves the button number of @event - + the button number + - - - - - - + + Retrieves the number of clicks of @event - - - - - - - - - - - - - - - - - - - - - + the click count + + Retrieves the coordinates of @event and puts them into @x and @y. @@ -11238,79 +14542,164 @@ NULL if the event has no source." direction="out" caller-allocates="0" transfer-ownership="full"> - + return location for the X coordinate, or %NULL + - + return location for the Y coordinate, or %NULL + - + Retrieves the #ClutterInputDevice for the event. +The #ClutterInputDevice structure is completely opaque and should +be cast to the platform-specific implementation. +returned device is owned by the #ClutterEvent and it should not +be unreferenced - + the #ClutterInputDevice or %NULL. The + + + + + Retrieves the events device id if set. +no specific device set. + + A unique identifier for the device or -1 if the event has + + + + + Retrieves the type of the device for @event +any is set + + the #ClutterInputDeviceType for the device, if + + + + + Retrieves the #ClutterEventFlags of @event + + the event flags + + Retrieves the keycode of the key that caused @event - + The keycode representing the key + + + + + Retrieves the key symbol of @event + + the key symbol representing the key + + c:identifier="clutter_event_get_key_unicode"> + Retrieves the unicode value for the key that caused @keyev. - - - - - - - - - - - + The unicode value representing the key + - + Retrieves the related actor of a crossing event. + + the related #ClutterActor, or %NULL - + Retrieves the direction of the scrolling of @event + + the scrolling direction + + Retrieves the source #ClutterActor the event originated from, or +NULL if the event has no source. + + a #ClutterActor + + + + + Retrieves the source #ClutterStage the event originated for, or +%NULL if the event has no stage. + + a #ClutterStage + + + + + Retrieves the modifier state of the event. + + the modifier state parameter, or 0 + + + + + Retrieves the time of the event. + + the time of the event, or %CLUTTER_CURRENT_TIME + + + + + Puts a copy of the event on the back of the event queue. The event will +have the %CLUTTER_EVENT_FLAG_SYNTHETIC flag set. If the source is set +event signals will be emitted for this source and capture/bubbling for +its ancestors. If the source is not set it will be generated by picking +or use the actor that currently has keyboard focus + + + + + + Retrieves the type of the event. + + a #ClutterEventType + + + + Flags for the #ClutterEvent + Types of events. + + + - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + Runtime flags indicating specific features available via Clutter window +sysytem and graphics backend. + + + - + - + + The #ClutterFixedLayout structure contains only private data and +it should be accessed using the provided API - - + Creates a new #ClutterFixedLayout + + the newly created #ClutterFixedLayout + @@ -11614,144 +15017,52 @@ it should be accessed using the provided API" + The #ClutterFixedLayoutClass structure contains only private data +and it should be accessed using the provided API + The #ClutterFlowLayout structure contains only private data +and should be accessed using the provided API - - + Creates a new #ClutterFlowLayout with the given @orientation + + the newly created #ClutterFlowLayout + + the orientation of the flow layout - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves the spacing between columns +in pixels - + the spacing between columns of the #ClutterFlowLayout, + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves the minimum and maximum column widths @@ -11759,39 +15070,41 @@ in pixels" - + transfer-ownership="full"> + return location for the minimum column width, or %NULL + - + transfer-ownership="full"> + return location for the maximum column width, or %NULL + - + Retrieves whether the @layout is homogeneous - + %TRUE if the #ClutterFlowLayout is homogeneous + + + + + Retrieves the orientation of the @layout + + the orientation of the #ClutterFlowLayout + - - - - - - - - + Retrieves the minimum and maximum row heights @@ -11799,76 +15112,189 @@ in pixels" - + transfer-ownership="full"> + return location for the minimum row height, or %NULL + - + transfer-ownership="full"> + return location for the maximum row height, or %NULL + + + + + + Retrieves the spacing between rows +in pixels + + the spacing between rows of the #ClutterFlowLayout, + + + + + Sets the space between columns, in pixels + + + + + + the space between columns + + + + + + Sets the minimum and maximum widths that a column can have + + + + + + minimum width of a column + + + + maximum width of a column + + + + + + Sets whether the @layout should allocate the same space for +each child + + + + + + whether the layout should be homogeneous or not + + + + + + Sets the orientation of the flow layout +The orientation controls the direction used to allocate +orientation also controls the direction of the overflowing + + + + + + the orientation of the layout + + + + + + Sets the minimum and maximum heights that a row can have + + + + + + the minimum height of a row + + + + the maximum height of a row + + + + + + Sets the spacing between rows, in pixels + + + + + + the space between rows + + The spacing between columns, in pixels; the value of this property is honoured by horizontal non-overflowing layouts -and by vertical overflowing layouts"> - +and by vertical overflowing layouts + - + transfer-ownership="none"> + Whether each child inside the #ClutterFlowLayout should receive +the same allocation + - + transfer-ownership="none"> + Maximum width for each column in the layout, in pixels. If +set to -1 the width will be the maximum child width + - + transfer-ownership="none"> + Maximum height for each row in the layout, in pixels. If +set to -1 the width will be the maximum child height + - + transfer-ownership="none"> + Minimum width for each column in the layout, in pixels + - + transfer-ownership="none"> + Minimum height for each row in the layout, in pixels + + The orientation of the #ClutterFlowLayout. The children of the layout will be layed out following the orientation. -This property also controls the overflowing directions"> - +This property also controls the overflowing directions + + The spacing between rows, in pixels; the value of this property is honoured by vertical non-overflowing layouts and -by horizontal overflowing layouts"> - +by horizontal overflowing layouts + @@ -11880,22 +15306,24 @@ by horizontal overflowing layouts"> + The #ClutterFlowLayoutClass structure contains only private data +and should be accessed using the provided API - + + The direction of the arrangement of the children inside +a #ClutterFlowLayout + glib:get-type="clutter_fog_get_type" + c:symbol-prefix="fog"> + Fog settings used to create the depth cueing effect. - + - + + Runtime flags to change the font quality. To be used with +clutter_set_font_flags(). + + + + + + + + + - + - + + + + - + - + - + - + + glib:get-type="clutter_geometry_get_type" + c:symbol-prefix="geometry"> + The rectangle containing an actor's bounding box, measured in pixels. - + - + - + - + + + Determines if @geometry0 and geometry1 intersect returning %TRUE if +they do else %FALSE. +%FALSE. + + %TRUE of @geometry0 and geometry1 intersect else + + + + + The second geometry to test + + + + + + Find the union of two rectangles represented as #ClutterGeometry. + + + + + + another #ClutterGeometry + + + + location to store the result + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + Gravity of the scaling operations. When a gravity different than +%CLUTTER_GRAVITY_NONE is used, an actor is scaled keeping the position +of the specified portion at the same coordinates. - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + The #ClutterGroup structure contains only private data +and should be accessed using the provided API + + - - - + + Create a new #ClutterGroup. + + the newly created #ClutterGroup actor + + + Gets the number of actors held in the group. + + The number of child actors held in the group. + + + - + Gets a groups child held at @index_ in stack. + + A Clutter actor, or %NULL if - + the position of the requested actor. + - - - - - - + + Removes all children actors from the #ClutterGroup. @@ -12418,570 +15906,582 @@ and should be accessed using the provided API" + The #ClutterGroupClass structure contains only private data - - + + - - + + - - + + - - + + - - + + - - + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + - + - + + + + - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Error conditions returned by clutter_init() and clutter_init_with_args(). - - - - - - - - - - + Generic representation of an input device. The actual contents of this +structure depend on the backend used. + Retrieves the latest coordinates of the pointer of @device @@ -13038,50 +16523,70 @@ structure depend on the backend used." - + transfer-ownership="full"> + return location for the X coordinate + - + transfer-ownership="full"> + return location for the Y coordinate + + + Retrieves the unique identifier of @device + + the identifier of the device + + + + + Retrieves the name of the @device +is owned by the #ClutterInputDevice and should never be modified +or freed + + the name of the device, or %NULL. The returned string + + + + + Retrieves the type of @device + + the type of the device + + + - + Retrieves the #ClutterActor underneath the pointer of @device + + a pointer to the #ClutterActor or %NULL - - - - - + Retrieves the #ClutterStage underneath the pointer of @device - + a pointer to the #ClutterStage or %NULL + + Forcibly updates the state of the @device using a #ClutterEvent for integration with embedding toolkits, like clutter-gtk Embedding toolkits that disable the event collection inside Clutter need to use this function to update the state of input devices depending @@ -13118,19 +16623,18 @@ clutter_do_event (&amp;c_event); ]| The @update_stage boolean argument should be used when the input device enters and leaves a #ClutterStage; it will use the #ClutterStage field -of the passed @event to update the stage associated to the input device." - version="1.2"> +of the passed @event to update the stage associated to the input device. + a #ClutterEvent - - + + whether to update the #ClutterStage of the @device using the stage of the event + @@ -13138,42 +16642,45 @@ of the passed @event to update the stage associated to the input device." version="1.2" writable="1" construct-only="1" - doc="The type of the device"> - + transfer-ownership="none"> + The type of the device + - + transfer-ownership="none"> + The unique identifier of the device + - + transfer-ownership="none"> + The name of the device + + The #ClutterInputDeviceClass structure contains only private +data and should not be accessed directly + The types of input devices available. +The #ClutterInputDeviceType enumeration can be extended at later +date; not every platform supports every input device type. - + + The mode of interpolation between key frames + The #ClutterInterval structure contains only private data and should +be accessed using the provided functions. + Creates a new #ClutterInterval holding values of type @gtype. This function avoids using a #GValue for the initial and final values of the interval: |[ interval = clutter_interval_new (G_TYPE_FLOAT, 0.0, 1.0); interval = clutter_interval_new (G_TYPE_BOOLEAN, FALSE, TRUE); interval = clutter_interval_new (G_TYPE_INT, 0, 360); -]|" - version="1.0"> - +]| + + the newly created #ClutterInterval + the type of the values in the interval @@ -13244,28 +16755,34 @@ interval = clutter_interval_new (G_TYPE_INT, 0, 360); - + Creates a new #ClutterInterval of type @gtype, between @initial +and @final. +This function is useful for language bindings. + + the newly created #ClutterInterval + the type of the values in the interval + a #GValue holding the initial value of the interval + a #GValue holding the final value of the interval + Sets the progress function for a given @value_type, like: |[ clutter_interval_register_progress_func (MY_TYPE_FOO, my_foo_progress); @@ -13290,157 +16807,163 @@ return TRUE; clutter_interval_register_progress_func (G_TYPE_INT, my_int_progress); ]| To unset a previously set progress function of a #GType, pass %NULL -for @func." - version="1.0"> +for @func. + a #GType - + + a #ClutterProgressFunc, or %NULL to unset a previously set progress function - + + Computes the value between the @interval boundaries given the +progress @factor and copies it into @value. - + %TRUE if the operation was successful + + + + + the progress factor, between 0 and 1 + + + + return location for an initialized #GValue + + + + + + Validates the initial and final values of @interval against +a #GParamSpec. + + %TRUE if the #ClutterInterval is valid, %FALSE otherwise + + a #GParamSpec - - - - - - - - - - - - - - + + Creates a copy of @interval. + the newly created #ClutterInterval - + + Computes the value between the @interval boundaries given the +progress @factor +Unlike clutter_interval_compute_value(), this function will +return a const pointer to the computed value +You should use this function if you immediately pass the computed +value to another function that makes a copy of it, like +g_object_set_property() +or %NULL if the computation was not successfull - - - - - - - - - - - - - - - - - - - - - - - - - + a pointer to the computed value, + + + the progress factor, between 0 and 1 + + + - + Computes the value between the @interval boundaries given the +progress @factor and copies it into @value. - + %TRUE if the operation was successful + - + + the progress factor, between 0 and 1 + + + + return location for an initialized #GValue + Retrieves the final value of @interval and copies it into @value. The passed #GValue must be initialized to the value held by -the #ClutterInterval." - version="1.0"> +the #ClutterInterval. - + + a #GValue - - - + Retrieves the initial value of @interval and copies +it into @value. +The passed #GValue must be initialized to the value held by +the #ClutterInterval. + + + + + a #GValue + + + - + Variable arguments wrapper for clutter_interval_get_initial_value() +and clutter_interval_get_final_value() that avoids using the #GValue arguments: |[ -clutter_interval_set_interval (interval, 0, 50); -clutter_interval_set_interval (interval, 1.0, 0.0); -clutter_interval_set_interval (interval, FALSE, TRUE); +gint a = 0, b = 0; +clutter_interval_get_interval (interval, &a, &b); ]| This function is meant for the convenience of the C API; bindings -should reimplement this function using the #GValue-based API." - version="1.0"> +should reimplement this function using the #GValue-based API. @@ -13451,18 +16974,81 @@ should reimplement this function using the #GValue-based API." - + Retrieves the #GType of the values inside @interval. + + the type of the value, or G_TYPE_INVALID + + + + + Gets the pointer to the final value of @interval +The value is owned by the #ClutterInterval and it should not be +modified or freed + + the final value of the interval. + + + + + Gets the pointer to the initial value of @interval +The value is owned by the #ClutterInterval and it should not be +modified or freed + + the initial value of the interval. + + + + + Sets the final value of @interval to @value. The value is +copied inside the #ClutterInterval. + + + + + + a #GValue + + + + + + Sets the initial value of @interval to @value. The value is copied +inside the #ClutterInterval. + + + + + + a #GValue + + + + + + Variable arguments wrapper for clutter_interval_set_initial_value() +and clutter_interval_set_final_value() that avoids using the #GValue arguments: |[ -gint a = 0, b = 0; -clutter_interval_get_interval (interval, &a, &b); +clutter_interval_set_interval (interval, 0, 50); +clutter_interval_set_interval (interval, 1.0, 0.0); +clutter_interval_set_interval (interval, FALSE, TRUE); ]| This function is meant for the convenience of the C API; bindings -should reimplement this function using the #GValue-based API." - version="1.0"> +should reimplement this function using the #GValue-based API. @@ -13475,41 +17061,27 @@ should reimplement this function using the #GValue-based API." + Validates the initial and final values of @interval against +a #GParamSpec. - + %TRUE if the #ClutterInterval is valid, %FALSE otherwise + + a #GParamSpec - - - - - - - - - - - - - - + transfer-ownership="none"> + The type of the values in the interval. + @@ -13521,243 +17093,6785 @@ progress @factor and puts it into @value." + The #ClutterIntervalClass contains only private data. - + - + %TRUE if the #ClutterInterval is valid, %FALSE otherwise + + a #GParamSpec - + - + %TRUE if the operation was successful + - + the progress factor, between 0 and 1 + - + + return location for an initialized #GValue - - + + - - + + - - + + - - + + - - + + - - + + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + - + - + + Key event - + @@ -13772,13 +23886,13 @@ progress @factor and puts it into @value." - + - + - - + + @@ -13786,412 +23900,369 @@ progress @factor and puts it into @value." + glib:get-type="clutter_knot_get_type" + c:symbol-prefix="knot"> + Point in a path behaviour. - + - + - + + Makes an allocated copy of a knot. + the copied knot. - + + Compares to knot and checks if the point to the same location. - - - - - - + %TRUE if the knots point to the same location. + + Second knot + + Frees the memory of an allocated knot. + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The #ClutterLayoutManager structure contains only private data +and should be accessed using the provided API + + Allocates the children of @container given an area +See also clutter_actor_allocate() + the #ClutterContainer using @manager + the #ClutterActorBox containing the allocated area of @container + the allocation flags - + + Begins an animation of @duration milliseconds, using the provided +easing @mode +The easing mode can be specified either as a #ClutterAnimationMode +or as a logical id returned by clutter_alpha_register_func() +The result of this function depends on the @manager implementation +layout manager; the returned instance is owned by the layout +manager and should not be unreferenced - + The #ClutterAlpha created by the + + + + + the duration of the animation, in milliseconds + + + + the easing mode of the animation + + + + + + + + + + + + Ends an animation started by clutter_layout_manager_begin_animation() +The result of this call depends on the @manager implementation + + + + + + Retrieves the progress of the animation, if one has been started by +clutter_layout_manager_begin_animation() +The returned value has the same semantics of the #ClutterAlpha:alpha +value + + the progress of the animation + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Computes the minimum and natural heights of the @container according to @manager. -See also clutter_actor_get_preferred_width()" - version="1.2"> - - - - - - - - - - - - - - - - - - - +See also clutter_actor_get_preferred_height() + the #ClutterContainer using @manager - + the width for which the height should be computed, or -1 + - - + + - - + + - - + + + Computes the minimum and natural widths of the @container according +to @manager. +See also clutter_actor_get_preferred_width() + the #ClutterContainer using @manager - + + the height for which the width should be computed, or -1 + + + + + + + + + + + + If the #ClutterLayoutManager sub-class allows it, allow +adding a weak reference of the @container using @manager +from within the layout manager +The layout manager should not increase the reference +count of the @container + + + + + + a #ClutterContainer using @manager + + + + + + Allocates the children of @container given an area +See also clutter_actor_allocate() + + + + + + the #ClutterContainer using @manager + + + + the #ClutterActorBox containing the allocated area of @container + the allocation flags - + Begins an animation of @duration milliseconds, using the provided +easing @mode +The easing mode can be specified either as a #ClutterAnimationMode +or as a logical id returned by clutter_alpha_register_func() +The result of this function depends on the @manager implementation +layout manager; the returned instance is owned by the layout +manager and should not be unreferenced - + The #ClutterAlpha created by the + - - + + the duration of the animation, in milliseconds + + + + the easing mode of the animation + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Retrieves the values for a list of properties out of the +#ClutterLayoutMeta created by @manager and attached to the +child of a @container + a #ClutterContainer using @manager + a #ClutterActor child of @container + the name of the first property @@ -14200,23 +24271,58 @@ instead" - + Gets a property on the #ClutterLayoutMeta created by @manager and +attached to a child of @container +The #GValue must already be initialized to the type of the property +and has to be unset with g_value_unset() after extracting the real +value out of it + a #ClutterContainer using @manager + a #ClutterActor child of @container + + + + the name of the property to get + + + + a #GValue with the value of the property to get + + + + + + Sets a list of properties and their values on the #ClutterLayoutMeta +associated by @manager to a child of @container +Languages bindings should use clutter_layout_manager_child_set_property() +instead + + + + + + a #ClutterContainer using @manager + + + + a #ClutterActor child of @container + the first property name @@ -14227,104 +24333,226 @@ child of a @container" + Sets a property on the #ClutterLayoutMeta created by @manager and +attached to a child of @container + a #ClutterContainer using @manager + a #ClutterActor child of @container + the name of the property to set + a #GValue with the value of the property to set - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Ends an animation started by clutter_layout_manager_begin_animation() +The result of this call depends on the @manager implementation + + Retrieves the #GParamSpec for the layout property @name inside +the #ClutterLayoutMeta sub-class used by @manager +or %NULL if no property with that name exists. The returned +#GParamSpec is owned by the layout manager and should not be +modified or freed + + a #GParamSpec describing the property, + + + + + the name of the property + + + + + Retrieves the progress of the animation, if one has been started by clutter_layout_manager_begin_animation() The returned value has the same semantics of the #ClutterAlpha:alpha -value" - version="1.2"> +value - + the progress of the animation + + + Retrieves the #ClutterLayoutMeta that the layout @manager associated +to the @actor child of @container, eventually by creating one if the +#ClutterLayoutManager supports layout properties +#ClutterLayoutManager does not have layout properties. The returned +layout meta instance is owned by the #ClutterLayoutManager and it +should not be unreferenced + + a #ClutterLayoutMeta, or %NULL if the + + + + + a #ClutterContainer using @manager + + + + a #ClutterActor child of @container + + + + + + Computes the minimum and natural heights of the @container according +to @manager. +See also clutter_actor_get_preferred_height() + + + + + + the #ClutterContainer using @manager + + + + the width for which the height should be computed, or -1 + + + + return location for the minimum height of the layout, or %NULL + + + + return location for the natural height of the layout, or %NULL + + + + + + Computes the minimum and natural widths of the @container according +to @manager. +See also clutter_actor_get_preferred_width() + + + + + + the #ClutterContainer using @manager + + + + the height for which the width should be computed, or -1 + + + + return location for the minimum width of the layout, or %NULL + + + + return location for the natural width of the layout, or %NULL + + + + + + Emits the #ClutterLayoutManager::layout-changed signal on @manager +This function should only be called by implementations of the +#ClutterLayoutManager class + + + + + + Retrieves all the #GParamSpec<!-- -->s for the layout properties +stored inside the #ClutterLayoutMeta sub-class used by @manager +%NULL-terminated array of #GParamSpec<!-- -->s. Use g_free() to free the +resources allocated for the array + + the newly-allocated, + + + + + + + return location for the number of returned #GParamSpec<!-- -->s + + + + + + If the #ClutterLayoutManager sub-class allows it, allow +adding a weak reference of the @container using @manager +from within the layout manager +The layout manager should not increase the reference +count of the @container + + + + + + a #ClutterContainer using @manager + + + + - + - + The ::layout-changed signal is emitted each time a layout manager has been changed. Every #ClutterActor using the @manager instance as a layout manager should connect a handler to the ::layout-changed signal and queue a relayout on themselves: @@ -14336,32 +24564,31 @@ clutter_actor_queue_relayout (self); } ... self->manager = g_object_ref_sink (manager); -g_signal_connect (self->manager, "layout-changed", +g_signal_connect (self->manager, "layout-changed", G_CALLBACK (layout_changed), self); ]| Sub-classes of #ClutterLayoutManager that implement a layout that can be controlled or changed using parameters should emit the ::layout-changed signal whenever one of the parameters changes, -by using clutter_layout_manager_layout_changed()." - version="1.2"> - - +by using clutter_layout_manager_layout_changed(). + + + The #ClutterLayoutManagerClass structure contains only private +data and should be accessed using the provided API - + @@ -14370,28 +24597,24 @@ data and should be accessed using the provided API" + the #ClutterContainer using @manager - + the height for which the width should be computed, or -1 + - - + + - - + + - + @@ -14400,28 +24623,24 @@ data and should be accessed using the provided API" + the #ClutterContainer using @manager - + the width for which the height should be computed, or -1 + - - + + - - + + - + @@ -14430,19 +24649,22 @@ data and should be accessed using the provided API" + the #ClutterContainer using @manager + the #ClutterActorBox containing the allocated area of @container + the allocation flags - + @@ -14450,14 +24672,17 @@ data and should be accessed using the provided API" - + + a #ClutterContainer using @manager - + @@ -14468,9 +24693,9 @@ data and should be accessed using the provided API" - - - + + + @@ -14487,8 +24712,9 @@ data and should be accessed using the provided API" - - + + + The #ClutterAlpha created by the @@ -14496,19 +24722,21 @@ data and should be accessed using the provided API" - + the duration of the animation, in milliseconds + - + the easing mode of the animation + - + - + the progress of the animation + @@ -14518,7 +24746,7 @@ data and should be accessed using the provided API" - + @@ -14530,7 +24758,7 @@ data and should be accessed using the provided API" - + @@ -14541,57 +24769,57 @@ data and should be accessed using the provided API" - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -14599,6 +24827,7 @@ data and should be accessed using the provided API" - + Retrieves the actor wrapped by @data + + a #ClutterLayoutManager @@ -14617,8 +24847,9 @@ data and should be accessed using the provided API" version="1.2" writable="1" construct-only="1" - doc="The #ClutterLayoutManager that created this #ClutterLayoutMeta."> - + transfer-ownership="none"> + The #ClutterLayoutManager that created this #ClutterLayoutMeta. + @@ -14627,44 +24858,44 @@ data and should be accessed using the provided API" - + - + + The #ClutterLayoutMetaClass contains only private data and +should never be accessed directly - - + + - - + + - - + + - - + + @@ -14672,55 +24903,62 @@ should never be accessed directly" - + - + - + - + + + + - + - + + The #ClutterListModel struct contains only private data. + Creates a new default model with @n_columns columns with the types and names passed in. For example: <informalexample><programlisting> model = clutter_list_model_new (3, -G_TYPE_INT, "Score", -G_TYPE_STRING, "Team", -GDK_TYPE_PIXBUF, "Logo"); +G_TYPE_INT, "Score", +G_TYPE_STRING, "Team", +GDK_TYPE_PIXBUF, "Logo"); </programlisting></informalexample> will create a new #ClutterModel with three columns of type int, string and #GdkPixbuf respectively. Note that the name of the column can be set to %NULL, in which case the canonical name of the type held by the column will be used as -the title." - version="0.6"> +the title. - + a new #ClutterListModel + - + number of columns in the model + @@ -14728,29 +24966,30 @@ the title." - + + Non-vararg version of clutter_list_model_new(). This function is +useful for language bindings. - + a new default #ClutterModel + - + number of columns in the model + - + + an array of #GType types for the columns, from first to last + an array of names for the columns, from first to last - + @@ -14761,309 +25000,342 @@ useful for language bindings." + The #ClutterListModelClass struct contains only private data. - + + + + - + - + - + - - + + - - + + - + - + - + - + - + - + - + - + + + + + + + + + + - + - #ClutterMedia is an opaque structure whose members cannot be directly +accessed + + Retrieves the playback volume of @media. + + The playback volume between 0.0 and 1.0 + + + + + Retrieves the amount of the stream that is buffered. + + the fill level, between 0.0 and 1.0 + + + + + Retrieves whether @media is seekable or not. + + %TRUE if @media can seek, %FALSE otherwise. + + + + + Retrieves the duration of the media stream that @media represents. + + the duration of the media stream, in seconds + + + + + Retrieves the playing status of @media. + + %TRUE if playing, %FALSE if stopped. + + + + + Retrieves the playback progress of @media. + + the playback progress, between 0.0 and 1.0 + + + + + Retrieves the font name currently used. +to free the returned string + + a string containing the font name. Use g_free() + + + + + Retrieves the URI of the subtitle file in use. +to free the returned string + + the URI of the subtitle file. Use g_free() + + + + + Retrieves the URI from @media. +to free the returned string + + the URI of the media stream. Use g_free() + + + + + Sets the playback volume of @media to @volume. - - + + the volume as a double between 0.0 and 1.0 + - - - - - + Sets the source of @media using a file path. + A filename + Starts or stops playing of @media. - + %TRUE to start playing + - - - - - + Sets the playback progress of @media. The @progress is +a normalized value between 0.0 (begin) and 1.0 (end). - + the progress of the playback, between 0.0 and 1.0 + - - - - - - - - - - - - - - - - - - - - + Sets the font used by the subtitle renderer. The @font_name string must be either %NULL, which means that the default font name of the underlying implementation will be used; or must follow the grammar recognized by pango_font_description_from_string() like: |[ -clutter_media_set_subtitle_font_name (media, "Sans 24pt"); -]|" - version="1.2"> +clutter_media_set_subtitle_font_name (media, "Sans 24pt"); +]| + a font name, or %NULL to set the default font name - - - - - - + Sets the location of a subtitle file to display while playing @media. - - + + the URI of a subtitle file + - - - - - - + Sets the URI of @media to @uri. - - - - - - - - - - - + + + + the URI of the media stream + + + - + transfer-ownership="none"> + The volume of the audio, as a normalized value between +0.0 and 1.0. + - - + + The fill level of the buffer for the current stream, +as a value between 0.0 and 1.0. + - - + + Whether the current stream is seekable. + - - + + The duration of the current stream, in seconds + - + transfer-ownership="none"> + Whether the #ClutterMedia actor is playing. + - + transfer-ownership="none"> + The current progress of the playback, as a normalized +value between 0.0 and 1.0. + + The font used to display subtitles. The font description has to follow the same grammar as the one recognized by -pango_font_description_from_string()."> - +pango_font_description_from_string(). + - + transfer-ownership="none"> + The location of a subtitle file, expressed as a valid URI. + - + transfer-ownership="none"> + The location of a media file, expressed as a valid URI. + - - - + + The ::eos signal is emitted each time the media stream ends. + + - - - + + The ::error signal is emitted each time an error occurred. + + - - + + the #GError + @@ -15071,13 +25343,13 @@ pango_font_description_from_string()."> + Interface vtable for #ClutterMedia implementations - + @@ -15089,7 +25361,7 @@ pango_font_description_from_string()."> - + @@ -15104,70 +25376,128 @@ pango_font_description_from_string()."> + + + + + + - + + + + + + + + + + - + - + - + + + + - + + Base class for list models. The #ClutterModel structure contains +only private data and should be manipulated using the provided +API. - - - - - - - - - - - + + Retrieves the name of the @column +string, and it should not be modified or freed + the name of the column. The model holds the returned - + the column number + - + + Retrieves the type of the @column. + the type of the column. - + the column number + - + + Retrieves a #ClutterModelIter representing the row at the given index. +If a filter function has been set using clutter_model_set_filter() +then the @model implementation will return the first non filtered +row. +out of bounds. When done using the iterator object, call g_object_unref() +to deallocate its resources + A new #ClutterModelIter, or %NULL if @row was + + + + + position of the row to retrieve + + + + + + Retrieves the number of columns inside @model. + + the number of columns + + + + + Retrieves the number of rows inside @model, eventually taking +into account any filtering function set using clutter_model_set_filter(). +the length of the filtered @model is returned. + + The length of the @model. If there is a filter set, then + + + + + - + @@ -15177,92 +25507,37 @@ API." - + - - - - - - - - - - - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates and appends a new row to the #ClutterModel, setting the row values upon creation. For example, to append a new row where column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING: <informalexample><programlisting> ClutterModel *model; model = clutter_model_default_new (2, -G_TYPE_INT, "Score", -G_TYPE_STRING, "Team"); -clutter_model_append (model, 0, 42, 1, "Team #1", -1); -</programlisting></informalexample>" - version="0.6"> +G_TYPE_INT, "Score", +G_TYPE_STRING, "Team"); +clutter_model_append (model, 0, 42, 1, "Team #1", -1); +</programlisting></informalexample> @@ -15275,26 +25550,277 @@ clutter_model_append (model, 0, 42, 1, "Team #1", -1); + Creates and appends a new row to the #ClutterModel, setting the row +values for the given @columns upon creation. - + the number of columns and values + - - - + + a vector with the columns to set + + - + a vector with the values + + + + + + + + Checks whether the row pointer by @iter should be filtered or not using +the filtering function set on @model. +This function should be used only by subclasses of #ClutterModel. +%FALSE otherwise + + %TRUE if the row should be displayed, + + + + + the row to filter + + + + + + Checks whether @row should be filtered or not using the +filtering function set on @model. +This function should be used only by subclasses of #ClutterModel. +%FALSE otherwise + + %TRUE if the row should be displayed, + + + + + the row to filter + + + + + + Calls @func for each row in the model. + + + + + + scope="call" + closure="1"> + a #ClutterModelForeachFunc + + + + user data to pass to @func + + + + + + Retrieves the name of the @column +string, and it should not be modified or freed + + the name of the column. The model holds the returned + + + + + the column number + + + + + + Retrieves the type of the @column. + + the type of the column. + + + + + the column number + + + + + + Returns whether the @model has a filter in place, set +using clutter_model_set_filter() + + %TRUE if a filter is set + + + + + Retrieves a #ClutterModelIter representing the first non-filtered +row in @model. +Call g_object_unref() when done using it + + A new #ClutterModelIter. + + + + + Retrieves a #ClutterModelIter representing the row at the given index. +If a filter function has been set using clutter_model_set_filter() +then the @model implementation will return the first non filtered +row. +out of bounds. When done using the iterator object, call g_object_unref() +to deallocate its resources + + A new #ClutterModelIter, or %NULL if @row was + + + + + position of the row to retrieve + + + + + + Retrieves a #ClutterModelIter representing the last non-filtered +row in @model. +Call g_object_unref() when done using it + + A new #ClutterModelIter. + + + + + Retrieves the number of columns inside @model. + + the number of columns + + + + + Retrieves the number of rows inside @model, eventually taking +into account any filtering function set using clutter_model_set_filter(). +the length of the filtered @model is returned. + + The length of the @model. If there is a filter set, then + + + + + Retrieves the number of column used for sorting the @model. + + a column number, or -1 if the model is not sorted + + + + + Inserts a new row to the #ClutterModel at @row, setting the row +values upon creation. For example, to insert a new row at index 100, +where column 0 is type %G_TYPE_INT and column 1 is of type +%G_TYPE_STRING: +<informalexample><programlisting> +ClutterModel *model; +model = clutter_model_default_new (2, +G_TYPE_INT, "Score", +G_TYPE_STRING, "Team"); +clutter_model_insert (model, 3, 0, 42, 1, "Team #1", -1); +</programlisting></informalexample> + + + + + + the position to insert the new row + + + + + + + + + + Sets the data in the cell specified by @iter and @column. The type of +not exist then it is created. + + + + + + position of the row to modify + + + + column to modify + + + + new value for the cell + + + + + + Inserts data at @row into the #ClutterModel, setting the row +values for the given @columns upon creation. + + + + + + row index + + + + the number of columns and values to set + + + + a vector containing the columns to set + + + + + + a vector containing the values for the cells @@ -15303,17 +25829,18 @@ values for the given @columns upon creation." + Creates and prepends a new row to the #ClutterModel, setting the row values upon creation. For example, to prepend a new row where column 0 is type %G_TYPE_INT and column 1 is of type %G_TYPE_STRING: <informalexample><programlisting> ClutterModel *model; model = clutter_model_default_new (2, -G_TYPE_INT, "Score", -G_TYPE_STRING, "Team"); -clutter_model_prepend (model, 0, 42, 1, "Team #1", -1); -</programlisting></informalexample>" - version="0.6"> +G_TYPE_INT, "Score", +G_TYPE_STRING, "Team"); +clutter_model_prepend (model, 0, 42, 1, "Team #1", -1); +</programlisting></informalexample> @@ -15326,353 +25853,172 @@ clutter_model_prepend (model, 0, 42, 1, "Team #1", -1); + Creates and prepends a new row to the #ClutterModel, setting the row +values for the given @columns upon creation. - + the number of columns and values to set + - - - + + a vector containing the columns to set + + - - + + a vector containing the values for the cells + - + + Removes the row at the given position from the model. - - - - - + position of row to remove + - + + Force a resort on the @model. This function should only be +used by subclasses of #ClutterModel. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Filters the @model using the given filtering function. - + scope="notified" + closure="1" + destroy="2"> + a #ClutterModelFilterFunc, or #NULL + - + user data to pass to @func, or #NULL + + + + destroy notifier of @user_data, or #NULL + + + + + + Assigns a name to the columns of a #ClutterModel. +This function is meant primarily for #GObjects that inherit from +#ClutterModel, and should only be used when contructing a #ClutterModel. +It will not work after the initial creation of the #ClutterModel. + + + + + + the number of column names + + + + an array of strings + + + + Sorts @model using the given sorting function. - + the column to sort on + - - - - - - - - - - - - - - - - - + a #ClutterModelSortFunc, or #NULL + - + user data to pass to @func, or #NULL + - + + destroy notifier of @user_data, or #NULL - - - - - - + Sets the model to sort by @column. If @column is a negative value +the sorting column will be unset. - - - - - - - + + the column of the @model to sort, or -1 + - + Sets the types of the columns inside a #ClutterModel. +This function is meant primarily for #GObjects that inherit from +#ClutterModel, and should only be used when contructing a #ClutterModel. +It will not work after the initial creation of the #ClutterModel. - + - - + + number of columns for the model + + + + an array of #GType types + + + - + Whether the #ClutterModel has a filter set This property is set to %TRUE if a filter function has been -set using clutter_model_set_filter()"> - +set using clutter_model_set_filter() + @@ -15680,75 +26026,74 @@ set using clutter_model_set_filter()"> - - - + + The ::filter-changed signal is emitted when a new filter has been applied + + - + The ::row-added signal is emitted when a new row has been added. The data on the row has already been set when the ::row-added signal -has been emitted." - version="0.6"> - - +has been emitted. + + - - + + a #ClutterModelIter pointing to the new row + - + The ::row-removed signal is emitted when a row has been changed. The data on the row has already been updated when the ::row-changed -signal has been emitted." - version="0.6"> - - +signal has been emitted. + + - - + + a #ClutterModelIter pointing to the changed row + - + The ::row-removed signal is emitted when a row has been removed. The data on the row pointed by the passed iterator is still valid -when the ::row-removed signal has been emitted." - version="0.6"> - - +when the ::row-removed signal has been emitted. + + - - + + a #ClutterModelIter pointing to the removed row + - - - + + The ::sort-changed signal is emitted after the model has been sorted + + + Class for #ClutterModel instances. - + - + The length of the @model. If there is a filter set, then + @@ -15758,9 +26103,10 @@ when the ::row-removed signal has been emitted." - + - + the number of columns + @@ -15770,8 +26116,9 @@ when the ::row-removed signal has been emitted." - + + the name of the column. The model holds the returned @@ -15779,14 +26126,16 @@ when the ::row-removed signal has been emitted." - + the column number + - + + the type of the column. @@ -15794,14 +26143,15 @@ when the ::row-removed signal has been emitted." - + the column number + - - - + + + @@ -15809,13 +26159,13 @@ when the ::row-removed signal has been emitted." - + - + @@ -15824,14 +26174,15 @@ when the ::row-removed signal has been emitted." - + - + + A new #ClutterModelIter, or %NULL if @row was @@ -15839,13 +26190,14 @@ when the ::row-removed signal has been emitted." - + position of the row to retrieve + - - + + @@ -15853,17 +26205,17 @@ when the ::row-removed signal has been emitted." - + - + - + @@ -15878,7 +26230,7 @@ when the ::row-removed signal has been emitted." - + @@ -15893,7 +26245,7 @@ when the ::row-removed signal has been emitted." - + @@ -15908,7 +26260,7 @@ when the ::row-removed signal has been emitted." - + @@ -15920,7 +26272,7 @@ when the ::row-removed signal has been emitted." - + @@ -15931,57 +26283,57 @@ when the ::row-removed signal has been emitted." - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -15990,117 +26342,164 @@ when the ::row-removed signal has been emitted." + Filters the content of a row in the model. - + If the row should be displayed, return %TRUE + + a #ClutterModel + the iterator for the row - + data passed to clutter_model_set_filter() + + Iterates on the content of a row in the model - + %TRUE if the iteration should continue, %FALSE otherwise + + a #ClutterModel + the iterator for the row - + data passed to clutter_model_foreach() + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Base class for list models iters. The #ClutterModelIter structure +contains only private data and should be manipulated using the +provided API. + + Copies the passed iterator. + a copy of the iterator, or %NULL - - - - - - - + + Retrieves a pointer to the #ClutterModel that this iter is part of. + + a pointer to a #ClutterModel. - + + Retrieves the position of the row that the @iter points to. - + the position of the @iter in the model + - - + + Sets an initializes @value to that at @column. When done with @value, +g_value_unset() needs to be called to free any allocated memory. + + + + + + column number to retrieve the value from + + + + an empty #GValue to set + + + + + + Gets whether the current iterator is at the beginning of the model +to which it belongs. + + #TRUE if @iter is the first iter in the filtered model + + + + + Gets whether the iterator is at the end of the model to which it +belongs. + + #TRUE if @iter is the last iter in the filtered model. + + + + + Updates the @iter to point at the next position in the model. +The model implementation should take into account the presence of +a filter function. +row in the model. + + The passed iterator, updated to point at the next + + Sets the @iter to point at the previous position in the model. +The model implementation should take into account the presence of +a filter function. +row in the model. + + The passed iterator, updated to point at the previous + + + + + Sets the data in the cell specified by @iter and @column. The type of + + + + + + column number to retrieve the value from + + + + new value for the cell + + + + + + Copies the passed iterator. + + a copy of the iterator, or %NULL + + + + Gets the value of one or more cells in the row referenced by @iter. The variable argument list should contain integer column numbers, each column column number followed by a place to store the value being retrieved. The list is terminated by a -1. @@ -16109,8 +26508,7 @@ For example, to get a value from column 0 with type %G_TYPE_STRING use: clutter_model_iter_get (iter, 0, &place_string_here, -1); </programlisting></informalexample> where place_string_here is a gchar* to be filled with the string. If -appropriate, the returned values have to be freed or unreferenced." - version="0.6"> +appropriate, the returned values have to be freed or unreferenced. @@ -16121,138 +26519,168 @@ appropriate, the returned values have to be freed or unreferenced." + + Retrieves a pointer to the #ClutterModel that this iter is part of. + + a pointer to a #ClutterModel. + + + + + Retrieves the position of the row that the @iter points to. + + the position of the @iter in the model + + + + + See clutter_model_iter_get(). This version takes a va_list for language +bindings. + + + + + + a list of column/return location pairs, terminated by -1 + + + + + Sets an initializes @value to that at @column. When done with @value, +g_value_unset() needs to be called to free any allocated memory. - - - - - - - - - - - - - - - - - - - - - - - - - + column number to retrieve the value from + + an empty #GValue to set + Gets whether the current iterator is at the beginning of the model +to which it belongs. - + #TRUE if @iter is the first iter in the filtered model + + Gets whether the iterator is at the end of the model to which it +belongs. - + #TRUE if @iter is the last iter in the filtered model. + - + Updates the @iter to point at the next position in the model. The model implementation should take into account the presence of a filter function. -row in the model." - version="0.6"> - +row in the model. + + The passed iterator, updated to point at the next - + Sets the @iter to point at the previous position in the model. The model implementation should take into account the presence of a filter function. -row in the model." - version="0.6"> - - - - - - - - - - +row in the model. - - - - - + The passed iterator, updated to point at the previous + + Sets the value of one or more cells in the row referenced by @iter. The +variable argument list should contain integer column numbers, each column +column number followed by the value to be set. The list is terminated by a +-1. +For example, to set column 0 with type %G_TYPE_STRING, use: +<informalexample><programlisting> +clutter_model_iter_set (iter, 0, "foo", -1); +</programlisting></informalexample> + + + + + + + + + + + + See clutter_model_iter_set(); this version takes a va_list for language +bindings. + + + + + + va_list of column/value pairs, terminiated by -1 + + + + + + Sets the data in the cell specified by @iter and @column. The type of + + + + + + column number to retrieve the value from + + + + new value for the cell + + + + - + transfer-ownership="none"> + A reference to the #ClutterModel that this iter belongs to. + - + transfer-ownership="none"> + The row number to which this iter points to. + @@ -16264,13 +26692,13 @@ row in the model." + Class for #ClutterModelIter instances. - + @@ -16279,16 +26707,18 @@ row in the model." - + column number to retrieve the value from + + an empty #GValue to set - + @@ -16297,18 +26727,21 @@ row in the model." - + column number to retrieve the value from + + new value for the cell - + - + #TRUE if @iter is the first iter in the filtered model + @@ -16318,9 +26751,10 @@ row in the model." - + - + #TRUE if @iter is the last iter in the filtered model. + @@ -16330,8 +26764,9 @@ row in the model." - - + + + The passed iterator, updated to point at the next @@ -16342,8 +26777,9 @@ row in the model." - - + + + The passed iterator, updated to point at the previous @@ -16354,8 +26790,9 @@ row in the model." - - + + + a pointer to a #ClutterModel. @@ -16366,9 +26803,10 @@ row in the model." - + - + the position of the @iter in the model + @@ -16378,8 +26816,9 @@ row in the model." - + + a copy of the iterator, or %NULL @@ -16389,95 +26828,100 @@ row in the model." - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - + - + - + + Compares the content of two rows in the model. - + a positive integer if @a is after @b, a negative integer if + + a #ClutterModel + a #GValue representing the contents of the row + a #GValue representing the contents of the second row - + data passed to clutter_model_set_sort() + + Masks applied to a #ClutterEvent by modifiers. - + + + + + + + + Event for the pointer motion - + @@ -16571,198 +27019,546 @@ row in the model." - + - + - + - + - + - + - + - + + + + + + + + + + - + - + - + - + - + + + + - + + + + - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + The #ClutterOffscreenEffect structure contains only private data +and should be accessed using the provided API + + Calls the create_texture() virtual function of the @effect +%COGL_INVALID_HANDLE. The returned handle has its reference +count increased. + + a handle to a Cogl texture, or + + + + + + + + + + + + + Calls the paint_target() virtual function of the @effect + + + + + + Calls the create_texture() virtual function of the @effect +%COGL_INVALID_HANDLE. The returned handle has its reference +count increased. + + a handle to a Cogl texture, or + + + + + the minimum width of the target texture + + + + the minimum height of the target texture + + + + + + Retrieves the material used as a render target for the offscreen +buffer created by @effect +You should only use the returned #CoglMaterial when painting. The +returned material might change between different frames. +returned material is owned by Clutter and it should not be +modified or freed + + a #CoglMaterial or %NULL. The + + + + + Calls the paint_target() virtual function of the @effect + + + + + + + + + + + + + The #ClutterOffscreenEffectClass structure contains only private data + + + + + + + a handle to a Cogl texture, or + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + - + - + - + - + - + - + - + - + + + <structname>ClutterPageTurnEffect</structname> is an opaque structure +whose members can only be accessed using the provided API + + Creates a new #ClutterPageTurnEffect instance with the given parameters + + the newly created #ClutterPageTurnEffect + + + + + the period of the page curl, between 0.0 and 1.0 + + + + the angle of the page curl, between 0.0 and 360.0 + + + + the radius of the page curl, in pixels + + + + + + Retrieves the value set using clutter_page_turn_effect_get_angle() + + the angle of the page curling + + + + + Retrieves the value set using clutter_page_turn_effect_get_period() + + the period of the page curling + + + + + Retrieves the value set using clutter_page_turn_effect_set_radius() + + the radius of the page curling + + + + + Sets the angle of the page curling, in degrees + + + + + + the angle of the page curl, in degrees + + + + + + Sets the period of the page curling, between 0.0 (no curling) +and 1.0 (fully curled) + + + + + + the period of the page curl, between 0.0 and 1.0 + + + + + + Sets the radius of the page curling + + + + + + the radius of the page curling, in pixels + + + + + + The angle of the page rotation, in degrees, between 0.0 and 360.0 + + + + The period of the page turn, between 0.0 (no curling) and +1.0 (fully curled) + + + + The radius of the page curl, in pixels + + + - + - + - - + + A #GParamSpec subclass for defining properties holding +a #ClutterColor. + - + - - - + + + - + - + - + - - + + + + + #GParamSpec subclass for unit based properties. @@ -16770,191 +27566,245 @@ a #ClutterColor." - + - + - + + + + - The #ClutterPath struct contains only private data and should +be accessed with the functions below. + + Creates a new #ClutterPath instance with no nodes. The object has a floating reference so if you add it to a -#ClutterBehaviourPath then you do not need to unref it." - version="1.0"> - +#ClutterBehaviourPath then you do not need to unref it. + + the newly created #ClutterPath + Creates a new #ClutterPath instance with the nodes described in the string. The object has a floating reference so if you add it to a -#ClutterBehaviourPath then you do not need to unref it." - version="1.0"> - +#ClutterBehaviourPath then you do not need to unref it. + + the newly created #ClutterPath + a string describing the path - + Add the nodes of the Cairo path to the end of @path. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a Cairo path + + Adds a %CLUTTER_PATH_CLOSE type node to the path. This creates a +straight line from the last node to the last %CLUTTER_PATH_MOVE_TO +type node. + + Adds a %CLUTTER_PATH_CURVE_TO type node to the path. This causes +the actor to follow a bezier from the last node to (@x_3, @y_3) using +(@x_1, @y_1) and (@x_2,@y_2) as control points. + + + + + + the x coordinate of the first control point + + + + the y coordinate of the first control point + + + + the x coordinate of the second control point + + + + the y coordinate of the second control point + + + + the x coordinate of the third control point + + + + the y coordinate of the third control point + + + + + + Adds a %CLUTTER_PATH_LINE_TO type node to the path. This causes the +actor to move to the new coordinates in a straight line. + + + + + + the x coordinate + + + + the y coordinate + + + + + + Adds a %CLUTTER_PATH_MOVE_TO type node to the path. This is usually +used as the first node in a path. It can also be used in the middle +of the path to cause the actor to jump to the new coordinate. + + + + + + the x coordinate + + + + the y coordinate + + + + + + Adds @node to the end of the path. + + + + + + a #ClutterPathNode + + + + + + Same as clutter_path_add_curve_to() except the coordinates are +relative to the previous node. + + + + + + the x coordinate of the first control point + + + + the y coordinate of the first control point + + + + the x coordinate of the second control point + + + + the y coordinate of the second control point + + + + the x coordinate of the third control point + + + + the y coordinate of the third control point + + + + + + Same as clutter_path_add_line_to() except the coordinates are +relative to the previous node. + + + + + + the x coordinate + + + + the y coordinate + + + + + + Same as clutter_path_add_move_to() except the coordinates are +relative to the previous node. + + + + + + the x coordinate + + + + the y coordinate + + + + + Adds new nodes to the end of the path as described in @str. The format is a subset of the SVG path format. Each node is represented by a letter and is followed by zero, one or three pairs of coordinates. The coordinates can be separated by spaces or a @@ -16986,88 +27836,28 @@ on the point 300,300 you could use the following path: M 250,350 l 0 -100 L 350,250 l 0 100 z </programlisting> </informalexample> -If the path description isn't valid %FALSE will be returned and no +If the path description isn't valid %FALSE will be returned and no nodes will be added. -otherwise." - version="1.0"> +otherwise. - + %TRUE is the path description was valid or %FALSE + + a string describing the new nodes - + + Removes all nodes from the path. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Calls a function for each node of the path. @@ -17075,135 +27865,185 @@ the list." + closure="1"> + the function to call with each node - + user data to pass to the function + - + Returns a newly allocated string describing the path in the same +format as used by clutter_path_add_string(). + + a string description of the path. Free with g_free(). + + + + + Retrieves an approximation of the total length of the path. + + the length of the path. + + + + + Retrieves the number of nodes in the path. + + the number of nodes. + + + + + Retrieves the node of the path indexed by @index. - + the node number to retrieve + + a location to store a copy of the node + + + + + + Returns a #GSList of #ClutterPathNode<!-- -->s. The list should be +freed with g_slist_free(). The nodes are owned by the path and +should not be freed. Altering the path may cause the nodes in the +list to become invalid so you should copy them if you want to keep +the list. +list of nodes in the path. + + a + + + + + + + The value in @progress represents a position along the path where +0.0 is the beginning and 1.0 is the end of the path. An +interpolated position is then stored in @position. + + index of the node used to calculate the position. + + + + + a position along the path as a fraction of its length + + + + location to store the position + + + + + + Inserts @node into the path before the node at the given offset. If + + + + + + offset of where to insert the node + + + + the node to insert + Removes the node at the given offset from the path. - + index of the node to remove + + Replaces the node at offset @index_ with @node. - + index to the existing node + + the replacement node - - - - - + Replaces all of the nodes in the path with nodes described by +If the string is invalid then %FALSE is returned and the path is +unaltered. - + %TRUE is the path was valid, %FALSE otherwise. + + a string describing the path - - - - - + Add the nodes of the ClutterPath to the path in the Cairo context. + a Cairo context - - - - - - - - - - - - - - - - - - - - + + - - + + @@ -17212,28 +28052,28 @@ interpolated position is then stored in @position." - + + This function is passed to clutter_path_foreach() and will be +called for each node contained in the path. + the node - + optional data passed to the function + + The #ClutterPathClass struct contains only private data. @@ -17241,59 +28081,59 @@ called for each node contained in the path." + Represents a single node of a #ClutterPath. Some of the coordinates in @points may be unused for some node types. %CLUTTER_PATH_MOVE_TO and %CLUTTER_PATH_LINE_TO use only one pair of coordinates, %CLUTTER_PATH_CURVE_TO uses all three and -%CLUTTER_PATH_CLOSE uses none." - version="1.0" - glib:type-name="ClutterPathNode" - glib:get-type="clutter_path_node_get_type"> +%CLUTTER_PATH_CLOSE uses none. - + - + + Makes an allocated copy of a node. + the copied node. - - - - - + Compares two nodes and checks if they are the same type with the +same coordinates. - + %TRUE if the nodes are the same. + + Second node + + Frees the memory of an allocated node. + + + + + Types of nodes in a #ClutterPath. - + - + + glib:get-type="clutter_perspective_get_type" + c:symbol-prefix="perspective"> + Stage perspective definition. #ClutterPerspective is only used by +the fixed point version of clutter_stage_set_perspective(). - + - + - + - + - + + + + + Controls the paint cycle of the scene graph when in pick mode + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + - + - + - + - + - + Prototype of the progress function used to compute the value between the two ends @a and @b of an interval depending on the value of @progress. The #GValue in @retval is already initialized with the same @@ -17482,184 +28337,197 @@ type as @a and @b. This function will be called by #ClutterInterval if the type of the values of the interval was registered using clutter_interval_register_progress_func(). -the value and stored it inside @retval" - version="1.0"> +the value and stored it inside @retval - + %TRUE if the function successfully computed + + the initial value of an interval + the final value of an interval - + the progress factor, between 0 and 1 + + the value used to store the progress - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + The #ClutterRectangle structure contains only private data +and should be accessed using the provided API + + - - - + + Creates a new #ClutterActor with a rectangular shape. + + a new #ClutterActor + - - + c:identifier="clutter_rectangle_new_with_color"> + Creates a new #ClutterActor with a rectangular shape +and of the given @color. + + a new #ClutterActor + + a #ClutterColor - - - - - - - - - - - + + Gets the color of the border used by @rectangle and places +it into @color. + return location for a #ClutterColor + Gets the width (in pixels) of the border used by @rectangle - + the border's width + - - - - - - - - - - - + + Retrieves the color of @rectangle. + return location for a #ClutterColor + c:identifier="clutter_rectangle_set_border_color"> + Sets the color of the border used by @rectangle using @color + the color of the border + + + + + + Sets the width (in pixel) of the border used by @rectangle. +A @width of 0 will unset the border. + + + + + + the width of the border + + + + + + Sets the color of @rectangle. + + + + + + a #ClutterColor @@ -17667,23 +28535,27 @@ it into @color." - + transfer-ownership="none"> + The color of the border of the rectangle. + - + transfer-ownership="none"> + The width of the border of the rectangle, in pixels. + - - + + The color of the rectangle. + - + transfer-ownership="none"> + Whether the #ClutterRectangle should be displayed with a border. + @@ -17695,52 +28567,57 @@ it into @color." + The #ClutterRectangleClass structure contains only private data - - + + - - + + - - + + - - + + - + + + + - + + Flags passed to the clutter_actor_queue_redraw_with_clip () +function + + + + + + - + + + + + Specifies the type of requests for a #ClutterActor. - + - + + + + + + + + + + - + + Axis of a rotation. + Direction of a rotation. + + + + + + + + + - + - + - + - + - + + + + - + - + - + - The #ClutterScore structure contains only private data +and should be accessed using the provided API + + Creates a new #ClutterScore. A #ClutterScore is an object that can hold multiple #ClutterTimeline<!-- -->s in a sequential order. -when done." - version="0.6"> +when done. + the newly created #ClutterScore. Use g_object_unref() - - - - - - - - - - - - - - - - + Appends a timeline to another one existing in the score; the newly appended timeline will be started when @parent is complete. If @parent is %NULL, the new #ClutterTimeline will be started when clutter_score_start() is called. #ClutterScore will take a reference on @timeline. 0 on failure. The returned id can be used with clutter_score_remove() -or clutter_score_get_timeline()." - version="0.6"> +or clutter_score_get_timeline(). - + the id of the #ClutterTimeline inside the score, or + - + + a #ClutterTimeline in the score, or %NULL + a #ClutterTimeline + Appends @timeline at the given @marker_name on the @parent #ClutterTimeline. If you want to append @timeline at the end of @parent, use clutter_score_append(). The #ClutterScore will take a reference on @timeline. 0 on failure. The returned id can be used with clutter_score_remove() -or clutter_score_get_timeline()." - version="0.8"> +or clutter_score_get_timeline(). - + the id of the #ClutterTimeline inside the score, or + + the parent #ClutterTimeline + the name of the marker to use + the #ClutterTimeline to append - + Gets whether @score is looping - - - - - - - - - - - + %TRUE if the score is looping + - + Retrieves the #ClutterTimeline for @id inside @score. +function does not increase the reference count on the returned +#ClutterTimeline + + the requested timeline, or %NULL. This - + the id of the timeline + + + Query state of a #ClutterScore instance. + + %TRUE if score is currently playing + + + - + Retrieves a list of all the #ClutterTimelines managed by @score. +#GSList containing all the timelines in the score. This function does +not increase the reference count of the returned timelines. Use +g_slist_free() on the returned list to deallocate its resources. + + a - + + Pauses a playing score @score. - + Removes the #ClutterTimeline with the given id inside @score. If +the timeline has other timelines attached to it, those are removed +as well. + + + + + + the id of the timeline to remove + + + + + + Removes all the timelines inside @score. - + + Rewinds a #ClutterScore to its initial state. - + Sets whether @score should loop. A looping #ClutterScore will start +from its initial state after the ::complete signal has been fired. + + + + + + %TRUE for enable looping + + + + + + Starts the score. - + + Stops and rewinds a playing #ClutterScore instance. - + - + transfer-ownership="none"> + Whether the #ClutterScore should restart once finished. + @@ -18027,51 +28936,48 @@ returned list to deallocate its resources." - - - + + The ::completed signal is emitted each time a #ClutterScore terminates. + + - - - + + The ::paused signal is emitted each time a #ClutterScore +is paused. + + - - - + + The ::started signal is emitted each time a #ClutterScore starts playing. + + - - - + + The ::timeline-completed signal is emitted each time a timeline +inside a #ClutterScore terminates. + + - - + + the completed timeline + - - - + + The ::timeline-started signal is emitted each time a new timeline +inside a #ClutterScore starts playing. + + - - + + the current timeline + @@ -18079,13 +28985,13 @@ inside a #ClutterScore starts playing." + The #ClutterScoreClass structure contains only private data - + @@ -18100,7 +29006,7 @@ inside a #ClutterScore starts playing." - + @@ -18115,7 +29021,7 @@ inside a #ClutterScore starts playing." - + @@ -18127,7 +29033,7 @@ inside a #ClutterScore starts playing." - + @@ -18139,7 +29045,7 @@ inside a #ClutterScore starts playing." - + @@ -18150,149 +29056,203 @@ inside a #ClutterScore starts playing." - - + + - - + + - - + + - - + + - - + + - + + + + - The #ClutterScript structure contains only private data +and should be accessed using the provided API + + Creates a new #ClutterScript instance. #ClutterScript can be used to load objects definitions for scenegraph elements, like actors, or behavioural elements, like behaviours and timelines. The definitions must be encoded using the JavaScript Object Notation (JSON) language. -g_object_unref() when done." - version="0.6"> +g_object_unref() when done. + the newly created #ClutterScript instance. Use - + + Looks up a type by name, using the virtual function that +#ClutterScript has for that purpose. This function should +rarely be used. +%G_TYPE_INVALID if not corresponding type was found. + the type for the requested type name, or + name of the type to look up - + + Adds @paths to the list of search paths held by @script. +The search paths are used by clutter_script_lookup_filename(), which +can be used to define search paths for the textures source file name +or other custom, file-based properties. - + - + + an array of strings containing different search paths + + the length of the passed array + + - + + Connects all the signals defined into a UI definition file to their +handlers. +This method invokes clutter_script_connect_signals_full() internally +and uses #GModule's introspective features (by opening the current +module's scope) to look at the application's symbol table. +Note that this function will not work if #GModule is not supported by +the platform Clutter is running on. - + - - - - - + + data to be passed to the signal handlers, or %NULL + + + Connects all the signals defined into a UI definition file to their +handlers. +This function allows to control how the signal handlers are +going to be connected to their respective signals. It is meant +primarily for language bindings to allow resolving the function +names using the native API, but it can also be used on platforms +that do not support GModule. +Applications should use clutter_script_connect_signals(). + + + + + + signal connection function + + + + data to be passed to the signal handlers, or %NULL + + + + + + Ensure that every object defined inside @script is correctly +constructed. You should rarely need to use this function. + + + + - + Retrieves the object bound to @name. This function does not increment +the reference count of the returned object. +with the given name was available + + the named object, or %NULL if no object + the name of the object to retrieve + Retrieves a list of objects for the given names. After @script, object names/return location pairs should be listed, with a %NULL pointer ending the list, like: <informalexample><programlisting> GObject *my_label, *a_button, *main_timeline; clutter_script_get_objects (script, -"my-label", &amp;my_label, -"a-button", &amp;a_button, -"main-timeline", &amp;main_timeline, +"my-label", &amp;my_label, +"a-button", &amp;a_button, +"main-timeline", &amp;main_timeline, NULL); </programlisting></informalexample> -returned objects." - version="0.6"> +returned objects. - + the number of objects returned. + + the name of the first object to retrieve @@ -18301,148 +29261,122 @@ returned objects." + + Looks up a type by name, using the virtual function that +#ClutterScript has for that purpose. This function should +rarely be used. +%G_TYPE_INVALID if not corresponding type was found. + + the type for the requested type name, or + + + + + name of the type to look up + + + + - + Retrieves all the objects created by @script. +objects it returns. +of #GObject<!-- -->s, or %NULL. The objects are owned by the +#ClutterScript instance. Use g_list_free() on the returned list when +done. + + a list - + + Loads the definitions from @data into @script and merges with +the currently loaded ones, if any. +accordingly. On success, the merge id for the UI definitions is +returned. You can use the merge id with clutter_script_unmerge(). - + on error, zero is returned and @error is set + - - - - - - - - - - - - - - - - + + a buffer containing the definitions - - - - - - - - - + + the length of the buffer, or -1 if @data is a NUL-terminated buffer + - + + Loads the definitions from @filename into @script and merges with +the currently loaded ones, if any. +accordingly. On success, the merge id for the UI definitions is +returned. You can use the merge id with clutter_script_unmerge_objects(). - + on error, zero is returned and @error is set + - - - - - - - - - - - - - - + + the full path to the definition file - - - + Looks up @filename inside the search paths of @script. If @filename +is found, its full path will be returned . +found. + the full path of @filename or %NULL if no path was + the name of the file to lookup - - + + Unmerges the objects identified by @merge_id. + + + + + + merge id returned when loading a UI definition + + + + + + The path of the currently parsed file. If #ClutterScript:filename-set +is %FALSE then the value of this property is undefined. + - + Whether the #ClutterScript:filename property is set. If this property is %TRUE then the currently parsed data comes from a file, and the -file name is stored inside the #ClutterScript:filename property."> - +file name is stored inside the #ClutterScript:filename property. + @@ -18454,14 +29388,15 @@ file name is stored inside the #ClutterScript:filename property."> + The #ClutterScriptClass structure contains only private data - + + the type for the requested type name, or @@ -18469,62 +29404,63 @@ file name is stored inside the #ClutterScript:filename property."> + name of the type to look up - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -18533,45 +29469,52 @@ file name is stored inside the #ClutterScript:filename property."> + This is the signature of a function used to connect signals. It is used by the clutter_script_connect_signals_full() function. It is mainly intended for interpreted language bindings, but could be useful where the -programmer wants more control over the signal connection process." - version="0.6"> +programmer wants more control over the signal connection process. + a #ClutterScript + the object to connect + the name of the signal + the name of the signal handler + the object to connect the signal to, or %NULL + signal connection flags - + user data to pass to the signal handler + + #ClutterScript error enumeration. - + - - - - - - - - - - - + #ClutterScriptable is an opaque structure whose members cannot be directly +accessed + + Retrieves the id of @scriptable set using clutter_scriptable_set_id(). +the scriptable object and should never be modified of freed + the id of the object. The returned string is owned by - + + Parses the passed JSON node. The implementation must set the type +of the passed #GValue pointer using g_value_init(). - + %TRUE if the node was successfully parsed, %FALSE otherwise. + + the #ClutterScript creating the scriptable instance + the generic value to be set + the name of the node - + the JSON node to be parsed + - + + Overrides the common properties setting. The underlying virtual +function should be used when implementing custom properties. + the #ClutterScript creating the scriptable instance + the name of the property + the value of the property - + Sets @id as the unique Clutter script it for this instance of #ClutterScriptableIface. This name can be used by user interface designer applications to define a unique name for an object constructable using the UI -definition language parsed by #ClutterScript." - version="0.6"> +definition language parsed by #ClutterScript. - + - + + Retrieves the id of @scriptable set using clutter_scriptable_set_id(). +the scriptable object and should never be modified of freed + the id of the object. The returned string is owned by + Parses the passed JSON node. The implementation must set the type +of the passed #GValue pointer using g_value_init(). - + %TRUE if the node was successfully parsed, %FALSE otherwise. + + the #ClutterScript creating the scriptable instance + the generic value to be set + the name of the node - + the JSON node to be parsed + + Overrides the common properties setting. The underlying virtual +function should be used when implementing custom properties. + the #ClutterScript creating the scriptable instance + the name of the property + the value of the property + + Sets @id as the unique Clutter script it for this instance of +#ClutterScriptableIface. +This name can be used by user interface designer applications to +define a unique name for an object constructable using the UI +definition language parsed by #ClutterScript. + + + + + + the #ClutterScript id of the object + + + + + Interface for implementing "scriptable" objects. An object implementing +this interface can override the parsing and properties setting sequence +when loading a UI definition data with #ClutterScript - + @@ -18741,8 +29719,9 @@ when loading a UI definition data with #ClutterScript" - + + the id of the object. The returned string is owned by @@ -18753,31 +29732,36 @@ when loading a UI definition data with #ClutterScript" - + - + %TRUE if the node was successfully parsed, %FALSE otherwise. + + the #ClutterScript creating the scriptable instance + the generic value to be set + the name of the node - + the JSON node to be parsed + - + @@ -18786,24 +29770,30 @@ when loading a UI definition data with #ClutterScript" + the #ClutterScript creating the scriptable instance + the name of the property + the value of the property + + + + Direction of a pointer scroll event. - + + + + + Scroll wheel (or similar device) event - + @@ -18841,10 +29832,10 @@ when loading a UI definition data with #ClutterScript" - + - + @@ -18853,242 +29844,386 @@ when loading a UI definition data with #ClutterScript" - + + + + - + + + + - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + + + <structname>ClutterSettings</structname> is an opaque structure whose +members cannot be directly accessed. + + Retrieves the singleton instance of #ClutterSettings +returned object is owned by Clutter and it should not be unreferenced +directly + + the instance of #ClutterSettings. The + + + + + A back pointer to the #ClutterBackend + + + + The maximum distance, in pixels, between button-press events that +determines whether or not to increase the click count by 1. + + + + The time, in milliseconds, that should elapse between button-press +events in order to increase the click count by 1. + + + + Whether or not to use antialiasing when rendering text; a value +of 1 enables it unconditionally; a value of 0 disables it +unconditionally; and -1 will use the system's default. + + + + The DPI used when rendering text, as a value of 1024 * dots/inch. +If set to -1, the system's default will be used instead + + + + The style of the hinting used when rendering text. Valid values +are: +<itemizedlist> +<listitem><simpara>hintnone</simpara></listitem> +<listitem><simpara>hintslight</simpara></listitem> +<listitem><simpara>hintmedium</simpara></listitem> +<listitem><simpara>hintfull</simpara></listitem> +</itemizedlist> + + + + Whether or not to use hinting when rendering text; a value of 1 +unconditionally enables it; a value of 0 unconditionally disables +it; and a value of -1 will use the system's default. + + + + The default font name that should be used by text actors, as +a string that can be passed to pango_font_description_from_string(). + + + + The type of sub-pixel antialiasing used when rendering text. Valid +values are: +<itemizedlist> +<listitem><simpara>none</simpara></listitem> +<listitem><simpara>rgb</simpara></listitem> +<listitem><simpara>bgr</simpara></listitem> +<listitem><simpara>vrgb</simpara></listitem> +<listitem><simpara>vbgr</simpara></listitem> +</itemizedlist> + + + - + The #ClutterShader structure contains only private data +and should be accessed using the provided API + + Create a new #ClutterShader instance. + a new #ClutterShader. - - - - - - - - - - - - - - - + Compiles and links GLSL sources set for vertex and fragment shaders for +a #ClutterShader. If the compilation fails and a #GError return location is +provided the error will contain the errors from the compiler, if any. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + returns TRUE if the shader was succesfully compiled. + - + Retrieves the underlying #CoglHandle for the fragment shader. +shader, or %NULL. The handle is owned by the #ClutterShader +and it should not be unreferenced + + A #CoglHandle for the fragment + + + + + Retrieves the underlying #CoglHandle for the shader program. +or %NULL. The handle is owned by the #ClutterShader and it should +not be unreferenced + + A #CoglHandle for the shader program, - + Retrieves the underlying #CoglHandle for the vertex shader. +shader, or %NULL. The handle is owned by the #ClutterShader +and it should not be unreferenced + + A #CoglHandle for the vertex - - + + Query the current GLSL fragment source set on @shader. +ClutterShader object or %NULL. The returned string is owned by the +shader object and should never be modified or freed + + the source of the fragment shader for this + + + + + Checks whether @shader is enabled. + + %TRUE if the shader is enabled. + + + + + Query the current GLSL vertex source set on @shader. +ClutterShader object or %NULL. The returned string is owned by the +shader object and should never be modified or freed + + the source of the vertex shader for this + + + + + Checks whether @shader is is currently compiled, linked and bound +to the GL context. + + %TRUE if the shader is compiled, linked and ready for use. + + + + + Frees up any GL context resources held by the shader. + + + + + + Sets the GLSL source code to be used by a #ClutterShader for the fragment +program. + + + + + + GLSL source code. + + + + length of source buffer (currently ignored) + + + + + + Enables a shader. This function will attempt to compile and link +the shader, if it isn't already. +When @enabled is %FALSE the default state of the GL pipeline will be +used instead. + + + + + + The new state of the shader. + + + + + + Sets a user configurable variable in the GLSL shader programs attached to +a #ClutterShader. + + + + + + name of uniform in GLSL shader program to set. + + + + a #ClutterShaderFloat, #ClutterShaderInt or #ClutterShaderMatrix #GValue. + + + + + + Sets the GLSL source code to be used by a #ClutterShader for the vertex +program. + + + + + + GLSL source code. + + + + length of source buffer (currently ignored) + + + + + + Whether the shader is compiled and linked, ready for use +in the GL context. + - + transfer-ownership="none"> + Whether the shader is currently used in the GL rendering pipeline. + - + transfer-ownership="none"> + GLSL source code for the fragment shader part of the shader program. + - + transfer-ownership="none"> + GLSL source code for the vertex shader part of the shader +program, if any + @@ -19100,19 +30235,232 @@ program, if any"> + The #ClutterShaderClass structure contains only private data + + The <structname>ClutterShaderEffect</structname> structure contains +only private data and should be accessed using the provided API + + Retrieves a pointer to the program's handle +or %COGL_INVALID_HANDLE + + a pointer to the program's handle, + + + + + Retrieves a pointer to the shader's handle +or %COGL_INVALID_HANDLE + + a pointer to the shader's handle, + + + + + Sets the source of the GLSL shader used by @effect +This function should only be called by implementations of +the #ClutterShaderEffect class, and not by application code. +This function can only be called once; subsequent calls will +yield no result. + + %TRUE if the source was set + + + + + the source of a GLSL shader + + + + + + Sets a list of values as the payload for the uniform @name inside +the shader effect +%G_TYPE_FLOAT, for 1 or more floating point values; +%CLUTTER_TYPE_SHADER_INT, for a pointer to an array of integer values; +%CLUTTER_TYPE_SHADER_FLOAT, for a pointer to an array of floating point +values; and %CLUTTER_TYPE_SHADER_MATRIX, for a pointer to an array of +floating point values mapping a matrix +The number of values interepreted is defined by the @n_value +argument, and by the @gtype argument. For instance, a uniform named +"sampler0" and containing a single integer value is set using: +|[ +clutter_shader_effect_set_uniform (effect, "sampler0", +G_TYPE_INT, 1, +0); +]| +While a uniform named "components" and containing a 3-elements vector +of floating point values (a "vec3") can be set using: +|[ +gfloat component_r, component_g, component_b; +clutter_shader_effect_set_uniform (effect, "components", +G_TYPE_FLOAT, 3, +component_r, +component_g, +component_b); +]| +or can be set using: +|[ +gfloat component_vec[3]; +clutter_shader_effect_set_uniform (effect, "components", +CLUTTER_TYPE_SHADER_FLOAT, 3, +component_vec); +]| +Finally, a uniform named "map" and containing a matrix can be set using: +|[ +clutter_shader_effect_set_uniform (effect, "map", +CLUTTER_TYPE_SHADER_MATRIX, 1, +cogl_matrix_get_array (&matrix)); +]| + + + + + + the name of the uniform to set + + + + the type of the uniform to set + + + + the number of values + + + + + + + + + + Sets @value as the payload for the uniform @name inside the shader +effect +integer value; %G_TYPE_FLOAT, for a single floating point value; +%CLUTTER_TYPE_SHADER_INT, for an array of integer values; +%CLUTTER_TYPE_SHADER_FLOAT, for an array of floating point values; +and %CLUTTER_TYPE_SHADER_MATRIX, for a matrix of floating point +values + + + + + + the name of the uniform to set + + + + a #GValue with the value of the uniform to set + + + + + + The type of shader that is used by the effect. This property +should be set by the constructor of #ClutterShaderEffect +sub-classes. + + + + + + + + + + + The <structname>ClutterShaderEffectClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #ClutterShader error enumeration c:identifier="CLUTTER_SHADER_ERROR_COMPILE" glib:nick="compile"/> - + - + - + - + + + The type of GLSL shader program + + + - + - + - + + + + - + + + + - + + + + + + + + The #ClutterStage structure contains only private data +and should be accessed using the provided API + + - + Creates a new, non-default stage. A non-default stage is a new top-level actor which can be used as another container. It works exactly like the default stage, but while clutter_stage_get_default() will always return the same instance, you will have to keep a pointer @@ -19172,185 +30549,480 @@ backend. Use clutter_feature_available() and %CLUTTER_FEATURE_STAGE_MULTIPLE to check at runtime whether a backend supports multiple stages. not support multiple stages. Use clutter_actor_destroy() to -programmatically close the returned stage." - version="0.8"> - - +programmatically close the returned stage. + + a new stage, or %NULL if the default backend does + - + Returns the main stage. The default #ClutterStage is a singleton, so the stage will be created the first time this function is called (typically, inside clutter_init()); all the subsequent calls to clutter_stage_get_default() will return the same instance. Clutter guarantess the existence of the default stage. -destroy or unref the returned actor."> - +destroy or unref the returned actor. + + the main #ClutterStage. You should never - + + This function essentially makes sure the right GL context is +current for the passed stage. It is not intended to +be used by applications. + + + + + + Ensures that @stage is redrawn +used when embedding a #ClutterStage into a toolkit with +another windowing system, like GTK+. + + + + + + Ensures that the GL viewport is updated with the current +stage window size. +This function will queue a redraw of @stage. +This function should not be called by applications; it is used +when embedding a #ClutterStage into a toolkit with another +windowing system, like GTK+. + + + + + + This function is used to emit an event on the main stage. +You should rarely need to use this function, except for +synthetised events. + + the return value from the signal emission + + + + + a #ClutterEvent + + + + + + Checks the scene at the coordinates @x and @y and returns a pointer +to the #ClutterActor at those coordinates. +By using @pick_mode it is possible to control which actors will be +painted and thus available. +if any + + the actor at the specified coordinates, + + + + + how the scene graph should be painted + + + + X coordinate to check + + + + Y coordinate to check + + + + + + Retrieves the stage color. + return location for a #ClutterColor - + + Retrieves the current depth cueing settings from the stage. - - + + return location for a #ClutterFog structure + - + + Retrieves whether the stage is full screen or not + + %TRUE if the stage is full screen + + + + + Retrieves the actor that is currently under key focus. + + the actor with key focus, or the stage + + + + + Retrieves the minimum size for a stage window as set using +clutter_stage_set_minimum_size(). +The returned size may not correspond to the actual minimum size and +it is specific to the #ClutterStage implementation inside the +Clutter backend - - + + return location for the minimum width, in pixels, or %NULL + + + + return location for the minimum height, in pixels, or %NULL + + + Retrieves the hint set with clutter_stage_set_no_clear_hint() +cycle, and %FALSE otherwise + + %TRUE if the stage should not clear itself on every paint + + + + c:identifier="clutter_stage_get_perspective"> + Retrieves the stage perspective. - + + return location for a #ClutterPerspective + + Retrieves the value set with clutter_stage_set_throttle_motion_events() +and %FALSE otherwise + + %TRUE if the motion events are being throttled, + + + + + + + + + + Retrieves the value set using clutter_stage_set_use_alpha() +alpha channel of the stage color + + %TRUE if the stage should honour the opacity and the + + + + + Gets whether the depth cueing effect is enabled on @stage. + + %TRUE if the the depth cueing effect is enabled + + + + + Retrieves the value set with clutter_stage_set_user_resizable(). + + %TRUE if the stage is resizable by the user. + + + + + Makes the cursor invisible on the stage window + + + + + + Checks if @stage is the default stage, or an instance created using +clutter_stage_new() but internally using the same implementation. + + %TRUE if the passed stage is the default one + + + + + Queues a redraw for the passed stage. +<note>Applications should call clutter_actor_queue_redraw() and not +this function.</note> +<note>This function is just a wrapper for clutter_actor_queue_redraw() +and should probably go away.</note> + + + + + + Makes a screenshot of the stage in RGBA 8bit data, returns a +linear buffer with @width * 4 as rowstride. +The alpha data contained in the returned buffer is driver-dependent, +and not guaranteed to hold any sensible value. +or %NULL if the read failed. Use g_free() on the returned data +to release the resources it has allocated. + + a pointer to newly allocated memory with the buffer + + + + + x coordinate of the first pixel that is read from stage + + + + y coordinate of the first pixel that is read from stage + + + + Width dimention of pixels to be read, or -1 for the entire stage width + + + + Height dimention of pixels to be read, or -1 for the entire stage height + + + + + + Sets the stage color. + + + + + + A #ClutterColor + + + + + + Sets the fog (also known as "depth cueing") settings for the @stage. +A #ClutterStage will only use a linear fog progression, which +depends solely on the distance from the viewer. The cogl_set_fog() +function in COGL exposes more of the underlying implementation, +and allows changing the for progression function. It can be directly +used by disabling the #ClutterStage:use-fog property and connecting +a signal handler to the #ClutterActor::paint signal on the @stage, +like: +|[ +clutter_stage_set_use_fog (stage, FALSE); +g_signal_connect (stage, "paint", G_CALLBACK (on_stage_paint), NULL); +]| +The paint signal handler will call cogl_set_fog() with the +desired settings: +|[ +static void +on_stage_paint (ClutterActor *actor) +{ +ClutterColor stage_color = { 0, }; +CoglColor fog_color = { 0, }; +/&ast; set the fog color to the stage background color &ast;/ +clutter_stage_get_color (CLUTTER_STAGE (actor), &amp;stage_color); +cogl_color_init_from_4ub (&amp;fog_color, +stage_color.red, +stage_color.green, +stage_color.blue, +stage_color.alpha); +/&ast; enable fog &ast;/ +cogl_set_fog (&amp;fog_color, +COGL_FOG_MODE_EXPONENTIAL, /&ast; mode &ast;/ +0.5, /&ast; density &ast;/ +5.0, 30.0); /&ast; z_near and z_far &ast;/ +} +]| +<note>The fogging functions only work correctly when the visible actors use +unmultiplied alpha colors. By default Cogl will premultiply textures and +cogl_set_source_color() will premultiply colors, so unless you explicitly +load your textures requesting an unmultiplied internal format and use +cogl_material_set_color() you can only use fogging with fully opaque actors. +Support for premultiplied colors will improve in the future when we can +depend on fragment shaders.</note> + + + + + + a #ClutterFog structure + + + + + Asks to place the stage window in the fullscreen or unfullscreen states. -Note that you shouldn't assume the window is definitely full screen afterward, because other entities (e.g. the user or window manager) could unfullscreen it again, and not all window managers honor requests to fullscreen windows. If you want to receive notification of the fullscreen state you should either use the #ClutterStage::fullscreen and #ClutterStage::unfullscreen signals, or use the notify signal -for the #ClutterStage:fullscreen-set property" - version="1.0"> +for the #ClutterStage:fullscreen-set property - + %TRUE to to set the stage fullscreen + - + Sets the key focus on @actor. An actor with key focus will receive +all the key events. If @actor is %NULL, the stage will receive +focus. + + + + + + the actor to set key focus to, or %NULL + + + + + + Sets the minimum size for a stage window, if the default backend +uses #ClutterStage inside a window +This is a convenience function, and it is equivalent to setting the +#ClutterActor:min-width and #ClutterActor:min-height on @stage +If the current size of @stage is smaller than the minimum size, the +This function has no effect if @stage is fullscreen + + + + + + width, in pixels + + + + height, in pixels + + + + + + Sets whether the @stage should clear itself at the beginning +of each paint cycle or not. +Clearing the #ClutterStage can be a costly operation, especially +if the stage is always covered - for instance, in a full-screen +video player or in a game with a background texture. +<note><para>This setting is a hint; Clutter might discard this +hint depending on its internal state.</para></note> +<warning><para>If parts of the stage are visible and you disable +clearing you might end up with visual artifacts while painting the +contents of the stage.</para></warning> + + + + + + %TRUE if the @stage should not clear itself on every repaint cycle + + + + + + Sets the stage perspective. + + + + + + A #ClutterPerspective + + + + + - - - - - + Sets whether motion events received between redraws should +be throttled or not. If motion events are throttled, those +events received by the windowing system between redraws will +be compressed so that only the last event will be propagated +to the @stage and its actors. +This function should only be used if you want to have all +the motion events delivered to your application code. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + %TRUE to throttle motion events + @@ -19364,377 +31036,145 @@ synthetised events." - + + Sets whether the @stage should honour the #ClutterActor:opacity and +the alpha channel of the #ClutterStage:color - + + + + whether the stage should honour the opacity or the alpha channel of the stage color + + + + + + Sets whether the depth cueing effect on the stage should be enabled +or not. +Depth cueing is a 3D effect that makes actors farther away from the +viewing point less opaque, by fading them with the stage color. +The parameters of the GL fog used can be changed using the +clutter_stage_set_fog() function. + + + + + + %TRUE for enabling the depth cueing effect + + + + Sets if the stage is resizable by user interaction (e.g. via +window manager controls) - + whether the stage should be user resizable. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Shows the cursor on the stage window - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + The color of the main stage. + - - + + Whether the mouse pointer should be visible + - + transfer-ownership="none"> + The settings for the GL "fog", used only if #ClutterStage:use-fog +is set to %TRUE + - - + + + The #ClutterActor that will receive key events from the underlying windowing system. -If %NULL, the #ClutterStage will receive the events."> - +If %NULL, the #ClutterStage will receive the events. + - + Whether or not the #ClutterStage should clear its contents +before each paint cycle. +See clutter_stage_set_no_clear_hint() for further information. + + + + Whether the stage should be rendered in an offscreen buffer. <warning><para>Not every backend supports redirecting the stage to an offscreen buffer. This property might not work -and it might be deprecated at any later date.</para></warning>"> - +and it might be deprecated at any later date.</para></warning> + - + transfer-ownership="none"> + The parameters used for the perspective projection from 3D +coordinates to 2D + - + transfer-ownership="none"> + The stage's title - usually displayed in stage windows title decorations. + + Whether the #ClutterStage should honour the alpha component of the #ClutterStage:color property when painting. If Clutter is run under a compositing manager this will result in the stage being blended -with the underlying window(s)"> - +with the underlying window(s) + + Whether the stage should use a linear GL "fog" in creating the depth-cueing effect, to enhance the perception of depth by fading -actors farther from the viewpoint."> - +actors farther from the viewpoint. + - + transfer-ownership="none"> + Whether the stage is resizable via user interaction. + @@ -19743,17 +31183,17 @@ actors farther from the viewpoint."> - - + + - - + + - + The ::delete-event signal is emitted when the user closes a #ClutterStage window using the window controls. Clutter by default will call clutter_main_quit() if @stage is the default stage, and clutter_actor_destroy() for any other @@ -19762,38 +31202,38 @@ It is possible to override the default behaviour by connecting a new handler and returning %TRUE there. <note>This signal is emitted only on Clutter backends that embed #ClutterStage in native windows. It is not emitted for -backends that use a static frame buffer.</note>" - version="1.2"> - - +backends that use a static frame buffer.</note> + + - - + + a #ClutterEvent of type %CLUTTER_DELETE + - - + + - - + + + The #ClutterStageClass structure contains only private data - + @@ -19805,7 +31245,7 @@ backends that use a static frame buffer.</note>" - + @@ -19817,7 +31257,7 @@ backends that use a static frame buffer.</note>" - + @@ -19829,7 +31269,7 @@ backends that use a static frame buffer.</note>" - + @@ -19841,9 +31281,9 @@ backends that use a static frame buffer.</note>" - + - + @@ -19857,45 +31297,47 @@ backends that use a static frame buffer.</note>" - + + The #ClutterStageManager structure is private. - + Returns the default #ClutterStageManager. +object is owned by Clutter and you should not reference or unreference it. + + the default stage manager instance. The returned - + Returns the default #ClutterStage. +is owned by Clutter and you should never reference or unreference it + + the default stage. The returned object - + Lists all currently used stages. +allocated list of #ClutterStage objects. Use g_slist_free() to +deallocate it when done. + + a newly @@ -19903,12 +31345,13 @@ deallocate it when done." + Lists all currently used stages. to the internal list of #ClutterStage objects. The returned list is owned by the #ClutterStageManager and should never be modified -or freed" - version="1.0"> - +or freed + + a pointer @@ -19916,47 +31359,47 @@ or freed" + Sets @stage as the default stage. + a #ClutterStage - - + + The default stage used by Clutter. + - - - + + The ::stage-added signal is emitted each time a new #ClutterStage +has been added to the stage manager. + + - - + + the added stage + - - - + + The ::stage-removed signal is emitted each time a #ClutterStage +has been removed from the stage manager. + + - - + + the removed stage + @@ -19964,14 +31407,14 @@ has been removed from the stage manager." + The #ClutterStageManagerClass structure contains only private data +and should be accessed using the provided API - + @@ -19986,7 +31429,7 @@ and should be accessed using the provided API" - + @@ -20001,14 +31444,14 @@ and should be accessed using the provided API" - + + Stage state masks + Event signalling a change in the #ClutterStage state. - + @@ -20049,90 +31492,21 @@ and should be accessed using the provided API" - - - - - - + <structname>ClutterStageWindow</structname> is an opaque structure +whose members should not be accessed directly + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + @@ -20148,39 +31522,114 @@ and should be accessed using the provided API" - + - - - + + + - - - - - - + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + glib:is-gtype-struct-for="StageWindow" + version="0.8"> + The interface implemented by backends for stage windows - - - + + + @@ -20191,7 +31640,7 @@ and should be accessed using the provided API" - + @@ -20206,7 +31655,7 @@ and should be accessed using the provided API" - + @@ -20215,13 +31664,13 @@ and should be accessed using the provided API" - + - + @@ -20230,13 +31679,13 @@ and should be accessed using the provided API" - + - + @@ -20245,15 +31694,15 @@ and should be accessed using the provided API" - + - + - + @@ -20263,7 +31712,7 @@ and should be accessed using the provided API" - + @@ -20275,7 +31724,7 @@ and should be accessed using the provided API" - + @@ -20284,13 +31733,13 @@ and should be accessed using the provided API" - + - + @@ -20302,7 +31751,7 @@ and should be accessed using the provided API" - + @@ -20311,16 +31760,16 @@ and should be accessed using the provided API" - + - + - + @@ -20335,9 +31784,9 @@ and should be accessed using the provided API" - + - + @@ -20347,7 +31796,7 @@ and should be accessed using the provided API" - + @@ -20362,9 +31811,9 @@ and should be accessed using the provided API" - + - + @@ -20374,9 +31823,9 @@ and should be accessed using the provided API" - + - + @@ -20386,103 +31835,1529 @@ and should be accessed using the provided API" + + + + + + + + The <structname>ClutterState</structname> structure contains only +private data and should be accessed using the provided API + + + Creates a new #ClutterState + + the newly create #ClutterState instance + + + + + Retrieves the #ClutterAnimator that is being used for transitioning +between the two states, if any has been set + + a #ClutterAnimator instance, or %NULL + + + + + the name of a source state + + + + the name of a target state + + + + + + Queries the duration used for transitions between a source and +target state pair +The semantics for the query are the same as the semantics used for +setting the duration with clutter_state_set_duration() + + the duration, in milliseconds + + + + + the name of the source state to get the duration of, or %NULL + + + + the name of the source state to get the duration of, or %NULL + + + + + + Returns a list of pointers to opaque structures with accessor functions +that describe the keys added to an animator. +newly allocated #GList of #ClutterStateKey<!-- -->s. The contents of +the returned list are owned by the #ClutterState and should not be +modified or freed. Use g_list_free() to free the resources allocated +by the returned list when done using it + + a + + + + + + + the source transition name to query, or %NULL for all source states + + + + the target transition name to query, or %NULL for all target states + + + + the specific object instance to list keys for, or %NULL for all managed objects + + + + the property name to search for, or %NULL for all properties. + + + + + + Queries the currently set target state. +During a transition this function will return the target of the transition. +This function is useful when called from handlers of the +#ClutterState::completed signal. +is owned by the #ClutterState and should not be modified or freed + + a string containing the target state. The returned string + + + + + Gets a list of all the state names managed by this #ClutterState. +#GList of state names. The contents of the returned #GList are owned +by the #ClutterState and should not be modified or freed. Use +g_list_free() to free the resources allocated by the returned list when +done using it + + a newly allocated + + + + + + + Gets the timeline driving the #ClutterState +the state change animations. The returned timeline is owned +by the #ClutterState and it should not be unreferenced directly + + the #ClutterTimeline that drives + + + + + Removes all keys matching the search criteria passed in arguments. + + + + + + the source state name to query, or %NULL for all source states + + + + the target state name to query, or %NULL for all target states + + + + the specific object instance to list keys for, or %NULL for all managed objects + + + + the property name to search for, or %NULL for all properties. + + + + + + Adds multiple keys to a named state of a #ClutterState instance, specifying +the easing mode and value a given property of an object should have at a +given progress of the animation. +The mode specified is the easing mode used when going to from the previous +key to the specified key. +For instance, the code below: +|[ +clutter_state_set (state, NULL, "hover", +button, "opacity", 255, CLUTTER_LINEAR, +button, "scale-x", 1.2, CLUTTER_EASE_OUT_CUBIC, +button, "scale-y", 1.2, CLUTTER_EASE_OUT_CUBIC, +NULL); +]| +will create a transition from any state (a @source_state_name of NULL is +treated as a wildcard) and a state named "hover"; the +<emphasis>button</emphasis> object will have the #ClutterActor:opacity +property animated to a value of 255 using %CLUTTER_LINEAR as the animation +mode, and the #ClutterActor:scale-x and #ClutterActor:scale-y properties +animated to a value of 1.2 using %CLUTTER_EASE_OUT_CUBIC as the animation +mode. To change the state (and start the transition) you can use the +clutter_state_change() function: +|[ +clutter_state_change (state, "hover", TRUE); +]| +If a given object, state_name, property tuple already exist in the +#ClutterState instance, then the mode and value will be replaced with +the new specified values. +If a property name is prefixed with "delayed::" two additional +to pause before transitioning and a similar value to pause after +transitioning, e.g.: +|[ +clutter_state_set (state, "hover", "toggled", +button, "delayed::scale-x", 1.0, 0.2, 0.2, +button, "delayed::scale-y", 1.0, 0.2, 0.2, +NULL); +]| +will pause for 20% of the duration of the transition before animating, +and 20% of the duration after animating. + + + + + + the name of the source state keys are being added for + + + + the name of the target state keys are being added for + + + + a #GObject + + + + a property of @first_object to specify a key for + + + + the id of the alpha function to use + + + + + + + + + + Specifies a #ClutterAnimator to be used when transitioning between +the two named states. +The @animator allows specifying a transition between the state that is +more elaborate than the basic transitions allowed by the tweening of +properties defined in the #ClutterState keys. +If @animator is %NULL it will unset an existing animator. +#ClutterState will take a reference on the passed @animator, if any + + + + + + the name of a source state + + + + the name of a target state + + + + a #ClutterAnimator instance, or %NULL to unset an existing #ClutterAnimator + + + + + + Sets the duration of a transition. +If both state names are %NULL the default duration for @state is set. +If only @target_state_name is specified, the passed @duration becomes +the default duration for transitions to the target state. +If both states names are specified, the passed @duration only applies +to the specified transition. + + + + + + the name of the source state, or %NULL + + + + the name of the target state, or %NULL + + + + the duration of the transition, in milliseconds + + + + + + Sets one specific end key for a state_name, object, property_name +combination. +chaining of multiple calls + + the #ClutterState instance, allowing + + + + + the source transition to specify transition for or NULL to specify the default fallback when a more specific source_state doesn't exist. + + + + the name of the transition to set a key value for. + + + + the #GObject to set a key for + + + + the property to set a key for + + + + the id of the alpha function to use + + + + the value for property_name of object in state_name + + + + relative time of the transition to be idle in the beginning of the transition + + + + relative time of the transition to be idle in the end of the transition + + + + + + Change the current state of #ClutterState to @target_state_name +The state will animate during its transition, see +#clutter_state_warp_to_state for animation-free state switching. +state transition. The returned timeline is owned by the #ClutterState +and it should not be unreferenced + + the #ClutterTimeline that drives the + + + + + the state to transition to + + + + + + Change the current state of #ClutterState to @target_state_name +Change to the specified target state immediately with no animation. +state transition. The returned timeline is owned by the #ClutterState +and it should not be unreferenced + + the #ClutterTimeline that drives the + + + + + the state to transition to + + + + + + Default duration used if an duration has not been specified for a specific +source/target state pair. The values is in milliseconds. + + + + The currently set target state, setting it causes the +state machine to transition to the new state, use +clutter_state_change() with a final FALSE argument to +change state without a transition. + + + + + + + + + + The ::completed signal is emitted when a #ClutterState reaches +the target state specified by clutter_state_change() + + + + + + + The <structname>ClutterStateClass</structname> structure contains +only private data + + + + + + + + + + + + + + + + + + + + + + + <structname>ClutterStateKey</structname> is an opaque structure whose +members cannot be accessed directly + + Retrieves the easing mode used for @state_key. + + the mode of a #ClutterStateKey + + + + + Retrieves the object instance this #ClutterStateKey applies to. + + the object this state key applies to. + + + + + Retrieves the duration of the pause after transitioning is complete +as a fraction of the total transition time. + + the post delay, used after doing the transition. + + + + + Retrieves the pause before transitioning starts as a fraction of +the total transition time. + + the pre delay used before starting the transition. + + + + + Retrieves the name of the property this #ClutterStateKey applies to +by the #ClutterStateKey and should never be modified or freed + + the name of the property. The returned string is owned + + + + + Retrieves the #GType of the property a key applies to +You can use this type to initialize the #GValue to pass to +clutter_state_key_get_value() + + the #GType of the property + + + + + Retrieves the name of the source state of the @state_key +if this is the generic state key for the given property when +transitioning to the target state. The returned string is owned +by the #ClutterStateKey and should never be modified or freed + + the name of the source state for this key, or %NULL + + + + + Get the name of the source state this #ClutterStateKey contains, +or NULL if this is the generic state key for the given property +when transitioning to the target state. +the key is generic + + the name of the source state for this key, or NULL if + + + + + Retrieves a copy of the value for a #ClutterStateKey. +The #GValue needs to be already initialized for the value type +of the property or to a type that allow transformation from the value +type of the key. +Use g_value_unset() when done. +and %FALSE otherwise + + %TRUE if the value was successfully retrieved, + + + + + a #GValue initialized with the correct type for the @state_key + + + + + + + - + + + + + + + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + + + The alignment policies available on each axis of the #ClutterTableLayout + + + + + + The #ClutterTableLayout structure contains only private data +and should be accessed using the provided API + + Creates a new #ClutterTableLayout layout manager + + the newly created #ClutterTableLayout + + + + + Retrieves the horizontal and vertical alignment policies for @actor +as set using clutter_table_layout_pack() or +clutter_table_layout_set_alignment(). + + + + + + a #ClutterActor child of @layout + + + + return location for the horizontal alignment policy + + + + return location for the vertical alignment policy + + + + + + Retrieve the current number of columns in @layout + + the number of columns + + + + + Retrieves the spacing set using clutter_table_layout_set_column_spacing() + + the spacing between columns of the #ClutterTableLayout + + + + + Retrieves the duration set using clutter_table_layout_set_easing_duration() + + the duration of the animations, in milliseconds + + + + + Retrieves the easing mode set using clutter_table_layout_set_easing_mode() + + an easing mode + + + + + Retrieves the horizontal and vertical expand policies for @actor +as set using clutter_table_layout_pack() or clutter_table_layout_set_expand() + + + + + + a #ClutterActor child of @layout + + + + return location for the horizontal expand policy + + + + return location for the vertical expand policy + + + + + + Retrieves the horizontal and vertical fill policies for @actor +as set using clutter_table_layout_pack() or clutter_table_layout_set_fill() + + + + + + a #ClutterActor child of @layout + + + + return location for the horizontal fill policy + + + + return location for the vertical fill policy + + + + + + Retrieve the current number rows in the @layout + + the number of rows + + + + + Retrieves the spacing set using clutter_table_layout_set_row_spacing() + + the spacing between rows of the #ClutterTableLayout + + + + + Retrieves the row and column span for @actor as set using +clutter_table_layout_pack() or clutter_table_layout_set_span() + + + + + + a #ClutterActor child of @layout + + + + return location for the col span + + + + return location for the row span + + + + + + Retrieves whether @layout should animate changes in the layout properties +Since clutter_table_layout_set_use_animations() + + %TRUE if the animations should be used, %FALSE otherwise + + + + + Packs @actor inside the #ClutterContainer associated to @layout +at the given row and column. + + + + + + a #ClutterActor + + + + the column the @actor should be put, or -1 to append + + + + the row the @actor should be put, or -1 to append + + + + + + Sets the horizontal and vertical alignment policies for @actor +inside @layout + + + + + + a #ClutterActor child of @layout + + + + Horizontal alignment policy for @actor + + + + Vertical alignment policy for @actor + + + + + + Sets the spacing between columns of @layout + + + + + + the spacing between columns of the layout, in pixels + + + + + + Sets the duration of the animations used by @layout when animating changes +in the layout properties +Use clutter_table_layout_set_use_animations() to enable and disable the +animations + + + + + + the duration of the animations, in milliseconds + + + + + + Sets the easing mode to be used by @layout when animating changes in layout +properties +Use clutter_table_layout_set_use_animations() to enable and disable the +animations + + + + + + an easing mode, either from #ClutterAnimationMode or a logical id from clutter_alpha_register_func() + + + + + + Sets the horizontal and vertical expand policies for @actor +inside @layout + + + + + + a #ClutterActor child of @layout + + + + whether @actor should allocate extra space horizontally + + + + whether @actor should allocate extra space vertically + + + + + + Sets the horizontal and vertical fill policies for @actor +inside @layout + + + + + + a #ClutterActor child of @layout + + + + whether @actor should fill horizontally the allocated space + + + + whether @actor should fill vertically the allocated space + + + + + + Sets the spacing between rows of @layout + + + + + + the spacing between rows of the layout, in pixels + + + + + + Sets the row and column span for @actor +inside @layout + + + + + + a #ClutterActor child of @layout + + + + Column span for @actor + + + + Row span for @actor + + + + + + Sets whether @layout should animate changes in the layout properties +The duration of the animations is controlled by +clutter_table_layout_set_easing_duration(); the easing mode to be used +by the animations is controlled by clutter_table_layout_set_easing_mode() + + + + + + %TRUE if the @layout should use animations + + + + + + The spacing between columns of the #ClutterTableLayout, in pixels + + + + The duration of the animations, in case #ClutterTableLayout:use-animations +is set to %TRUE +The duration is expressed in milliseconds + + + + The easing mode for the animations, in case +#ClutterTableLayout:use-animations is set to %TRUE +either be a value from the #ClutterAnimationMode enumeration, like +%CLUTTER_EASE_OUT_CUBIC, or a logical id as returned by +clutter_alpha_register_func() +The default value is %CLUTTER_EASE_OUT_CUBIC + + + + The spacing between rows of the #ClutterTableLayout, in pixels + + + + Whether the #ClutterTableLayout should animate changes in the +layout properties + + + + + + + + + + + The #ClutterTableLayoutClass structure contains only private +data and should be accessed using the provided API + + + + + + - + + + + - + - + + + + - + + The #ClutterText struct contains only private data. + + - - - + + Creates a new #ClutterText actor. This actor can be used to +display and edit text. + + the newly created #ClutterText actor + + Creates a new #ClutterText actor, using @font_name as the font description; @text will be used to set the contents of the actor; and @color will be used as the color to render @text. This function is equivalent to calling clutter_text_new(), clutter_text_set_font_name(), clutter_text_set_text() and -clutter_text_set_color()." - version="1.0"> - - +clutter_text_set_color(). + + the newly created #ClutterText actor + + a string with a font description + the contents of the actor + the color to be used to render @text + Creates a new #ClutterText actor, using @font_name as the font description; @text will be used to set the contents of the actor. This function is equivalent to calling clutter_text_new(), -clutter_text_set_font_name(), and clutter_text_set_text()." - version="1.0"> - - +clutter_text_set_font_name(), and clutter_text_set_text(). + + the newly created #ClutterText actor + + a string with a font description + the contents of the actor + + Emits the #ClutterText::activate signal, if @self has been set +as activatable using clutter_text_set_activatable(). +This function can be used to emit the ::activate signal inside +a #ClutterActor::captured-event or #ClutterActor::key-press-event +signal handlers before the default signal handler for the +#ClutterText is invoked. +and %FALSE otherwise + + %TRUE if the ::activate signal has been emitted, + + + + + Deletes @n_chars inside a #ClutterText actor, starting from the +current cursor position. + + + + + + the number of characters to delete + + + + + + Deletes the currently selected text +This function is only useful in subclasses of #ClutterText +is empty, and %FALSE otherwise + + %TRUE if text was deleted or if the text actor + + + + + Deletes the text inside a #ClutterText actor between @start_pos +and @end_pos. +The starting and ending positions are expressed in characters, +not in bytes. + + + + + + starting position + + + + ending position + + + + + + Retrieves whether a #ClutterText is activatable or not. + + %TRUE if the actor is activatable + + + + + Gets the attribute list that was set on the #ClutterText actor +clutter_text_set_attributes(), if any. +returned value is owned by the #ClutterText and should not be unreferenced. + + the attribute list, or %NULL if none was set. The + + + + + Retrieves the contents of the #ClutterText actor between +The positions are specified in characters, not in bytes. +the text actor between the specified positions. Use g_free() +to free the resources when done + + a newly allocated string with the contents of + + + + + start of text, in characters + + + + end of text, in characters + + + + + + Retrieves the text color as set by clutter_text_set_color(). + + + + + + return location for a #ClutterColor + + + + + + Retrieves the color of the cursor of a #ClutterText actor. + + + + + + return location for a #ClutterColor + + + + + + Retrieves the cursor position. + + the cursor position, in characters + + + + + Retrieves the size of the cursor of a #ClutterText actor. + + the size of the cursor, in pixels + + + + + Retrieves whether the cursor of a #ClutterText actor is visible. + + %TRUE if the cursor is visible + + + + + Retrieves whether a #ClutterText is editable or not. + + %TRUE if the actor is editable + + + + + Returns the ellipsizing position of a #ClutterText actor, as +set by clutter_text_set_ellipsize(). + + #PangoEllipsizeMode + + + + + Retrieves the #PangoFontDescription used by @self +by the #ClutterText actor and it should not be modified or freed + + a #PangoFontDescription. The returned value is owned + + + + + Retrieves the font name as set by clutter_text_set_font_name(). +string is owned by the #ClutterText actor and should not be +modified or freed + + a string containing the font name. The returned + + + + + Retrieves whether the #ClutterText actor should justify its contents +on both margins. + + %TRUE if the text should be justified + + + + + Retrieves the current #PangoLayout used by a #ClutterText actor. +the #ClutterText actor and should not be modified or freed + + a #PangoLayout. The returned object is owned by + + + + + Retrieves the alignment of a #ClutterText, as set by +clutter_text_set_line_alignment(). + + a #PangoAlignment + + + + + Retrieves the value set using clutter_text_set_line_wrap(). +its contents + + %TRUE if the #ClutterText actor should wrap + + + + + Retrieves the line wrap mode used by the #ClutterText actor. +See clutter_text_set_line_wrap_mode (). + + the wrap mode used by the #ClutterText + + + + + Gets the maximum length of text that can be set into a text actor. +See clutter_text_set_max_length(). + + the maximum number of characters. + + + + + Retrieves the character to use in place of the actual text +as set by clutter_text_set_password_char(). +character is not set + + a Unicode character or 0 if the password + + + + + Retrieves whether a #ClutterText is selectable or not. + + %TRUE if the actor is selectable + + + + + Retrieves the currently selected text. +selected text, or %NULL. Use g_free() to free the returned +string. + + a newly allocated string containing the currently + + + + + Retrieves the other end of the selection of a #ClutterText actor, +in characters from the current cursor position. + + the position of the other end of the selection + + + + + Retrieves the color of the selection of a #ClutterText actor. + + + + + + return location for a #ClutterColor + + + + + + Retrieves whether the #ClutterText actor is in single line mode. + + %TRUE if the #ClutterText actor is in single line mode + + + + Retrieves a pointer to the current contents of a #ClutterText actor. If you need a copy of the contents for manipulating, either use g_strdup() on the returned string, or use: @@ -20491,727 +33366,513 @@ copy = clutter_text_get_chars (text, 0, -1); ]| Which will return a newly allocated string. is owned by the #ClutterText actor and should never be -modified or freed" - version="1.0"> +modified or freed + the contents of the actor. The returned string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieves whether the contents of the #ClutterText actor should be +parsed for the Pango text markup. - + %TRUE if the contents will be parsed for markup + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Inserts @text into a #ClutterActor at the given position. If @position is a negative number, the text will be appended at the end of the current contents of the #ClutterText. -The position is expressed in characters, not in bytes." - version="1.0"> +The position is expressed in characters, not in bytes. + the text to be inserted - + the position of the insertion, or -1 + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Inserts @wc at the current cursor position of a +#ClutterText actor. - + a Unicode character + - - - + Retrieves the coordinates of the given @position. + + %TRUE if the conversion was successful + + + + position in characters + + + + return location for the X coordinate, or %NULL + + + + return location for the Y coordinate, or %NULL + + + + return location for the line height, or %NULL + + + - + Sets whether a #ClutterText actor should be activatable. +An activatable #ClutterText actor will emit the #ClutterText::activate +signal whenever the 'Enter' (or 'Return') key is pressed; if it is not +activatable, a new line will be appended to the current content. +An activatable #ClutterText must also be set as editable using +clutter_text_set_editable(). - - + + whether the #ClutterText actor should be activatable + - + Sets the attributes list that are going to be applied to the +#ClutterText contents. +The #ClutterText actor will take a reference on the #PangoAttrList +passed to this function. - + + + + a #PangoAttrList or %NULL to unset the attributes + + + + + + Sets the color of the contents of a #ClutterText actor. +The overall opacity of the #ClutterText actor will be the +result of the alpha value of @color and the composited +opacity of the actor itself on the scenegraph, as returned +by clutter_actor_get_paint_opacity(). + + + + + + a #ClutterColor + + + + + + Sets the color of the cursor of a #ClutterText actor. +If @color is %NULL, the cursor color will be the same as the +text color. + + + + + + the color of the cursor, or %NULL to unset it + + + + + + Sets the cursor of a #ClutterText actor at @position. +The position is expressed in characters, not in bytes. + + + + + + the new cursor position, in characters + + + + + + Sets the size of the cursor of a #ClutterText. The cursor +will only be visible if the #ClutterText:cursor-visible property +is set to %TRUE. + + + + + + the size of the cursor, in pixels, or -1 to use the default value + + + + + + Sets whether the cursor of a #ClutterText actor should be +visible or not. +The color of the cursor will be the same as the text color +unless clutter_text_set_cursor_color() has been called. +The size of the cursor can be set using clutter_text_set_cursor_size(). +The position of the cursor can be changed programmatically using +clutter_text_set_cursor_position(). + + + + + + whether the cursor should be visible + + + + + + Sets whether the #ClutterText actor should be editable. +An editable #ClutterText with key focus set using +clutter_actor_grab_key_focus() or clutter_stage_take_key_focus() +will receive key events and will update its contents accordingly. + + + + + + whether the #ClutterText should be editable + + + + + + text if there is not enough space to render the entire contents +of a #ClutterText actor + + + + + + a #PangoEllipsizeMode + + + + + + Sets @font_desc as the font description for a #ClutterText +The #PangoFontDescription is copied by the #ClutterText actor +so you can safely call pango_font_description_free() on it after +calling this function. + + + + + + a #PangoFontDescription + + + + + + Sets the font used by a #ClutterText. The @font_name string +must either be %NULL, which means that the font name from the +default #ClutterBackend will be used; or be something that can +be parsed by the pango_font_description_from_string() function, +like: +|[ +clutter_text_set_font_name (text, "Sans 10pt"); +clutter_text_set_font_name (text, "Serif 16px"); +clutter_text_set_font_name (text, "Helvetica 10"); +]| + + + + + + a font name, or %NULL to set the default font name + + + + + + Sets whether the text of the #ClutterText actor should be justified +on both margins. This setting is ignored if Clutter is compiled +against Pango &lt; 1.18. + + + + + + whether the text should be justified + + + + + + Sets the way that the lines of a wrapped label are aligned with +respect to each other. This does not affect the overall alignment +of the label within its allocated or specified width. +To align a #ClutterText actor you should add it to a container +that supports alignment, or use the anchor point. + + + + + + A #PangoAlignment + + + + + + Sets whether the contents of a #ClutterText actor should wrap, +if they don't fit the size assigned to the actor. + + + + + + whether the contents should wrap + + + + + + If line wrapping is enabled (see clutter_text_set_line_wrap()) this +function controls how the line wrapping is performed. The default is +%PANGO_WRAP_WORD which means wrap on word boundaries. + + + + + + the line wrapping mode + + + + + + Sets @markup as the contents of a #ClutterText. +This is a convenience function for setting a string containing +Pango markup, and it is logically equivalent to: +|[ +clutter_text_set_text (CLUTTER_TEXT (actor), markup); +clutter_text_set_use_markup (CLUTTER_TEXT (actor), TRUE); +]| + + + + + + a string containing Pango markup. Passing %NULL is the same as passing "" (the empty string) + + + + + + Sets the maximum allowed length of the contents of the actor. If the +current contents are longer than the given length, then they will be +truncated to fit. + + + + + + the maximum number of characters allowed in the text actor; 0 to disable or -1 to set the length of the current string + + + + + + Sets the character to use in place of the actual text in a +password text actor. +If @wc is 0 the text will be displayed as it is entered in the +#ClutterText actor. + + + + + + a Unicode character, or 0 to unset the password character + + + + + + Sets, or unsets, the pre-edit string. This function is useful +for input methods to display a string (with eventual specific +Pango attributes) before it is entered inside the #ClutterText +buffer. +The preedit string and attributes are ignored if the #ClutterText +actor is not editable. +This function should not be used by applications + + + + + + the pre-edit string, or %NULL to unset it + + + + the pre-edit string attributes + + + + the cursor position for the pre-edit string + + + + + + Sets whether a #ClutterText actor should be selectable. +A selectable #ClutterText will allow selecting its contents using +the pointer or the keyboard. + + + + + + whether the #ClutterText actor should be selectable + + + + + + Selects the region of text between @start_pos and @end_pos. +This function changes the position of the cursor to match + + + + + + start of the selection, in characters + + + + end of the selection, in characters + + + + + + Sets the other end of the selection, starting from the current +cursor position. +If @selection_bound is -1, the selection unset. + + + + + + the position of the end of the selection, in characters + + + + + + Sets the color of the selection of a #ClutterText actor. +If @color is %NULL, the selection color will be the same as the +cursor color, or if no cursor color is set either then it will be +the same as the text color. + + + + + + the color of the selection, or %NULL to unset it + + + + Sets whether a #ClutterText actor should be in single line mode +or not. Only editable #ClutterText<!-- -->s can be in single line +mode. A text actor in single line mode will not wrap text and will clip the the visible area to the predefined size. The contents of the text actor will scroll to display the end of the text if its length @@ -21219,268 +33880,253 @@ is bigger than the allocated width. When setting the single line mode the #ClutterText:activatable property is also set as a side effect. Instead of entering a new line character, the text actor will emit the #ClutterText::activate -signal." - version="1.0"> +signal. - + whether to enable single line mode + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Sets the contents of a #ClutterText actor. +If the #ClutterText:use-markup property was set to %TRUE it +will be reset to %FALSE as a side effect. If you want to +maintain the #ClutterText:use-markup you should use the +clutter_text_set_markup() function instead - + + the text to set. Passing %NULL is the same as passing "" (the empty string) - - - - - + + + + Sets whether the contents of the #ClutterText actor contains markup +in <link linkend="PangoMarkupFormat">Pango's text markup language</link>. +Setting #ClutterText:use-markup on an editable #ClutterText will +not have any effect except hiding the markup. +See also #ClutterText:use-markup. + + + + + + %TRUE if the text should be parsed for markup. + - + transfer-ownership="none"> + Toggles whether return invokes the activate signal or not. + - + transfer-ownership="none"> + A list of #PangoStyleAttribute<!-- -->s to be applied to the +contents of the #ClutterText actor. + - + transfer-ownership="none"> + The color used to render the text. + - + transfer-ownership="none"> + The color of the cursor. + - + transfer-ownership="none"> + Will be set to %TRUE if #ClutterText:cursor-color has been set. + - + transfer-ownership="none"> + The size of the cursor, in pixels. If set to -1 the size used will +be the default cursor size of 2 pixels. + + Whether the input cursor is visible or not, it will only be visible if both #ClutterText:cursor-visible and #ClutterText:editable are -set to %TRUE."> - +set to %TRUE. + - + transfer-ownership="none"> + Whether key events delivered to the actor causes editing. + - + transfer-ownership="none"> + The preferred place to ellipsize the contents of the #ClutterText actor + + The #PangoFontDescription that should be used by the #ClutterText If you have a string describing the font then you should look at -#ClutterText:font-name instead"> - +#ClutterText:font-name instead + - + transfer-ownership="none"> + The font to be used by the #ClutterText, as a string +that can be parsed by pango_font_description_from_string(). +If set to %NULL, the default system font will be used instead. + - + transfer-ownership="none"> + Whether the contents of the #ClutterText should be justified +on both margins. + - + transfer-ownership="none"> + The preferred alignment for the text. This property controls +the alignment of multi-line paragraphs. + + Whether to wrap the lines of #ClutterText:text if the contents exceed the available allocation. The wrapping strategy is -controlled by the #ClutterText:line-wrap-mode property."> - +controlled by the #ClutterText:line-wrap-mode property. + - + transfer-ownership="none"> + If #ClutterText:line-wrap is set to %TRUE, this property will +control how the text is wrapped. + - + transfer-ownership="none"> + The maximum length of the contents of the #ClutterText actor. + - + transfer-ownership="none"> + If non-zero, the character that should be used in place of +the actual text in a password text actor. + - + transfer-ownership="none"> + The current input cursor position. -1 is taken to be the end of the text + - + transfer-ownership="none"> + Whether it is possible to select text, either using the pointer +or the keyboard. + - + transfer-ownership="none"> + The current input cursor position. -1 is taken to be the end of the text + - + transfer-ownership="none"> + The color of the selection. + - + transfer-ownership="none"> + Will be set to %TRUE if #ClutterText:selection-color has been set. + + Whether the #ClutterText actor should be in single line mode or not. A single line #ClutterText actor will only contain a single line of text, scrolling it in case its length is bigger than the allocated size. Setting this property will also set the #ClutterText:activatable -property as a side-effect."> - +property as a side-effect. +The #ClutterText:single-line-mode property is used only if the +#ClutterText:editable property is set to %TRUE. + - + transfer-ownership="none"> + The text to render inside the actor. + - + transfer-ownership="none"> + Whether the text includes Pango markup. +For more informations about the Pango markup format, see +pango_layout_set_markup() in the Pango documentation. +<note>It is not possible to round-trip this property between +%TRUE and %FALSE. Once a string with markup has been set on +a #ClutterText actor with :use-markup set to %TRUE, the markup +is stripped from the string.</note> + @@ -21489,82 +34135,80 @@ in the Pango documentation."> - - + + - + The ::cursor-event signal is emitted whenever the cursor position changes inside a #ClutterText actor. Inside @geometry it is stored the current position and size of the cursor, relative to the actor -itself." - version="1.0"> - - +itself. + + - - + + the coordinates of the cursor + - - - + + This signal is emitted when text is deleted from the actor by +the user. It is emitted before @self text changes. + + - - + + the starting position + - - + + the end position + - - - + + This signal is emitted when text is inserted into the actor by +the user. It is emitted before @self text changes. + + - - + + the new text to insert + - - + + the length of the new text, in bytes, or -1 if new_text is nul-terminated + - - + + the position, in characters, at which to insert the new text. this is an in-out parameter. After the signal emission is finished, it should point after the newly inserted text. + - - - + + The ::text-changed signal is emitted after @actor's text changes + + + The #ClutterTextClass struct contains only private data. - + @@ -21576,7 +34220,7 @@ the user. It is emitted before @self text changes." - + @@ -21588,7 +34232,7 @@ the user. It is emitted before @self text changes." - + @@ -21602,57 +34246,57 @@ the user. It is emitted before @self text changes." - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -21660,11 +34304,11 @@ the user. It is emitted before @self text changes." + The text direction to be used by #ClutterActor<!-- -->s - + + The #ClutterTexture structure contains only private data +and should be accessed using the provided API + + - - - + + Creates a new empty #ClutterTexture object. + + A newly created #ClutterTexture object. + - - - - - - - - - - + Creates a new #ClutterTexture object with its source a prexisting actor (and associated children). The textures content will contain -'live' redirected output of the actors scene. +'live' redirected output of the actors scene. Note this function is intented as a utility call for uniformly applying shaders to groups and other potential visual effects. It requires that the %CLUTTER_FEATURE_OFFSCREEN feature is supported by the current backend @@ -21744,7 +34375,7 @@ adding it to a container.</para> <listitem> <para>When getting the image for the clone texture, Clutter will attempt to render the source actor exactly as it would -appear if it was rendered on screen. The source actor's parent +appear if it was rendered on screen. The source actor's parent transformations are taken into account. Therefore if your source actor is rotated along the X or Y axes so that it has some depth, the texture will appear differently depending on @@ -21780,145 +34411,40 @@ and end redirection.</para> clutter_texture_get_cogl_texture() can be used to read the offscreen texture pixels into a pixbuf.</para> </listitem> -</itemizedlist>" - version="0.6"> - - +</itemizedlist> + + A newly created #ClutterTexture object, or %NULL on failure. + + A source #ClutterActor - + + Creates a new ClutterTexture actor to display the image contained a +file. If the image failed to load then NULL is returned and @error +is set. +error. - + A newly created #ClutterTexture object or NULL on + + The name of an image file to load. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + c:identifier="clutter_texture_get_base_size"> + Gets the size in pixels of the untransformed underlying image @@ -21926,50 +34452,216 @@ loaded or if an error occurred." - + transfer-ownership="full"> + return location for the width, or %NULL + - + transfer-ownership="full"> + return location for the height, or %NULL + - + Returns a handle to the underlying COGL material used for drawing +the actor. +material is owned by the #ClutterTexture and it should not be +unreferenced + + a handle for a #CoglMaterial. The + + + + + Retrieves the handle to the underlying COGL texture used for drawing +the actor. No extra reference is taken so if you need to keep the +handle then you should call cogl_handle_ref() on it. +The texture handle returned is the first layer of the material +handle used by the #ClutterTexture. If you need to access the other +layers you should use clutter_texture_get_cogl_material() instead +and use the #CoglMaterial API. +handle is owned by the #ClutterTexture and it should not be unreferenced + + a #CoglHandle for the texture. The returned + + + + + + + + + + Retrieves the value set using clutter_texture_set_keep_aspect_ratio() +aspect ratio of the underlying image + + %TRUE if the #ClutterTexture should maintain the + + + + + Retrieves the value set using clutter_texture_set_load_async() +disk asynchronously + + %TRUE if the #ClutterTexture should load the data from + + + + + Retrieves the value set by clutter_texture_set_load_data_async() +data from a file asynchronously + + %TRUE if the #ClutterTexture should load the image + + + + + + + + + + Retrieves the value set by clutter_texture_set_load_data_async() +using the alpha channel when picking. + + %TRUE if the #ClutterTexture should define its shape + + + + + Retrieves the pixel format used by @texture. This is +equivalent to: +|[ +handle = clutter_texture_get_pixel_format (texture); +if (handle != COGL_INVALID_HANDLE) +format = cogl_texture_get_format (handle); +]| + + a #CoglPixelFormat value + + + + + Retrieves the horizontal and vertical repeat values set +using clutter_texture_set_repeat() - - + + return location for the horizontal repeat + + + + return location for the vertical repeat + - - - + + Retrieves the value set with clutter_texture_set_sync_size() +preferred size of the underlying image data + + %TRUE if the #ClutterTexture should have the same + - - - + + Updates a sub-region of the pixel data in a #ClutterTexture. + + %TRUE on success, %FALSE on failure. + + + + Image data in RGB type colorspace. + + + + Set to TRUE if image data has an alpha channel. + + + + X coordinate of upper left corner of region to update. + + + + Y coordinate of upper left corner of region to update. + + + + Width in pixels of region to update. + + + + Height in pixels of region to update. + + + + Distance in bytes between row starts on source buffer. + + + + bytes per pixel (Currently only 3 and 4 supported, depending on @has_alpha) + + + + #ClutterTextureFlags + + + + + + Replaces the underlying Cogl material drawn by this actor with +handle is no longer needed it should be deref'd with +cogl_handle_unref. Texture data is attached to the material so +calling this function also replaces the Cogl +texture. #ClutterTexture requires that the material have a texture +layer so you should set one on the material before calling this +function. + + + + + + A CoglHandle for a material + + + @@ -21982,225 +34674,269 @@ is %CLUTTER_TEXTURE_QUALITY_MEDIUM." - - - - - - + Sets the filter quality when scaling a texture. The quality is an +enumeration currently the following values are supported: +%CLUTTER_TEXTURE_QUALITY_LOW which is fast but only uses nearest neighbour +interpolation. %CLUTTER_TEXTURE_QUALITY_MEDIUM which is computationally a +bit more expensive (bilinear interpolation), and +%CLUTTER_TEXTURE_QUALITY_HIGH which uses extra texture memory resources to +improve scaled down rendering as well (by using mipmaps). The default value +is %CLUTTER_TEXTURE_QUALITY_MEDIUM. - - + + new filter quality value + - + + Sets the #ClutterTexture image data from an image file. In case of +failure, %FALSE is returned and @error is set. +If #ClutterTexture:load-async is set to %TRUE, this function +will return as soon as possible, and the actual image loading +from disk will be performed asynchronously. #ClutterTexture::size-change +will be emitten when the size of the texture is available and +#ClutterTexture::load-finished will be emitted when the image has been +loaded or if an error occurred. - + %TRUE if the image was successfully loaded and set + - - + + The filename of the image in GLib file name encoding + - + + Sets #ClutterTexture image data. - - - - - - + %TRUE on success, %FALSE on failure. + - - + + Image data in RGBA type colorspace. + - - + + Set to TRUE if image data has an alpha channel. + + + + Width in pixels of image data. + + + + Height in pixels of image data + + + + Distance in bytes between row starts. + + + + bytes per pixel (Currently only 3 and 4 supported, depending on @has_alpha) + + + + #ClutterTextureFlags + - + + Sets a #ClutterTexture from YUV image data. If an error occurred, +%FALSE is returned and @error is set. - + %TRUE if the texture was successfully updated + - - + + Image data in YUV type colorspace. + - - + + Width in pixels of image data. + + + + Height in pixels of image data + + + + #ClutterTextureFlags + - - - - - - - - - - + Sets whether @texture should have a preferred size maintaining +the aspect ratio of the underlying image - + %TRUE to maintain aspect ratio + - - - - - + Sets whether @texture should use a worker thread to load the data from disk asynchronously. Setting @load_async to %TRUE will make clutter_texture_set_from_file() return immediately. See the #ClutterTexture:load-async property documentation, and -clutter_texture_set_load_data_async()." - version="1.0"> +clutter_texture_set_load_data_async(). - - + + %TRUE if the texture should asynchronously load data from a filename + - - - - - + Sets whether @texture should use a worker thread to load the data from disk asynchronously. Setting @load_async to %TRUE will make clutter_texture_set_from_file() block until the #ClutterTexture has determined the width and height of the image data. See the #ClutterTexture:load-async property documentation, and -clutter_texture_set_load_async()." - version="1.0"> +clutter_texture_set_load_async(). - - + + %TRUE if the texture should asynchronously load data from a filename + - + + Sets whether @texture should have it's shape defined by the alpha +channel when picking. +Be aware that this is a bit more costly than the default picking +due to the texture lookup, extra test against the alpha value and +the fact that it will also interrupt the batching of geometry done +internally. +Also there is currently no control over the threshold used to +determine what value of alpha is considered pickable, and so only +fully opaque parts of the texture will react to picking. - + + + + %TRUE if the alpha channel should affect the picking shape + + + - - + + Sets whether the @texture should repeat horizontally or +vertically when the actor size is bigger than the image size + + + + + + %TRUE if the texture should repeat horizontally + + + + %TRUE if the texture should repeat vertically + + + + + + Sets whether @texture should have the same preferred size as the +underlying image data. + + + + + + %TRUE if the texture should have the same size of the underlying image data + + + + + + - - + + - - + + - - + + The path of the file containing the image data to be displayed by +the texture. +This property is unset when using the clutter_texture_set_from_*_data() +family of functions. + - - + + - - + + + Tries to load a texture from a filename by using a local thread to perform the read operations. The initially created texture has dimensions 0x0 when the true size becomes available the #ClutterTexture::size-change signal is emitted and when the image has completed loading the @@ -22210,31 +34946,35 @@ clutter_init(), otherwise #ClutterTexture will use the main loop to load the image. The upload of the texture data on the GL pipeline is not asynchronous, as it must be performed from within the same thread that called -clutter_main()."> - +clutter_main(). + - + transfer-ownership="none"> + Like #ClutterTexture:load-async but loads the width and height +synchronously causing some blocking. + - - + + - - + + - - + + - - + + - - + + + + + @@ -22242,40 +34982,42 @@ synchronously causing some blocking."> - + The ::load-finished signal is emitted when a texture load has completed. If there was an error during loading, @error will -be set, otherwise it will be %NULL" - version="1.0"> - - +be set, otherwise it will be %NULL + + - - + + A set error, or %NULL + - - - + + The ::pixbuf-change signal is emitted each time the pixbuf +used by @texture changes. + + - + The ::size-change signal is emitted each time the size of the pixbuf used by @texture changes. The new size is given as -argument to the callback."> - - +argument to the callback. + + - - + + the width of the new texture + - - + + the height of the new texture + @@ -22283,13 +35025,13 @@ argument to the callback."> + The #ClutterTextureClass structure contains only private data - + @@ -22298,16 +35040,16 @@ argument to the callback."> - + - + - + @@ -22319,7 +35061,7 @@ argument to the callback."> - + @@ -22333,36 +35075,36 @@ argument to the callback."> - - + + - - + + - - + + - - + + - - + + @@ -22370,12 +35112,12 @@ argument to the callback."> + Error enumeration for #ClutterTexture glib:nick="bad-format"/> + Flags for clutter_texture_set_from_rgb_data() and +clutter_texture_set_from_yuv_data(). - + + Enumaration controlling the texture quality. - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + The #ClutterTimeline structure contains only private data +and should be accessed using the provided API + Creates a new #ClutterTimeline with a duration of @msecs. +g_object_unref() when done using it + the newly created #ClutterTimeline instance. Use - + Duration of the timeline in milliseconds + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Adds a named marker that will be hit when the timeline has been running for @msecs milliseconds. Markers are unique string identifiers for a given time. Once @timeline reaches attached to that time. A marker can be removed with clutter_timeline_remove_marker(). The timeline can be advanced to a marker using -clutter_timeline_advance_to_marker()." - version="0.8"> +clutter_timeline_advance_to_marker(). + the unique name for this marker - + position of the marker in milliseconds + - + + Advance timeline to the requested point. The point is given as a +time in milliseconds since the timeline started. +<note><para>The @timeline will not emit the #ClutterTimeline::new-frame +signal for the given time. The first ::new-frame signal after the call to +clutter_timeline_advance() will be emit the skipped markers. +</para></note> - - - - - - - - - - - - - - - - - - - - - - - - - - + Time to advance to + + Advances @timeline to the time of the given @marker_name. <note><para>Like clutter_timeline_advance(), this function will not emit the #ClutterTimeline::new-frame for the time where @marker_name -is set, nor it will emit #ClutterTimeline::marker-reached for" - version="0.8"> +is set, nor it will emit #ClutterTimeline::marker-reached for + the name of the marker + + Create a new #ClutterTimeline instance which has property values +matching that of supplied timeline. The cloned timeline will not +be started and will not be positioned to the current position of +from @timeline + + a new #ClutterTimeline, cloned + + + @@ -23001,31 +35538,257 @@ is set, nor it will emit #ClutterTimeline::marker-reached for" + + Retrieves the delay set using clutter_timeline_set_delay(). + + the delay in milliseconds. + + + + + Retrieves the amount of time elapsed since the last +ClutterTimeline::new-frame signal. +This function is only useful inside handlers for the ::new-frame +signal, and its behaviour is undefined if the timeline is not +playing. +last frame + + the amount of time in milliseconds elapsed since the + + + + + Retrieves the direction of the timeline set with +clutter_timeline_set_direction(). + + the direction of the timeline + + + + + Retrieves the duration of a #ClutterTimeline in milliseconds. +See clutter_timeline_set_duration(). + + the duration of the timeline, in milliseconds. + + + + + Request the current time position of the timeline. + + current elapsed time in milliseconds. + + + + + Gets whether @timeline is looping + + %TRUE if the timeline is looping + + + + + The position of the timeline in a [0, 1] interval. + + the position of the timeline. + + + + + Checks whether @timeline has a marker set with the given name. + + %TRUE if the marker was found + + + + + the name of the marker + + + + + + Queries state of a #ClutterTimeline. + + %TRUE if timeline is currently playing + + + + + Retrieves the list of markers at time @msecs. If @frame_num is a +negative integer, all the markers attached to @timeline will be +returned. +a newly allocated, %NULL terminated string array containing the names +of the markers. Use g_strfreev() when done. + + + + + + + + the time to check, or -1 + + + + the number of markers returned + + + + + + Pauses the #ClutterTimeline on current frame + + + + + + Removes @marker_name, if found, from @timeline. + + + + + + the name of the marker to remove + + + + + + Rewinds #ClutterTimeline to the first frame if its direction is +%CLUTTER_TIMELINE_FORWARD and the last frame if it is +%CLUTTER_TIMELINE_BACKWARD. + + + + + + Sets the delay, in milliseconds, before @timeline should start. + + + + + + delay in milliseconds + + + + + + Sets the direction of @timeline, either %CLUTTER_TIMELINE_FORWARD or +%CLUTTER_TIMELINE_BACKWARD. + + + + + + the direction of the timeline + + + + + + Sets the duration of the timeline, in milliseconds. The speed +of the timeline depends on the ClutterTimeline:fps setting. + + + + + + duration of the timeline in milliseconds + + + + + + Sets whether @timeline should loop. + + + + + + %TRUE for enable looping + + + + + + Advance timeline by the requested time in milliseconds + + + + + + Amount of time to skip + + + + + + Starts the #ClutterTimeline playing. + + + + + + Stops the #ClutterTimeline and moves to frame 0 + + + + - + transfer-ownership="none"> + A delay, in milliseconds, that should be observed by the +timeline before actually starting. + - + transfer-ownership="none"> + The direction of the timeline, either %CLUTTER_TIMELINE_FORWARD or +%CLUTTER_TIMELINE_BACKWARD. + - + transfer-ownership="none"> + Duration of the timeline in milliseconds, depending on the +ClutterTimeline:fps value. + - - + + Whether the timeline should automatically rewind and restart. + @@ -23033,85 +35796,87 @@ ClutterTimeline:fps value."> - - - + + The ::completed signal is emitted when the timeline reaches the +number of frames specified by the ClutterTimeline:num-frames property. + + - + The ::marker-reached signal is emitted each time a timeline reaches a marker set with clutter_timeline_add_marker_at_time(). This signal is detailed with the name of the marker as well, so it is possible to connect a callback to the ::marker-reached signal for a specific marker with: <informalexample><programlisting> -clutter_timeline_add_marker_at_time (timeline, "foo", 500); -clutter_timeline_add_marker_at_time (timeline, "bar", 750); -g_signal_connect (timeline, "marker-reached", +clutter_timeline_add_marker_at_time (timeline, "foo", 500); +clutter_timeline_add_marker_at_time (timeline, "bar", 750); +g_signal_connect (timeline, "marker-reached", G_CALLBACK (each_marker_reached), NULL); -g_signal_connect (timeline, "marker-reached::foo", +g_signal_connect (timeline, "marker-reached::foo", G_CALLBACK (foo_marker_reached), NULL); -g_signal_connect (timeline, "marker-reached::bar", +g_signal_connect (timeline, "marker-reached::bar", G_CALLBACK (bar_marker_reached), NULL); </programlisting></informalexample> In the example, the first callback will be invoked for both -the "foo" and "bar" marker, while the second and third callbacks -will be invoked for the "foo" or "bar" markers, respectively." - version="0.8"> - - +the "foo" and "bar" marker, while the second and third callbacks +will be invoked for the "foo" or "bar" markers, respectively. + + - - + + the name of the marker reached + - - + + the elapsed time + - + The ::new-frame signal is emitted for each timeline running timeline before a new frame is drawn to give animations a chance -to update the scene."> - - +to update the scene. + + - - + + the elapsed time between 0 and duration + - - - + + The ::paused signal is emitted when clutter_timeline_pause() is invoked. + + - + The ::started signal is emitted when the timeline starts its run. This might be as soon as clutter_timeline_start() is invoked or after the delay set in the ClutterTimeline:delay property has -expired."> - - +expired. + + + The #ClutterTimelineClass structure contains only private data - + @@ -23123,7 +35888,7 @@ expired."> - + @@ -23135,7 +35900,7 @@ expired."> - + @@ -23147,7 +35912,7 @@ expired."> - + @@ -23156,13 +35921,13 @@ expired."> - + - + @@ -23174,41 +35939,41 @@ expired."> - + - - + + - - + + - - + + - - + + - - + + @@ -23216,11 +35981,11 @@ expired."> + The direction of a #ClutterTimeline c:identifier="CLUTTER_TIMELINE_BACKWARD" glib:nick="backward"/> - + - - - - - - - - - - - - + <structname>ClutterTimeoutPool</structname> is an opaque structure +whose members cannot be directly accessed. + + Sets a function to be called at regular intervals, and puts it inside the @pool. The function is repeatedly called until it returns %FALSE, at which point the timeout is automatically destroyed and the function -won't be called again. If @notify is not %NULL, the @notify function +won't be called again. If @notify is not %NULL, the @notify function will be called. The first call to @func will be at the end of @interval. Since Clutter 0.8 this will try to compensate for delays. For example, if @func takes half the interval time to execute then the @@ -23271,153 +36019,178 @@ finished. Before version 0.8 it would not fire until a full interval after the function completes so the delay between calls would be @interval * 1.5. This function does not however try to invoke the function multiple times to catch up missing frames if -Use clutter_timeout_pool_remove() to stop the timeout." - version="0.4"> - - +Use clutter_timeout_pool_remove() to stop the timeout. + + the ID (greater than 0) of the timeout inside the pool. + - + the time between calls to the function, in frames per second + + closure="2" + destroy="3"> + function to call - + data to pass to the function, or %NULL + - + + function to call when the timeout is removed, or %NULL + Removes a timeout function with @id from the timeout pool. The id +is the same returned when adding a function to the timeout pool with +clutter_timeout_pool_add(). - + the id of the timeout to remove + + + + + + + + + + + + + - + + + + - + - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + The type of unit in which a value is expressed +This enumeration might be expanded at later date + glib:get-type="clutter_units_get_type" + c:symbol-prefix="units"> + An opaque structure, to be used to store sizing and positioning +values along with their unit. - + - + - + - + - + - + - - - - - - - - - - - + + Copies @units +#ClutterUnits structure. Use clutter_units_free() to free +the allocated resources + the newly created copy of a - + Frees the resources allocated by @units You should only call this function on a #ClutterUnits -created using clutter_units_copy()" - version="1.0"> +created using clutter_units_copy() - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Stores a value in centimeters inside @units - + centimeters + + + + + + Stores a value in em inside @units, using the default font +name as returned by clutter_backend_get_font_name() + + + + + + em + + + + + + Stores a value in em inside @units using @font_name + + + + + + the font name and size + + + + em + + + + + + Stores a value in millimiters inside @units + + + + + + millimeters + + + + + + Stores a value in pixels inside @units + + + + + + pixels + + Stores a value in typographic points inside @units - + typographic points + - - - - - + Parses a value and updates @units with it A #ClutterUnits expressed in string should match: |[ | digit* sep digit+ @@ -23612,312 +36368,392 @@ While these are not: 42 cats omg!1!ponies ]| -<note>If no unit is specified, pixels are assumed.</note> -and %FALSE otherwise" - version="1.0"> +<note><para>If no unit is specified, pixels are assumed.</para></note> +and %FALSE otherwise - + %TRUE if the string was successfully parsed, + + the string to convert + + Retrieves the unit type of the value stored inside @units + + a unit type + + + + + Retrieves the value stored inside @units + + the value stored inside a #ClutterUnits + + + + + Converts a value in #ClutterUnits to pixels + + the value in pixels + + + + Converts @units into a string See clutter_units_from_string() for the units syntax and for examples of output <note>Fractional values are truncated to the second decimal position for em, mm and cm, and to the first decimal position for typographic points. Pixels are integers.</note> -#ClutterUnits value. Use g_free() to free the string" - version="1.0"> +#ClutterUnits value. Use g_free() to free the string + a newly allocated string containing the encoded - + - + - + + + + + + + + + + - + - + - - + + - + - - + + + + + + glib:get-type="clutter_vertex_get_type" + c:symbol-prefix="vertex"> + Vertex of an actor in 3D space, expressed in pixels - + - + - + - + Creates a new #ClutterVertex for the point in 3D space identified by the 3 coordinates @x, @y, @z -clutter_vertex_free() to free the resources" - version="1.0"> +clutter_vertex_free() to free the resources + the newly allocate #ClutterVertex. Use - + X coordinate + - + Y coordinate + - + Z coordinate + - + + Copies @vertex +clutter_vertex_free() to free the allocated resources + a newly allocated copy of #ClutterVertex. Use - + + Compares @vertex_a and @vertex_b for equality - - - - - - + %TRUE if the passed #ClutterVertex are equal + + a #ClutterVertex + + Frees a #ClutterVertex allocated using clutter_vertex_copy() + + + + + + + + + + - + - + + + + + + + - + + + + - + - + + + + - + + + + + + + - + + + + - + - + + + + - + - + - + - + - + + + + - + - + - + - + - + - + - + - + - + - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -23925,1175 +36761,1239 @@ clutter_vertex_free() to free the allocated resources" - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Utility function for setting the source color of @cr using +a #ClutterColor. + a Cairo context + a #ClutterColor - + - + - + - + - + - + - + - + + Run-time version check, to check the version the Clutter library that an application is currently linked against This is the run-time equivalent of the compile-time %CLUTTER_CHECK_VERSION pre-processor macro -greater than (@major, @minor, @micro), and %FALSE otherwise" - version="1.2"> +greater than (@major, @minor, @micro), and %FALSE otherwise - + %TRUE if the version of the Clutter library is + - + major version, like 1 in 1.2.3 + - + minor version, like 2 in 1.2.3 + - + micro version, like 3 in 1.2.3 + - + - + - + + Clears the internal cache of glyphs used by the Pango renderer. This will free up some memory and GL texture resources. The cache will be automatically refilled as more text is -drawn." - version="0.8"> +drawn. - + - + + Compares two #ClutterColor<!-- -->s and checks if they are the same. +This function can be passed to g_hash_table_new() as the @key_equal_func +parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable. - + %TRUE if the two colors are the same. + - + a #ClutterColor + - + a #ClutterColor + + Converts a #ClutterColor to a hash value. +This function can be passed to g_hash_table_new() as the @hash_func +parameter, when using #ClutterColor<!-- -->s as keys in a #GHashTable. - + a hash value corresponding to the color + - + a #ClutterColor + - + - + Looks up the #GParamSpec for a child property of @klass. +if no such property exist. + + The #GParamSpec for the property or %NULL + a #GObjectClass implementing the #ClutterContainer interface. + a property name. - + Returns an array of #GParamSpec for all child properties. +of #GParamSpec<!-- -->s which should be freed after use. + + an array + a #GObjectClass implementing the #ClutterContainer interface. - + return location for length of returned array. + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + - + + + + - + - + - + - + - + - + + + + - + - + - + + + + - + - + - + + + + + + + - + - + - + + + + + + + - + - + + + + - + - + - + - + + + + - + - + + + + - + - + - + - + - + - + - + - + @@ -25106,289 +38006,297 @@ of #GParamSpec<!-- -->s which should be freed after use." - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Pops an event off the event queue. Applications should not need to call +this. + A #ClutterEvent or NULL if queue empty - + Returns a pointer to the first event from the event queue but +does not remove it. + + A #ClutterEvent or NULL if queue empty. + Checks if events are pending in the event queue. - + TRUE if there are pending events, FALSE otherwise. + - + - + - + - + + Checks whether @feature is available. @feature can be a logical +OR of #ClutterFeatureFlags. - + %TRUE if a feature is available + + a #ClutterFeatureFlags - + Returns all the supported features. + + a logical OR of all the supported features. - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - + shadowed-by="frame_source_add_full" + version="0.8" + introspectable="0"> + Simple wrapper around clutter_frame_source_add_full(). + + the ID (greater than 0) of the event source. + - + the number of times per second to call the function + - + + function to call - + data to pass to the function + + Sets a function to be called at regular intervals with the given priority. The function is called repeatedly until it returns %FALSE, at which point the timeout is automatically destroyed and the function will not be called again. The @notify function is @@ -25401,151 +38309,177 @@ half the interval time after it finished. In contrast g_timeout_add_full() would not fire until a full interval after the function completes so the delay between calls would be 1.0 / @fps * 1.5. This function does not however try to invoke the function -multiple times to catch up missing frames if @func takes more than" - version="0.8"> - - +multiple times to catch up missing frames if @func takes more than + + the ID (greater than 0) of the event source. + - - + + the priority of the frame source. Typically this will be in the range between %G_PRIORITY_DEFAULT and %G_PRIORITY_HIGH. + - + the number of times per second to call the function + + function to call - + data to pass to the function + - + + function to call when the timeout source is removed - + - + - + - + - + - + - + - - + + Returns whether Clutter has accessibility support enabled. As +least, a value of TRUE means that there are a proper AtkUtil +implementation available + + %TRUE if Clutter has accessibility support enabled + + + + + Retrieves the #ClutterActor with @id. +The returned actor does not have its reference count increased. + + the actor with the passed id or %NULL. - + a #ClutterActor ID. + + If an event is currently being processed, return that event. This function is intended to be used to access event state that might not be exposed by higher-level widgets. For -example, to get the key modifier state from a Button 'clicked' -event." - version="1.2"> - +example, to get the key modifier state from a Button 'clicked' +event. + + The current ClutterEvent, or %NULL if none + Retrieves the timestamp of the last event, if there is an +event or if the event has a timestamp. - + the event timestamp, or %CLUTTER_CURRENT_TIME + + c:identifier="clutter_get_debug_enabled"> + Check if clutter has debugging turned on. - + TRUE if debugging is turned on, FALSE otherwise. + + Retrieves the default #ClutterBackend used by Clutter. The #ClutterBackend holds backend-specific configuration options. not ref or unref the returned object. Applications should rarely -need to use this." - version="0.4"> - +need to use this. + + the default backend. You should + Retrieves the default frame rate. See clutter_set_default_frame_rate(). - + the default frame rate + + Retrieves the default direction for the text. The text direction is determined by the locale and/or by the %CLUTTER_TEXT_DIRECTION environment variable The default text direction can be overridden on a per-actor basis by using -clutter_actor_set_text_direction()" - version="1.2"> - +clutter_actor_set_text_direction() + + the default text direction - + Gets the current font flags for rendering text. See +clutter_set_font_flags(). + + The font flags + Retrieves the #PangoFontMap instance used by Clutter. You can use the global font map object with the COGL Pango API. -value is owned by Clutter and it should never be unreferenced." - version="1.0"> - +value is owned by Clutter and it should never be unreferenced. + + the #PangoFontMap instance. The returned + Retrieves the #ClutterInputDevice from its @id. This is a convenience wrapper for clutter_device_manager_get_device() and it is functionally equivalent to: |[ @@ -25553,43 +38487,46 @@ ClutterDeviceManager *manager; ClutterInputDevice *device; manager = clutter_device_manager_get_default (); device = clutter_device_manager_get_device (manager, id); -]|" - version="0.8"> - +]| + + a #ClutterInputDevice, or %NULL - + the unique id for a device + - + Queries the current keyboard grab of clutter. + + the actor currently holding the keyboard grab, or NULL if there is no grab. + Gets whether the per-actor motion events are enabled. - + %TRUE if the motion events are enabled + + Returns a #GOptionGroup for the command line arguments recognized by Clutter. You should add this group to your #GOptionContext with g_option_context_add_group(), if you are using g_option_context_parse() to parse your commandline arguments. -Calling g_option_context_parse() with Clutter's #GOptionGroup will result -in Clutter's initialization. That is, the following code: +Calling g_option_context_parse() with Clutter's #GOptionGroup will result +in Clutter's initialization. That is, the following code: |[ g_option_context_set_main_group (context, clutter_get_option_group ()); res = g_option_context_parse (context, &amp;argc, &amp;argc, NULL); @@ -25601,16 +38538,17 @@ clutter_init (&amp;argc, &amp;argv); After g_option_context_parse() on a #GOptionContext containing the Clutter #GOptionGroup has returned %TRUE, Clutter is guaranteed to be initialized. -recognized by Clutter" - version="0.2"> - +recognized by Clutter + + a #GOptionGroup for the commandline arguments + Returns a #GOptionGroup for the command line arguments recognized by Clutter. You should add this group to your #GOptionContext with g_option_context_add_group(), if you are using g_option_context_parse() to parse your commandline arguments. Unlike clutter_get_option_group(), @@ -25618,59 +38556,62 @@ calling g_option_context_parse() with the #GOptionGroup returned by this function requires a subsequent explicit call to clutter_init(); use this function when needing to set foreign display connection with clutter_x11_set_display(), or with gtk_clutter_init(). -recognized by Clutter" - version="0.8.2"> - +recognized by Clutter + + a #GOptionGroup for the commandline arguments - + Queries the current pointer grab of clutter. + + the actor currently holding the pointer grab, or NULL if there is no grab. + Retrieves the Clutter script id, if any. +a UI definition file. The returned string is owned by the object and +should never be modified or freed. + the script id, or %NULL if @object was not defined inside + a #GObject + Returns whether Clutter should print out the frames per second on the console. You can enable this setting either using the <literal>CLUTTER_SHOW_FPS</literal> environment variable or passing -the <literal>--clutter-show-fps</literal> command line argument. *" - version="0.4"> +the <literal>--clutter-show-fps</literal> command line argument. * - + %TRUE if Clutter should show the FPS. + - - - + + Returns the approximate number of microseconds passed since clutter was +intialised. + + Number of microseconds since clutter_init() was called. + + Grabs keyboard events, after the grab is done keyboard events (#ClutterActor::key-press-event and #ClutterActor::key-release-event) are delivered to this actor directly. The source set in the event will be the actor that would have received the event if the keyboard grab was not @@ -25678,20 +38619,21 @@ in effect. Like pointer grabs, keyboard grabs should only be used as a last resource. See also clutter_stage_set_key_focus() and clutter_actor_grab_key_focus() -to perform a "soft" key grab and assign key focus to a specific actor." - version="0.6"> +to perform a "soft" key grab and assign key focus to a specific actor. + a #ClutterActor + Grabs pointer events, after the grab is done all pointer related events (press, motion, release, enter, leave and scroll) are delivered to this actor directly without passing through both capture and bubble phases of the event delivery chain. The source set in the event will be the actor @@ -25701,288 +38643,300 @@ done by Clutter. Pointer grabs should only be used as a last resource; using the #ClutterActor::captured-event signal should always be the preferred way to intercept event delivery to reactive actors.</para></note> If you wish to grab all the pointer events for a specific input device, -you should use clutter_grab_pointer_for_device()." - version="0.6"> +you should use clutter_grab_pointer_for_device(). + a #ClutterActor + Grabs all the pointer events coming from the device @id for @actor. +If @id is -1 then this function is equivalent to clutter_grab_pointer(). + a #ClutterActor - + a device id, or -1 + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + It will initialise everything needed to operate with Clutter and parses some standard command line options. @argc and @argv are adjusted accordingly so your own code will never see those standard -arguments."> - +arguments. + + 1 on success, < 0 on failure. - + transfer-ownership="full"> + The number of arguments in @argv + + allow-none="1"> + A pointer to an array of arguments. + + + + + + This function does the same work as clutter_init(). Additionally, it allows you to add your own command line options, and it automatically generates nicely formatted <option>--help</option> output. Note that your program will be terminated after writing @@ -25990,790 +38944,812 @@ out the help output. Also note that, in case of error, the error message will be placed inside @error instead of being printed on the display. initialised, or other values or #ClutterInitError in case of -error." - version="0.2" - throws="1"> - +error. + + %CLUTTER_INIT_SUCCESS if Clutter has been successfully - + transfer-ownership="full"> + a pointer to the number of command line arguments + + allow-none="1"> + a pointer to the array of command line arguments + allow-none="1"> + a string which is displayed in the first line of <option>--help</option> output, after <literal><replaceable>programname</replaceable> [OPTION...]</literal> - + + a %NULL terminated array of #GOptionEntry<!-- -->s describing the options of your program + allow-none="1"> + a translation domain to use for translating the <option>--help</option> output for the options in - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode) character. -character."> +character. - + a Unicode character, or 0 if there is no corresponding + - + a key symbol + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Starts the Clutter mainloop. - + + Retrieves the depth of the Clutter mainloop. - + The level of the mainloop. + - + + Terminates the Clutter mainloop. - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + version="0.8.4" + introspectable="0"> + Creates a #GParamSpec for properties using #ClutterColor. + + the newly created #GParamSpec + name of the property + short name + description (can be translatable) + default value + flags for the param spec - + version="0.8" + introspectable="0"> + Creates a #GParamSpec for properties using #CoglFixed values + + the newly created #GParamSpec + name of the property + short name + description (can be translatable) + lower boundary + higher boundary + default value + flags for the param spec - + version="1.0" + introspectable="0"> + Creates a #GParamSpec for properties using #ClutterUnits. + + the newly created #GParamSpec + name of the property + short name + description (can be translatable) + the default type for the #ClutterUnits - + lower boundary + - + higher boundary + - + default value + + flags for the param spec - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + Forces a redraw of the entire stage. Applications should never use this function, but queue a redraw using clutter_actor_queue_redraw(). This function should only be used by libraries integrating Clutter from -within another toolkit."> +within another toolkit. @@ -26784,117 +39760,126 @@ within another toolkit."> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + - + - + - + - + - + + Sets the default frame rate. This frame rate will be used to limit the number of frames drawn if Clutter is not able to synchronize with the vertical refresh rate of the display. When synchronization -is possible, this value is ignored." - version="0.6"> +is possible, this value is ignored. - + the new default frame rate + + Sets the font quality options for subsequent text rendering operations. Using mipmapped textures will improve the quality for scaled down text but will use more texture memory. Enabling hinting improves text quality for static text but may -introduce some artifacts if the text is animated." - version="1.0"> +introduce some artifacts if the text is animated. + The new flags + Sets whether per-actor motion events should be enabled or not (the default is to enable them). If @enable is %FALSE the following events will not work: <itemizedlist> @@ -26902,117 +39887,152 @@ If @enable is %FALSE the following events will not work: #ClutterStage</para></listitem> <listitem><para>ClutterActor::enter-event</para></listitem> <listitem><para>ClutterActor::leave-event</para></listitem> -</itemizedlist>" - version="0.6"> +</itemizedlist> - + %TRUE to enable per-actor motion events + - + - + - + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + - + - + - + - - + shadowed-by="threads_add_frame_source_full" + version="0.8" + introspectable="0"> + Simple wrapper around clutter_threads_add_frame_source_full(). + + the ID (greater than 0) of the event source. + - + the number of times per second to call the function + - + + function to call - + data to pass to the function + + Sets a function to be called at regular intervals holding the Clutter threads lock, with the given priority. The function is called repeatedly until it returns %FALSE, at which point the timeout is automatically removed and the function will not be called again. The @notify function @@ -27024,58 +40044,65 @@ contrast clutter_threads_add_timeout_full() would not fire until a full interval after the function completes so the delay between calls would be @interval * 1.5. This function does not however try to invoke the function multiple times to catch up missing frames if -See also clutter_threads_add_idle_full()." - version="0.8"> - - +See also clutter_threads_add_idle_full(). + + the ID (greater than 0) of the event source. + - - + + the priority of the frame source. Typically this will be in the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH. + - + the number of times per second to call the function + + function to call - + data to pass to the function + - + + function to call when the timeout source is removed - - + shadowed-by="threads_add_idle_full" + version="0.4" + introspectable="0"> + Simple wrapper around clutter_threads_add_idle_full() using the +default priority. + + the ID (greater than 0) of the event source. + - + + function to call - + data to pass to the function + + Adds a function to be called whenever there are no higher priority events pending. If the function returns %FALSE it is automatically removed from the list of event sources and will not be called again. This function can be considered a thread-safe variant of g_idle_add_full(): @@ -27108,7 +40135,7 @@ idle_safe_callback, closure, g_free) } -| +]| This function should be used by threaded applications to make sure that @func is emitted under the Clutter threads lock and invoked from the same thread that started the Clutter main loop. For instance, @@ -27138,35 +40165,38 @@ clutter_threads_add_idle_full (G_PRIORITY_HIGH_IDLE, update_ui, closure, NULL); -]|" - version="0.4"> - - +]| + + the ID (greater than 0) of the event source. + - - + + the priority of the timeout source. Typically this will be in the range between #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE + + function to call - + data to pass to the function + - + + functio to call when the idle source is removed + Adds a function to be called whenever Clutter is repainting a Stage. If the function returns %FALSE it is automatically removed from the list of repaint functions and will not be called again. This function is guaranteed to be called from within the same thread @@ -27177,11 +40207,10 @@ a frame from a video into a #ClutterTexture. When the repaint function is removed (either because it returned %FALSE or because clutter_threads_remove_repaint_func() has been called) the can use the returned integer to remove the repaint function by -calling clutter_threads_remove_repaint_func()." - version="1.0"> - - +calling clutter_threads_remove_repaint_func(). + + the ID (greater than 0) of the repaint function. You + + the function to be called within the paint cycle - + data to be passed to the function, or %NULL + - + + function to be called when removing the repaint function, or %NULL - - + shadowed-by="threads_add_timeout_full" + version="0.4" + introspectable="0"> + Simple wrapper around clutter_threads_add_timeout_full(). + + the ID (greater than 0) of the event source. + - + the time between calls to the function, in milliseconds + - + + function to call - + data to pass to the function + + Sets a function to be called at regular intervals holding the Clutter threads lock, with the given priority. The function is called repeatedly until it returns %FALSE, at which point the timeout is automatically removed and the function will not be called again. The @notify function @@ -27234,83 +40268,89 @@ is called when the timeout is removed. The first call to the function will be at the end of the first @interval. It is important to note that, due to how the Clutter main loop is implemented, the timing will not be accurate and it will not try to -"keep up" with the interval. A more reliable source is available +"keep up" with the interval. A more reliable source is available using clutter_threads_add_frame_source_full(), which is also internally used by #ClutterTimeline. -See also clutter_threads_add_idle_full()." - version="0.4"> - - +See also clutter_threads_add_idle_full(). + + the ID (greater than 0) of the event source. + - - + + the priority of the timeout source. Typically this will be in the range between #G_PRIORITY_DEFAULT and #G_PRIORITY_HIGH. + - + the time between calls to the function, in milliseconds + + function to call - + data to pass to the function + - + + function to call when the timeout source is removed + Locks the Clutter thread lock. + Initialises the Clutter threading mechanism, so that Clutter API can be called by multiple threads, using clutter_threads_enter() and clutter_threads_leave() to mark the critical sections. You must call g_thread_init() before this function. This function must be called before clutter_init(). -It is safe to call this function multiple times." - version="0.4"> +It is safe to call this function multiple times. + Unlocks the Clutter thread lock. + Removes the repaint function with @handle_id as its id - + an unsigned integer greater than zero + + Allows the application to replace the standard method that Clutter uses to protect its data structures. Normally, Clutter creates a single #GMutex that is locked by clutter_threads_enter(), and released by clutter_threads_leave(); using this function an @@ -27324,536 +40364,577 @@ As an example, consider an application that has its own recursive lock that when held, holds the Clutter lock as well. When Clutter unlocks the Clutter lock when entering a recursive main loop, the application must temporarily release its lock as well. -Most threaded Clutter apps won't need to use this method. +Most threaded Clutter apps won't need to use this method. This method must be called before clutter_threads_init(), and cannot -be called multiple times." - version="0.4"> +be called multiple times. - + + function called when aquiring the Clutter main lock - + + function called when releasing the Clutter main lock - + - + - + - + - + + + Creates a new timeout pool source. A timeout pool should be used when +multiple timeout functions, running at the same priority, are needed and +the g_timeout_add() API might lead to starvation of the time slice of +the main loop. A timeout pool allocates a single time slice of the main +loop and runs every timeout function inside it. The timeout pool is +always sorted, so that the extraction of the next timeout function is +a constant time operation. +is owned by the GLib default context and will be automatically +destroyed when the context is destroyed. It is possible to force +the destruction of the timeout pool using g_source_destroy() + + the newly created #ClutterTimeoutPool. The created pool + + + + + the priority of the timeout pool. Typically this will be #G_PRIORITY_DEFAULT + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Removes an existing grab of the keyboard. + Removes an existing grab of the pointer. + Removes an existing grab of the pointer events for device @id. - + a device id + - + - + - + - + - + - + - + - + - + - + + Calculates the nearest power of two, greater than or equal to @a. - + The nearest power of two, greater or equal to @a. + - + Value to get the next power + - + - + + Gets the #ClutterColor contained in @value. + the color inside the passed #GValue + a #GValue initialized to #CLUTTER_TYPE_COLOR - + Gets the fixed point value stored inside @value. + + the value inside the passed #GValue + a #GValue initialized to %COGL_TYPE_FIXED + Retrieves the list of floating point values stored inside the passed #GValue. @value must have been initialized with %CLUTTER_TYPE_SHADER_FLOAT. The returned value is owned by the #GValue and should never -be modified or freed." - version="0.8"> +be modified or freed. - + the pointer to a list of floating point values. + + a #GValue - - + + return location for the number of returned floating point values, or %NULL + + Retrieves the list of integer values stored inside the passed #GValue. @value must have been initialized with %CLUTTER_TYPE_SHADER_INT. The returned value is owned by the #GValue and should never -be modified or freed." - version="0.8"> +be modified or freed. - + the pointer to a list of integer values. + + a #GValue - - + + return location for the number of returned integer values, or %NULL + + Retrieves a matrix of floating point values stored inside the passed #GValue. @value must have been initialized with %CLUTTER_TYPE_SHADER_MATRIX. of floating point values. The returned value is owned by the #GValue and -should never be modified or freed." - version="0.8"> - +should never be modified or freed. + + the pointer to a matrix - + + a #GValue - + transfer-ownership="full"> + return location for the number of returned floating point values, or %NULL + + Gets the #ClutterUnit<!-- -->s contained in @value. + the units inside the passed #GValue + a #GValue initialized to #CLUTTER_TYPE_UNIT + Sets @value to @color. + a #GValue initialized to #CLUTTER_TYPE_COLOR + the color to set + Sets @value to @fixed_. + a #GValue initialized to %COGL_TYPE_FIXED + the fixed point value to set + Sets @floats as the contents of @value. The passed #GValue +must have been initialized using %CLUTTER_TYPE_SHADER_FLOAT. + a #GValue - + number of floating point values in @floats + - - + + an array of floating point values + + Sets @ints as the contents of @value. The passed #GValue +must have been initialized using %CLUTTER_TYPE_SHADER_INT. + a #GValue - + number of integer values in @ints + - - + + an array of integer values + + Sets @matrix as the contents of @value. The passed #GValue +must have been initialized using %CLUTTER_TYPE_SHADER_MATRIX. + a #GValue - + number of floating point values in @floats + - - + + a matrix of floating point values + + Sets @value to @units + a #GValue initialized to #CLUTTER_TYPE_UNIT + the units to set - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + diff --git a/extra/clutter/cogl/Cogl-1.0.gir b/extra/clutter/cogl/Cogl-1.0.gir index 94159e4bee..95d199a765 100644 --- a/extra/clutter/cogl/Cogl-1.0.gir +++ b/extra/clutter/cogl/Cogl-1.0.gir @@ -2,31 +2,45 @@ - - - - - - + + + Integer representation of an angle such that 1024 corresponds to +full circle (i.e., 2 * pi). + + + + Fixed point number using a (16.16) notation. + + + + Type used for storing references to cogl objects, the CoglHandle is +a fully opaque type without any public data members. + + - + - + + Data types for the components of cogl_vertex_buffer_add() glib:nick="float"/> - + + + + + Error codes that can be thrown when performing bitmap +operations. Note that gdk_pixbuf_new_from_file() can also throw +errors directly from the underlying image loading library. For +example, if GdkPixbuf is used then errors #GdkPixbufError<!-- -->s +will be used directly. + + + + + Error enumeration for the blend strings parser c:identifier="COGL_BLEND_STRING_ERROR_GPU_UNSUPPORTED_ERROR" glib:nick="gpu-unsupported-error"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The access hints for cogl_buffer_set_update_hint() glib:nick="read-write"/> + Types of auxiliary buffers c:identifier="COGL_BUFFER_BIT_STENCIL" glib:nick="stencil"/> + + all the buffer's contents. +Hints to Cogl about how you are planning to modify the data once it +is mapped. + + + Target flags for FBOs. glib:nick="offscreen-buffer"/> + The update hint on a buffer allows the user to give some detail on how often +the buffer data is going to be updated. - - - - + A structure for holding a color definition. The contents of the CoglColor structure are private and should never by accessed -directly." - version="1.0"> +directly. - + - + - + - + - + - + - + - - - - - - + version="1.0" + introspectable="0"> + Creates a copy of @color +to free the allocate resources + + a newly-allocated #CoglColor. Use cogl_color_free() - + + Frees the resources allocated by cogl_color_new() and cogl_color_copy() - + Retrieves the alpha channel of @color as a fixed point +value between 0 and %1.0. + + the alpha channel of the passed color + + + + + Retrieves the alpha channel of @color as a byte value +between 0 and 255 + + the alpha channel of the passed color + + + + + Retrieves the alpha channel of @color as a floating point +value between 0.0 and 1.0 + + the alpha channel of the passed color + + + + + Retrieves the blue channel of @color as a fixed point +value between 0 and %1.0. + + the blue channel of the passed color + + + + + Retrieves the blue channel of @color as a byte value +between 0 and 255 + + the blue channel of the passed color + + + + + Retrieves the blue channel of @color as a floating point +value between 0.0 and 1.0 + + the blue channel of the passed color + + + + + Retrieves the green channel of @color as a fixed point +value between 0 and %1.0. + + the green channel of the passed color + + + + + Retrieves the green channel of @color as a byte value +between 0 and 255 + + the green channel of the passed color + + + + + Retrieves the green channel of @color as a floating point +value between 0.0 and 1.0 + + the green channel of the passed color + + + + + Retrieves the red channel of @color as a fixed point +value between 0 and %1.0. + + the red channel of the passed color + + + + + Retrieves the red channel of @color as a byte value +between 0 and 255 + + the red channel of the passed color + + + + + Retrieves the red channel of @color as a floating point +value between 0.0 and 1.0 + + the red channel of the passed color + + + + + Sets the values of the passed channels into a #CoglColor - + value of the red channel, between 0 and %1.0 + - + value of the green channel, between 0 and %1.0 + - + value of the blue channel, between 0 and %1.0 + - + value of the alpha channel, between 0 and %1.0 + + + + + + Sets the values of the passed channels into a #CoglColor + + + + + + a pointer to an array of 4 float color components + + + + + + Sets the values of the passed channels into a #CoglColor. + + + + + + value of the red channel, between 0 and 255 + + + + value of the green channel, between 0 and 255 + + + + value of the blue channel, between 0 and 255 + + + + value of the alpha channel, between 0 and 255 + + + + + + Converts a non-premultiplied color to a pre-multiplied color. For +example, semi-transparent red is (1.0, 0, 0, 0.5) when non-premultiplied +and (0.5, 0, 0, 0.5) when premultiplied. + + + + + + Sets the alpha channel of @color to @alpha. + + + + + + a float value between 0.0f and 1.0f + + + + + + Sets the alpha channel of @color to @alpha. + + + + + + a byte value between 0 and 255 + + + + + + Sets the alpha channel of @color to @alpha. + + + + + + a float value between 0.0f and 1.0f + + + + + + Sets the blue channel of @color to @blue. + + + + + + a float value between 0.0f and 1.0f + + + + + + Sets the blue channel of @color to @blue. + + + + + + a byte value between 0 and 255 + + + + + + Sets the blue channel of @color to @blue. + + + + + + a float value between 0.0f and 1.0f + + version="1.0" + deprecated="Use cogl_color_init_from_4f instead." + deprecated-version="1.4"> + Sets the values of the passed channels into a #CoglColor - + value of the red channel, between 0 and %1.0 + - + value of the green channel, between 0 and %1.0 + - + value of the blue channel, between 0 and %1.0 + - + value of the alpha channel, between 0 and %1.0 + - + + Sets the values of the passed channels into a #CoglColor. - + + + + value of the red channel, between 0 and 255 + + + + value of the green channel, between 0 and 255 + + + + value of the blue channel, between 0 and 255 + + + + value of the alpha channel, between 0 and 255 + + + - + + Sets the green channel of @color to @green. - + + + + a float value between 0.0f and 1.0f + + + - + + Sets the green channel of @color to @green. - + + + + a byte value between 0 and 255 + + + - + + Sets the green channel of @color to @green. - + + + + a float value between 0.0f and 1.0f + + + - + + Sets the red channel of @color to @red. - + + + + a float value between 0.0f and 1.0f + + + - + + Sets the red channel of @color to @red. - + + + + a byte value between 0 and 255 + + + - + + Sets the red channel of @color to @red. - + + + + a float value between 0.0f and 1.0f + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + + Converts a pre-multiplied color to a non-premultiplied color. For +example, semi-transparent red is (0.5, 0, 0, 0.5) when premultiplied +and (1.0, 0, 0, 0.5) when non-premultiplied. - - - - - - - - - - + When using depth testing one of these functions is used to compare +the depth of an incoming fragment against the depth value currently +stored in the depth buffer. The function is changed using +cogl_material_set_depth_test_function(). +The test is only done when depth testing is explicitly enabled. (See +cogl_material_set_depth_test_enabled()) + - - - - - - - - - - + c:identifier="COGL_DEPTH_TEST_FUNCTION_NEVER" + glib:nick="never"/> + + + + + + + + + + Error enumeration for Cogl +The @COGL_ERROR_UNSUPPORTED error can be thrown for a variety of +reasons. For example: +<itemizedlist> +<listitem><para>You've tried to use a feature that is not +advertised by cogl_get_features(). This could happen if you create +a non-sliced texture with a non-power-of-two size when +%COGL_FEATURE_TEXTURE_NPOT is not advertised.</para></listitem> +<listitem><para>The GPU can not handle the configuration you have +requested. An example might be if you try to use too many texture +layers in a single #CoglMaterial</para></listitem> +<listitem><para>The driver does not support some +configuration.</para></listiem> +</itemizedlist> +Currently this is only used by Cogl API marked as experimental so +this enum should also be considered experimental. + + - + - + - + - + - + - + - + - + - + - + - + + Flags for the supported features. + + + + + + + + The fog mode determines the equation used to calculate the fogging blend factor while fogging is enabled. The simplest %COGL_FOG_MODE_LINEAR mode determines f as: |[ f = end - eye_distance / end - start ]| Where eye_distance is the distance of the current fragment in eye -coordinates from the origin." - version="1.0" - glib:type-name="CoglFogMode" - glib:get-type="cogl_fog_mode_get_type" - c:type="CoglFogMode"> +coordinates from the origin. - + + + The type used by cogl for function pointers, note that this type is used as a generic catch-all cast for function pointers and the -actual arguments and return type may be different."> +actual arguments and return type may be different. - - - - - - - - - - - - + You should aim to use the smallest data type that gives you enough range, since it reduces the size of your index array and can help reduce the demand on memory bandwidth. Note that %COGL_INDICES_TYPE_UNSIGNED_INT is only supported if the %COGL_FEATURE_UNSIGNED_INT_INDICES feature is available. This should always be available on OpenGL but on OpenGL ES it will only be available if the GL_OES_element_index_uint extension is -advertized." - glib:type-name="CoglIndicesType" - glib:get-type="cogl_indices_type_get_type" - c:type="CoglIndicesType"> +advertized. + + + Creates a new material with the configuration copied from the +source material. +We would strongly advise developers to always aim to use +cogl_material_copy() instead of cogl_material_new() whenever there will +be any similarity between two materials. Copying a material helps Cogl +keep track of a materials ancestry which we may use to help minimize GPU +state changes. + + a pointer to the newly allocated #CoglMaterial + + + + + Iterates all the layer indices of the given @material. + + + + + + A #CoglMaterialLayerCallback to be called for each layer index + + + + Private data that will be passed to the callback + + + + + + Retrieves the current ambient color for @material + + + + + + The location to store the ambient color + + + + + + Retrieves the current material color. + + + + + + The location to store the color + + + + + + + + + + + + + + + + + + + Gets the current depth test enabled state as previously set by +cogl_material_set_depth_test_enabled(). + + The material's current depth test enabled state. + + + + + Gets the current depth test enable state as previously set via +cogl_material_set_depth_test_enabled(). + + The current depth test enable state. + + + + + Gets the depth writing enable state as set by the corresponding +cogl_material_set_depth_writing_enabled. + + The current depth writing enable state + + + + + Retrieves the current diffuse color for @material + + + + + + The location to store the diffuse color + + + + + + Retrieves the materials current emission color. + + + + + + The location to store the emission color + + + + + + Gets whether point sprite coordinate generation is enabled for this +texture layer. +point sprite coordinates. + + whether the texture coordinates will be replaced with + + + + + the layer number to check. + + + + + + This function lets you access a material's internal list of layers +for iteration. +<note>You should avoid using this API if possible since it was only +made public by mistake and will be deprecated when we have +suitable alternative.</note> +<note>It's important to understand that the list returned may not +remain valid if you modify the material or any of the layers in any +way and so you would have to re-get the list in that +situation.</note> +list of #CoglMaterialLayer<!-- -->'s that can be passed to the +cogl_material_layer_* functions. The list is owned by Cogl and it +should not be modified or freed + + A + + + + + + + Retrieves the number of layers defined for the given @material + + the number of layers + + + + + Retrieves the materials current emission color. + + The materials current shininess value + + + + + Retrieves the materials current specular color. + + + + + + The location to store the specular color + + + + + + Queries what user program has been associated with the given + + The current user program or %COGL_INVALID_HANDLE. + + + + + This function removes a layer from your material + + + + + + Specifies the layer you want to remove + + + + + + Before a primitive is blended with the framebuffer, it goes through an +alpha test stage which lets you discard fragments based on the current +alpha value. This function lets you change the function used to evaluate +the alpha channel, and thus determine which fragments are discarded +and which continue on to the blending stage. +The default is %COGL_MATERIAL_ALPHA_FUNC_ALWAYS + + + + + + A @CoglMaterialAlphaFunc constant + + + + A reference point that the chosen alpha function uses to compare incoming fragments to. + + + + + + Sets the material's ambient color, in the standard OpenGL lighting +model. The ambient color affects the overall color of the object. +Since the diffuse color will be intense when the light hits the surface +directly, the ambient will be most apparent where the light hits at a +slant. +The default value is (0.2, 0.2, 0.2, 1.0) + + + + + + The components of the desired ambient color + + + + + + Conveniently sets the diffuse and ambient color of @material at the same +time. See cogl_material_set_ambient() and cogl_material_set_diffuse(). +The default ambient color is (0.2, 0.2, 0.2, 1.0) +The default diffuse color is (0.8, 0.8, 0.8, 1.0) + + + + + + The components of the desired ambient and diffuse colors + + + + + + If not already familiar; please refer <link linkend="cogl-Blend-Strings">here</link> +for an overview of what blend strings are, and their syntax. +Blending occurs after the alpha test function, and combines fragments with +the framebuffer. +Currently the only blend function Cogl exposes is ADD(). So any valid +blend statements will be of the form: +|[ +&lt;channel-mask&gt;=ADD(SRC_COLOR*(&lt;factor&gt;), DST_COLOR*(&lt;factor&gt;)) +]| +<warning>The brackets around blend factors are currently not +optional!</warning> +This is the list of source-names usable as blend factors: +<itemizedlist> +<listitem><para>SRC_COLOR: The color of the in comming fragment</para></listitem> +<listitem><para>DST_COLOR: The color of the framebuffer</para></listitem> +<listitem><para>CONSTANT: The constant set via cogl_material_set_blend_constant()</para></listitem> +</itemizedlist> +The source names can be used according to the +<link linkend="cogl-Blend-String-syntax">color-source and factor syntax</link>, +so for example "(1-SRC_COLOR[A])" would be a valid factor, as would +"(CONSTANT[RGB])" +These can also be used as factors: +<itemizedlist> +<listitem>0: (0, 0, 0, 0)</listitem> +<listitem>1: (1, 1, 1, 1)</listitem> +<listitem>SRC_ALPHA_SATURATE_FACTOR: (f,f,f,1) where f = MIN(SRC_COLOR[A],1-DST_COLOR[A])</listitem> +</itemizedlist> +<note>Remember; all color components are normalized to the range [0, 1] +before computing the result of blending.</note> +<example id="cogl-Blend-Strings-blend-unpremul"> +<title>Blend Strings/1</title> +<para>Blend a non-premultiplied source over a destination with +premultiplied alpha:</para> +<programlisting> +"RGB = ADD(SRC_COLOR*(SRC_COLOR[A]), DST_COLOR*(1-SRC_COLOR[A]))" +"A = ADD(SRC_COLOR, DST_COLOR*(1-SRC_COLOR[A]))" +</programlisting> +</example> +<example id="cogl-Blend-Strings-blend-premul"> +<title>Blend Strings/2</title> +<para>Blend a premultiplied source over a destination with +premultiplied alpha</para> +<programlisting> +"RGBA = ADD(SRC_COLOR, DST_COLOR*(1-SRC_COLOR[A]))" +</programlisting> +</example> +The default blend string is: +|[ +RGBA = ADD (SRC_COLOR, DST_COLOR*(1-SRC_COLOR[A])) +]| +That gives normal alpha-blending when the calculated color for the material +is in premultiplied form. +described blending is supported by the underlying driver/hardware. If +there was an error, %FALSE is returned and @error is set accordingly (if +present). + + %TRUE if the blend string was successfully parsed, and the + + + + + A <link linkend="cogl-Blend-Strings">Cogl blend string</link> describing the desired blend function. + + + + + + When blending is setup to reference a CONSTANT blend factor then +blending will depend on the constant set with this function. + + + + + + The constant color you want + + + + + + Sets the basic color of the material, used when no lighting is enabled. +Note that if you don't add any layers to the material then the color +will be blended unmodified with the destination; the default blend +semi-transparent red. See cogl_color_premultiply(). +The default value is (1.0, 1.0, 1.0, 1.0) + + + + + + The components of the color + + + + + + Sets the basic color of the material, used when no lighting is enabled. +The default value is (1.0, 1.0, 1.0, 1.0) + + + + + + The red component + + + + The green component + + + + The blue component + + + + The alpha component + + + + + + Sets the basic color of the material, used when no lighting is enabled. +The default value is (0xff, 0xff, 0xff, 0xff) + + + + + + The red component + + + + The green component + + + + The blue component + + + + The alpha component + + + + + + Sets the range to map depth values in normalized device coordinates +to before writing out to a depth buffer. +After your geometry has be transformed, clipped and had perspective +division applied placing it in normalized device +coordinates all depth values between the near and far z clipping +planes are in the range -1 to 1. Before writing any depth value to +the depth buffer though the value is mapped into the range [0, 1]. +With this function you can change the range which depth values are +mapped too although the range must still lye within the range [0, +1]. +If your driver does not support this feature (for example you are +using GLES 1 drivers) then this will return %FALSE and set an error +if @error isn't NULL. You can check ahead of time for the +%COGL_FEATURE_DEPTH_RANGE feature with cogl_features_available() to +know if this function will succeed. +By default normalized device coordinate depth values are mapped to +the full range of depth buffer values, [0, 1]. + + %TRUE if driver support is available else %FALSE. + + + + + The near component of the desired depth range which will be clamped to the range [0, 1] + + + + The far component of the desired depth range which will be clamped to the range [0, 1] + + + + + + Enables or disables depth testing according to the value of +If depth testing is enable then the #CoglDepthTestFunction set +using cogl_material_set_depth_test_function() us used to evaluate +the depth value of incoming fragments against the corresponding +value stored in the current depth buffer, and if the test passes +then the fragments depth value is used to update the depth buffer. +(unless you have disabled depth writing via +cogl_material_set_depth_writing_enabled ()) +By default depth testing is disabled. + + + + + + The enable state you want + + + + + + Sets the #CoglDepthTestFunction used to compare the depth value of +an incoming fragment against the corresponding value in the current +depth buffer. + + + + + + The #CoglDepthTestFunction to set + + + + + + Enables or disables depth buffer writing according to the value of +between a fragment's depth value and the corresponding depth buffer +value passes then the fragment's depth is written to the depth +buffer unless writing is disabled here. +By default depth writing is enabled + + + + + + The enable state you want + + + + + + Sets the material's diffuse color, in the standard OpenGL lighting +model. The diffuse color is most intense where the light hits the +surface directly - perpendicular to the surface. +The default value is (0.8, 0.8, 0.8, 1.0) + + + + + + The components of the desired diffuse color + + + + + + Sets the material's emissive color, in the standard OpenGL lighting +model. It will look like the surface is a light source emitting this +color. +The default value is (0.0, 0.0, 0.0, 1.0) + + + + + + The components of the desired emissive color + + + + + + In addition to the standard OpenGL lighting model a Cogl material may have +one or more layers comprised of textures that can be blended together in +order, with a number of different texture combine modes. This function +defines a new texture layer. +The index values of multiple layers do not have to be consecutive; it is +only their relative order that is important. +<note>In the future, we may define other types of material layers, such +as purely GLSL based layers.</note> + + + + + + the index of the layer + + + + a #CoglHandle for the layer object + + + + + + If not already familiar; you can refer +<link linkend="cogl-Blend-Strings">here</link> for an overview of what blend +strings are and there syntax. +These are all the functions available for texture combining: +<itemizedlist> +<listitem>REPLACE(arg0) = arg0</listitem> +<listitem>MODULATE(arg0, arg1) = arg0 x arg1</listitem> +<listitem>ADD(arg0, arg1) = arg0 + arg1</listitem> +<listitem>ADD_SIGNED(arg0, arg1) = arg0 + arg1 - 0.5</listitem> +<listitem>INTERPOLATE(arg0, arg1, arg2) = arg0 x arg2 + arg1 x (1 - arg2)</listitem> +<listitem>SUBTRACT(arg0, arg1) = arg0 - arg1</listitem> +<listitem> +<programlisting> +DOT3_RGB(arg0, arg1) = 4 x ((arg0[R] - 0.5)) * (arg1[R] - 0.5) + +(arg0[G] - 0.5)) * (arg1[G] - 0.5) + +(arg0[B] - 0.5)) * (arg1[B] - 0.5)) +</programlisting> +</listitem> +<listitem> +<programlisting> +DOT3_RGBA(arg0, arg1) = 4 x ((arg0[R] - 0.5)) * (arg1[R] - 0.5) + +(arg0[G] - 0.5)) * (arg1[G] - 0.5) + +(arg0[B] - 0.5)) * (arg1[B] - 0.5)) +</programlisting> +</listitem> +</itemizedlist> +Refer to the +<link linkend="cogl-Blend-String-syntax">color-source syntax</link> for +describing the arguments. The valid source names for texture combining +are: +<variablelist> +<varlistentry> +<term>TEXTURE</term> +<listitem>Use the color from the current texture layer</listitem> +</varlistentry> +<varlistentry> +<term>TEXTURE_0, TEXTURE_1, etc</term> +<listitem>Use the color from the specified texture layer</listitem> +</varlistentry> +<varlistentry> +<term>CONSTANT</term> +<listitem>Use the color from the constant given with +cogl_material_set_layer_constant()</listitem> +</varlistentry> +<varlistentry> +<term>PRIMARY</term> +<listitem>Use the color of the material as set with +cogl_material_set_color()</listitem> +</varlistentry> +<varlistentry> +<term>PREVIOUS</term> +<listitem>Either use the texture color from the previous layer, or +if this is layer 0, use the color of the material as set with +cogl_material_set_color()</listitem> +</varlistentry> +</variablelist> +<refsect2 id="cogl-Layer-Combine-Examples"> +<title>Layer Combine Examples</title> +<para>This is effectively what the default blending is:</para> +<informalexample><programlisting> +RGBA = MODULATE (PREVIOUS, TEXTURE) +</programlisting></informalexample> +<para>This could be used to cross-fade between two images, using +the alpha component of a constant as the interpolator. The constant +color is given by calling cogl_material_set_layer_constant.</para> +<informalexample><programlisting> +RGBA = INTERPOLATE (PREVIOUS, TEXTURE, CONSTANT[A]) +</programlisting></informalexample> +</refsect2> +<note>You can't give a multiplication factor for arguments as you can +with blending.</note> +described texture combining is supported by the underlying driver and +or hardware. On failure, %FALSE is returned and @error is set + + %TRUE if the blend string was successfully parsed, and the + + + + + Specifies the layer you want define a combine function for + + + + A <link linkend="cogl-Blend-Strings">Cogl blend string</link> describing the desired texture combine function. + + + + + + When you are using the 'CONSTANT' color source in a layer combine +description then you can use this function to define its value. + + + + + + Specifies the layer you want to specify a constant used for texture combining + + + + The constant color you want + + + + + + Changes the decimation and interpolation filters used when a texture is +drawn at other scales than 100%. + + + + + + the layer number to change. + + + + the filter used when scaling a texture down. + + + + the filter used when magnifying a texture. + + + + + + This function lets you set a matrix that can be used to e.g. translate +and rotate a single layer of a material used to fill your geometry. + + + + + + the index for the layer inside @material + + + + the transformation matrix for the layer + + + + + + When rendering points, if @enable is %TRUE then the texture +coordinates for this layer will be replaced with coordinates that +vary from 0.0 to 1.0 across the primitive. The top left of the +point will have the coordinates 0.0,0.0 and the bottom right will +have 1.0,1.0. If @enable is %FALSE then the coordinates will be +fixed for the entire point. +This function will only work if %COGL_FEATURE_POINT_SPRITE is +available. If the feature is not available then the function will +return %FALSE and set @error. + + %TRUE if the function succeeds, %FALSE otherwise. + + + + + the layer number to change. + + + + whether to enable point sprite coord generation. + + + + + + Sets the wrap mode for all three coordinates of texture lookups on +this layer. This is equivalent to calling +cogl_material_set_layer_wrap_mode_s(), +cogl_material_set_layer_wrap_mode_t() and +cogl_material_set_layer_wrap_mode_p() separately. + + + + + + the layer number to change. + + + + the new wrap mode + + + + + + Sets the wrap mode for the 'p' coordinate of texture lookups on +this layer. 'p' is the third coordinate. + + + + + + the layer number to change. + + + + the new wrap mode + + + + + + Sets the wrap mode for the 's' coordinate of texture lookups on this layer. + + + + + + the layer number to change. + + + + the new wrap mode + + + + + + Sets the wrap mode for the 't' coordinate of texture lookups on this layer. + + + + + + the layer number to change. + + + + the new wrap mode + + + + + + Sets the shininess of the material, in the standard OpenGL lighting +model, which determines the size of the specular highlights. A +higher @shininess will produce smaller highlights which makes the +object appear more shiny. +The default value is 0.0 + + + + + + The desired shininess; must be >= 0.0 + + + + + + Sets the material's specular color, in the standard OpenGL lighting +model. The intensity of the specular color depends on the viewport +position, and is brightest along the lines of reflection. +The default value is (0.0, 0.0, 0.0, 1.0) + + + + + + The components of the desired specular color + + + + + + Associates a linked CoglProgram with the given material so that the +program can take full control of vertex and/or fragment processing. +This is an example of how it can be used to associate an ARBfp +program with a #CoglMaterial: +|[ +CoglHandle shader; +CoglHandle program; +CoglMaterial *material; +shader = cogl_create_shader (COGL_SHADER_TYPE_FRAGMENT); +cogl_shader_source (shader, +"!!ARBfp1.0\n" +"MOV result.color,fragment.color;\n" +"END\n"); +cogl_shader_compile (shader); +program = cogl_create_program (); +cogl_program_attach_shader (program, shader); +cogl_program_link (program); +material = cogl_material_new (); +cogl_material_set_user_program (material, program); +cogl_set_source_color4ub (0xff, 0x00, 0x00, 0xff); +cogl_rectangle (0, 0, 100, 100); +]| +It is possibly worth keeping in mind that this API is not part of +the long term design for how we want to expose shaders to Cogl +developers (We are planning on deprecating the cogl_program and +cogl_shader APIs in favour of a "snippet" framework) but in the +meantime we hope this will handle most practical GLSL and ARBfp +requirements. +Also remember you need to check for either the +%COGL_FEATURE_SHADERS_GLSL or %COGL_FEATURE_SHADERS_ARBFP before +using the cogl_program or cogl_shader API. + + + + + + A #CoglHandle to a linked CoglProgram + + + + + + Alpha testing happens before blending primitives with the framebuffer and +gives an opportunity to discard fragments based on a comparison with the +incoming alpha value and a reference alpha value. The #CoglMaterialAlphaFunc +determines how the comparison is done. + Texture filtering is used whenever the current pixel maps either to more +than one texture element (texel) or less than one. These filter enums +correspond to different strategies used to come up with a pixel color, by +possibly referring to multiple neighbouring texels and taking a weighted +average or simply using the nearest texel. + + + Queries the currently set downscaling filter for a material later + + the current downscaling filter + + + + + Queries the currently set downscaling filter for a material layer + + the current downscaling filter + + + + + Extracts a texture handle for a specific layer. +<note>In the future Cogl may support purely GLSL based layers; for those +layers this function which will likely return %COGL_INVALID_HANDLE if you +try to get the texture handle from them. Considering this scenario, you +should call cogl_material_layer_get_type() first in order check it is of +type %COGL_MATERIAL_LAYER_TYPE_TEXTURE before calling this function.</note> + + a #CoglHandle for the texture inside the layer + + + + + Gets the wrap mode for the 'p' coordinate of texture lookups on +this layer. 'p' is the third coordinate. + + the wrap mode value for the p coordinate. + + + + + Gets the wrap mode for the 's' coordinate of texture lookups on this layer. + + the wrap mode value for the s coordinate. + + + + + Gets the wrap mode for the 't' coordinate of texture lookups on this layer. + + the wrap mode value for the t coordinate. + + + + + + The callback prototype used with cogl_material_foreach_layer() for +iterating all the layers of a @material. + + + + + + The #CoglMaterial whos layers are being iterated + + + + The current layer index + + + + The private data passed to cogl_material_foreach_layer() + + + + + Available types of layers for a #CoglMaterial. This enumeration +might be expanded in later versions. - + The wrap mode specifies what happens when texture coordinates +outside the range 0→1 are used. Note that if the filter mode is +anything but %COGL_MATERIAL_FILTER_NEAREST then texels outside the +range 0→1 might be used even when the coordinate is exactly 0 or 1 +because OpenGL will try to sample neighbouring pixels. For example +if you are trying to render the full texture then you may get +artifacts around the edges when the pixels from the other side are +merged in if the wrap mode is set to repeat. + + + + + + A CoglMatrix holds a 4x4 transform matrix. This is a single precision, column-major matrix which means it is compatible with what OpenGL expects. A CoglMatrix can represent transforms such as, rotations, scaling, translation, sheering, and linear projections. You can combine these @@ -745,295 +2135,285 @@ Where w is normally 1 and all matrix modifications must be done via the cogl_matrix API. This allows Cogl to annotate the matrices internally. Violation of this will give undefined results. If you need to initialize a matrix with a constant other -than the identity matrix you can use cogl_matrix_init_from_array().</note>"> +than the identity matrix you can use cogl_matrix_init_from_array().</note> - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - - + + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Multiplies @matrix by the given frustum perspective matrix. - + coord of left vertical clipping plane + - + coord of right vertical clipping plane + - + coord of bottom horizontal clipping plane + - + coord of top horizontal clipping plane + - + positive distance to near depth clipping plane + - + positive distance to far depth clipping plane + - + + Casts @matrix to a float array which can be directly passed to OpenGL. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a pointer to the float array + + Gets the inverse transform of a given matrix and uses it to initialize a new #CoglMatrix. <note>Although the first parameter is annotated as const to indicate -that the transform it represents isn't modified this function may +that the transform it represents isn't modified this function may technically save a copy of the inverse transform within the given #CoglMatrix so that subsequent requests for the inverse transform may avoid costly inversion calculations.</note> -for degenerate transformations that can't be inverted (in this case the" - version="1.2"> +for degenerate transformations that can't be inverted (in this case the - + %TRUE if the inverse was successfully calculated or %FALSE + + transfer-ownership="none"> + The destination for a 4x4 inverse transformation matrix + + Initializes @matrix with the contents of @array + + + + + + A linear array of 16 floats (column-major order) + + + + + + Resets matrix to the identity matrix: +|[ +.xx=1; .xy=0; .xz=0; .xw=0; +.yx=0; .yy=1; .yz=0; .yw=0; +.zx=0; .zy=0; .zz=1; .zw=0; +.wx=0; .wy=0; .wz=0; .ww=1; +]| + + + + + + Multiplies the two supplied matrices together and stores +the resulting matrix inside @result + + + + + + A 4x4 transformation matrix + + + + A 4x4 transformation matrix + + + + + + Multiplies @matrix by a parallel projection matrix. + + + + + + The coordinate for the left clipping plane + + + + The coordinate for the right clipping plane + + + + The coordinate for the bottom clipping plane + + + + The coordinate for the top clipping plane + + + + The coordinate for the near clipping plane (may be negative if the plane is behind the viewer) + + + + The coordinate for the far clipping plane (may be negative if the plane is behind the viewer) + + + + + + Multiplies @matrix by the described perspective matrix +<note>You should be careful not to have to great a @z_far / @z_near ratio +since that will reduce the effectiveness of depth testing since there wont +be enough precision to identify the depth of objects near to each +other.</note> + + + + + + A field of view angle for the Y axis + + + + The ratio of width to height determining the field of view angle for the x axis. + + + + The distance to the near clip plane. Never pass 0 and always pass a positive number. + + + + The distance to the far clip plane. (Should always be positive) + + + + + + Multiplies @matrix with a rotation matrix that applies a rotation +of @angle degrees around the specified 3D vector. + + + + + + The angle you want to rotate in degrees + + + + X component of your rotation vector + + + + Y component of your rotation vector + + + + Z component of your rotation vector + + + + + + Multiplies @matrix with a transform matrix that scales along the X, +Y and Z axis. + + + + + + The X scale factor + + + + The Y scale factor + + + + The Z scale factor + + + + + c:identifier="cogl_matrix_transform_point"> + Transforms a point whos position is given and returned as four float +components. @@ -1041,45 +2421,166 @@ components."> - + transfer-ownership="full"> + The X component of your points position + - + transfer-ownership="full"> + The Y component of your points position + - + transfer-ownership="full"> + The Z component of your points position + - + transfer-ownership="full"> + The W component of your points position + + + + + + Multiplies @matrix with a transform matrix that translates along +the X, Y and Z axis. + + + + + + The X translation you want to apply + + + + The Y translation you want to apply + + + + The Z translation you want to apply + + + + + + + + Finds the user data previously associated with @object using +the given @key. If no user data has been associated with @object +for the given @key this function returns NULL. +the given @key; or NULL if no associated data is found. + + The user data previously associated with @object using + + + + + The address of a #CoglUserDataKey which provides a unique value with which to index the private data. + + + + + + Associates some private @user_data with a given #CoglObject. To +later remove the association call cogl_object_set_user_data() with +the same @key but NULL for the @user_data. + + + + + + The address of a #CoglUserDataKey which provides a unique value with which to index the private data. + + + + The data to associate with the given object, or NULL to remove a previous association. + + + + A #CoglUserDataDestroyCallback to call if the object is destroyed or if the association is removed by later setting NULL data for the same key. + - + - + - + + + + Returns a new copy of the path in @path. The new path has a +reference count of 1 so you should unref it with +cogl_object_unref() if you no longer need it. +Internally the path will share the data until one of the paths is +modified so copying paths should be relatively cheap. + + a copy of the path in @path. + + + + + + #CoglPathFillRule is used to determine how a path is filled. There +are two options - 'non-zero' and 'even-odd'. To work out whether any +point will be filled imagine drawing an infinetely long line in any +direction from that point. The number of times and the direction +that the edges of the path crosses this line determines whether the +line is filled as described below. Any open sub paths are treated +as if there was an extra line joining the first point and the last +point. +The default fill rule is %COGL_PATH_FILL_RULE_EVEN_ODD. The fill +rule is attached to the current path so preserving a path with +cogl_get_path() also preserves the fill rule. Calling +cogl_path_new() resets the current fill rule to the default. +<figure id="fill-rule-non-zero"> +<title>Example of filling various paths using the non-zero rule</title> +<graphic fileref="fill-rule-non-zero.png" format="PNG"/> +</figure> +<figure id="fill-rule-even-odd"> +<title>Example of filling various paths using the even-odd rule</title> +<graphic fileref="fill-rule-even-odd.png" format="PNG"/> +</figure> + + + + + + Pixel formats used by COGL. For the formats with a byte per component, the order of the components specify the order in increasing memory addresses. So for example %COGL_PIXEL_FORMAT_RGB_888 would have the red component in the @@ -1093,11 +2594,7 @@ the blue component would be in 1-5. Therefore the order in memory depends on the endianness of the system. When uploading a texture %COGL_PIXEL_FORMAT_ANY can be used as the internal format. Cogl will try to pick the best format to use -internally and convert the texture data if necessary." - version="0.8" - glib:type-name="CoglPixelFormat" - glib:get-type="cogl_pixel_format_get_type" - c:type="CoglPixelFormat"> +internally and convert the texture data if necessary. - + + Flags for cogl_read_pixels() - + - + - + + Types of shaders - + + Flags to pass to the cogl_texture_new_* family of functions. - + + + + + + + + Used to specify vertex information when calling cogl_polygon() - + - + - + - + - + - + - + + + When associating private data with a #CoglObject a callback can be +given which will be called either if the object is destroyed or if +cogl_object_set_user_data() is called with NULL user_data for the +same key. + + + + + + The data whos association with a #CoglObject has been destoyed. + + + + + + A #CoglUserDataKey is used to declare a key for attaching data to a +#CoglObject using cogl_object_set_user_data. The typedef only exists as a +formality to make code self documenting since only the unique address of a +#CoglUserDataKey is used. +Typically you would declare a static #CoglUserDataKey and set private data +on an object something like this: +|[ +static CoglUserDataKey path_private_key; +static void +destroy_path_private_cb (void *data) +{ +g_free (data); +} +static void +my_path_set_data (CoglPath *path, void *data) +{ +cogl_object_set_user_data (COGL_OBJECT (path), +&private_key, +data, +destroy_path_private_cb); +} +]| + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + How vertices passed to cogl_vertex_buffer_draw() and +cogl_vertex_buffer_draw_elements() should be interpreted - - + + Computes the cosine of @angle + + the cosine of the passed angle + an angle expressed using #CoglAngle - - + + Computes the sine of @angle + + the sine of the passed angle + an angle expressed using #CoglAngle - - + + Computes the tangent of @angle + + the tangent of the passed angle + an angle expressed using #CoglAngle - + We do not advise nor reliably support the interleaving of raw GL drawing and Cogl drawing functions, but if you insist, cogl_begin_gl() and cogl_end_gl() provide a simple mechanism that may at least give you a fighting chance of succeeding. @@ -1370,7 +3086,7 @@ cogl_end_gl (); - continue using Cogl to draw } ]| -Don't ever try and do: +Don't ever try and do: |[ { - setup some OpenGL state. @@ -1391,362 +3107,142 @@ simplified material state it is your responsibility to set a simple source material before calling cogl_begin_gl(). E.g. by calling cogl_set_source_color4ub().</note> <note>It is your responsibility to restore any OpenGL state that you modify -to how it was after calling cogl_begin_gl() if you don't do this then the +to how it was after calling cogl_begin_gl() if you don't do this then the result of further Cogl calls is undefined.</note> <note>You can not nest begin/end blocks.</note> Again we would like to stress, we do not advise the use of this API and if possible we would prefer to improve Cogl than have developers require raw -OpenGL." - version="1.0"> +OpenGL. + + + + + + Parses an image file enough to extract the width and height +of the bitmap. - + %TRUE if the image was successfully parsed + + the file to check - + transfer-ownership="full"> + return location for the bitmap width, or %NULL + - + transfer-ownership="full"> + return location for the bitmap height, or %NULL + - - + Loads an image file from disk. This function can be safely called from +within a thread. +%NULL if loading the image failed. + + a #CoglBitmap to the new loaded image data, or + + the file to load. - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Check whether @name occurs in list of extensions in @ext. not appropriate to expose OpenGL extensions through the Cogl API. This function can be replaced by the following equivalent code: |[ -]|" - deprecated="OpenGL is an implementation detail for Cogl and so it's" - deprecated-version="1.2"> +]| - + %TRUE if the extension occurs in the list, %FALSE otherwise. + + extension to check for + list of extensions - + + Clears all the auxiliary buffers identified in the @buffers mask, and if +that includes the color buffer then the specified @color is used. + Background color to clear to - - + + A mask of #CoglBufferBit<!-- -->'s identifying which auxiliary buffers to clear + + Ensures that the current clipping region has been set in GL. This +will automatically be called before any Cogl primitives but it +maybe be neccessary to call if you are using raw GL calls with +clipping. - + + Reverts the clipping region to the state before the last call to +cogl_clip_push(). + Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle will be clipped so that only the portion inside the rectangle will be displayed. The rectangle dimensions are transformed by the @@ -1755,315 +3251,345 @@ The rectangle is intersected with the current clip region. To undo the effect of this function, call cogl_clip_pop(). with other API that specify rectangles in model space, and when used with a coordinate space that puts the origin at the center and y+ -extending up, it's awkward to use. Please use cogl_clip_push_rectangle() -instead" - deprecated="The x, y, width, height arguments are inconsistent" - deprecated-version="1.2"> +extending up, it's awkward to use. Please use cogl_clip_push_rectangle() +instead - + left edge of the clip rectangle + - + top edge of the clip rectangle + - + width of the clip rectangle + - + height of the clip rectangle + + Sets a new clipping area using the current path. The current path is then cleared. The clipping area is intersected with the previous clipping area. To restore the previous clipping area, call -cogl_clip_pop()." - version="1.0"> +cogl_clip_pop(). + Sets a new clipping area using the current path. The current path is then cleared. The clipping area is intersected with the previous clipping area. To restore the previous clipping area, call -cogl_clip_pop()." - version="1.0"> +cogl_clip_pop(). + Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle will be clipped so that only the portion inside the rectangle will be displayed. The rectangle dimensions are transformed by the current model-view matrix. The rectangle is intersected with the current clip region. To undo -the effect of this function, call cogl_clip_pop()." - version="1.2"> +the effect of this function, call cogl_clip_pop(). - + x coordinate for top left corner of the clip rectangle + - + y coordinate for top left corner of the clip rectangle + - + x coordinate for bottom right corner of the clip rectangle + - + y coordinate for bottom right corner of the clip rectangle + + Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle will be clipped so that only the portion inside the rectangle will be displayed. The rectangle dimensions are not transformed by the current model-view matrix. The rectangle is intersected with the current clip region. To undo -the effect of this function, call cogl_clip_pop()." - deprecated="Use cogl_clip_push_window_rectangle() instead" - deprecated-version="1.2"> +the effect of this function, call cogl_clip_pop(). - + left edge of the clip rectangle in window coordinates + - + top edge of the clip rectangle in window coordinates + - + width of the clip rectangle + - + height of the clip rectangle + + Specifies a rectangular clipping area for all subsequent drawing operations. Any drawing commands that extend outside the rectangle will be clipped so that only the portion inside the rectangle will be displayed. The rectangle dimensions are not transformed by the current model-view matrix. The rectangle is intersected with the current clip region. To undo -the effect of this function, call cogl_clip_pop()." - version="1.2"> +the effect of this function, call cogl_clip_pop(). - + left edge of the clip rectangle in window coordinates + - + top edge of the clip rectangle in window coordinates + - + width of the clip rectangle + - + height of the clip rectangle + + Restore the state of the clipping stack that was previously saved +by cogl_clip_stack_save(). +the clip stack when switching back from an offscreen framebuffer, +but it's not necessary anymore given that framebuffers now own +separate clip stacks which will be automatically switched between +when a new buffer is set. Calling this function has no effect + Save the entire state of the clipping stack and then clear all clipping. The previous state can be returned to with cogl_clip_stack_restore(). Each call to cogl_clip_push() after this must be matched by a call to cogl_clip_pop() before calling cogl_clip_stack_restore(). -clip stack when switching to an offscreen framebuffer, but it's +clip stack when switching to an offscreen framebuffer, but it's not necessary anymore given that framebuffers now own separate clip stacks which will be automatically switched between when a -new buffer is set. Calling this function has no effect" - version="0.8.2" - deprecated="This was originally added to allow us to save the" - deprecated-version="1.2"> +new buffer is set. Calling this function has no effect - + Compares two #CoglColor<!-- -->s and checks if they are the same. This function can be passed to g_hash_table_new() as the @key_equal_func -parameter, when using #CoglColor<!-- -->s as keys in a #GHashTable." - version="1.0"> +parameter, when using #CoglColor<!-- -->s as keys in a #GHashTable. - + %TRUE if the two colors are the same. + - + a #CoglColor + - + a #CoglColor + + + Creates a new (empty) color +to free the allocated resources + + a newly-allocated #CoglColor. Use cogl_color_free() + + + - + introspectable="0"> + Create a new cogl program object that can be used to replace parts of the GL +rendering pipeline with custom code. + + a new cogl program. - + introspectable="0"> + Create a new shader handle, use #cogl_shader_source to set the source code +to be used on it. + + a new shader handle. + COGL_SHADER_TYPE_VERTEX or COGL_SHADER_TYPE_FRAGMENT. - + + This function disables fogging, so primitives drawn afterwards will not be +blended with any previously set fog color. - + - + - + - + - + - + - + - + + This is the counterpart to cogl_begin_gl() used to delimit blocks of drawing +code using raw OpenGL. Please refer to cogl_begin_gl() for full details. - + Checks whether the given COGL features are available. Multiple +features can be checked for by or-ing them together with the '|' operator. %TRUE is only returned if all of the requested features -are available."> +are available. - + %TRUE if the features are available, %FALSE otherwise. + + A bitmask of features to check for - - + + Computes the arc tangent of @a. + + the arc tangent of the passed value, in fixed point notation + a #CoglFixed number + + + + + + Computes the arc tangent of @a / @b but uses the sign of both +arguments to return the angle in right quadrant. +notation + + the arc tangent of the passed fraction, in fixed point + + + + + the numerator as a #CoglFixed number + the denominator as a #CoglFixed number - - - - - - - - - - - - + + Computes the cosine of @angle. + + the cosine of the passed angle, in fixed point notation + a #CoglFixed number - + @@ -2075,23 +3601,28 @@ notation" - + + + + + + Calculates base 2 logarithm. This function is some 2.5 times faster on x86, and over 12 times faster on -fpu-less arm, than using libc log()." - version="1.0"> - +fpu-less arm, than using libc log(). + + base 2 logarithm. - + value to calculate base 2 logarithm from + - + @@ -2104,7 +3635,7 @@ fpu-less arm, than using libc log()." - + @@ -2119,80 +3650,80 @@ fpu-less arm, than using libc log()." - + + Calculates @x to the @y power. - + the power of @x to the @y + - + base + + #CoglFixed exponent - + Calculates 2 to the @x power. This function is around 11 times faster on x86, and around 22 times faster -on fpu-less arm than libc pow(2, x)." - version="1.0"> +on fpu-less arm than libc pow(2, x). - + the power of 2 to the passed value + + a #CoglFixed number - - + + Computes the sine of @angle. + + the sine of the passed angle, in fixed point notation + a #CoglFixed number - - + + Computes the square root of @x. +notation + + the square root of the passed value, in floating point + a #CoglFixed number - - + + Computes the tangent of @angle. + + the tangent of the passed angle, in fixed point notation + a #CoglFixed number - + This function should only need to be called in exceptional circumstances. As an optimization Cogl drawing functions may batch up primitives internally, so if you are trying to use raw GL outside of Cogl you stand a better chance of being successful if you ask Cogl to flush any batched @@ -2207,54 +3738,57 @@ If you are making state changes with the intention of affecting Cogl drawing primitives you are 100% on your own since you stand a good chance of conflicting with Cogl internals. For example clutter-gst which currently uses direct GL calls to bind ARBfp programs will very likely break when Cogl -starts to use ARBfb programs itself for the material API." - version="1.0"> +starts to use ARBfb programs itself for the material API. - + + Replaces the current projection matrix with a perspective matrix +for the given viewing frustum. - + Left clipping plane + - + Right clipping plane + - + Bottom clipping plane + - + Top clipping plane + - + Nearest visible point + - + Furthest visible point along the z-axis + + c:identifier="cogl_get_backface_culling_enabled"> + Queries if backface culling has been enabled via +cogl_set_backface_culling_enabled() - + %TRUE if backface culling is enabled, and %FALSE otherwise + - + Gets the number of bitplanes used for each of the color components in the color buffer. Pass %NULL for any of the arguments if the -value is not required."> +value is not required. @@ -2262,51 +3796,56 @@ value is not required."> - + transfer-ownership="full"> + Return location for the number of red bits or %NULL + - + transfer-ownership="full"> + Return location for the number of green bits or %NULL + - + transfer-ownership="full"> + Return location for the number of blue bits or %NULL + - + transfer-ownership="full"> + Return location for the number of alpha bits or %NULL + + deprecated="Use cogl_material_get_depth_test_enabled()" + deprecated-version="1.4"> + Queries if depth testing has been enabled via cogl_set_depth_test_enable() +instead. - + %TRUE if depth testing is enabled, and %FALSE otherwise + - + Returns all of the features supported by COGL. + + A logical OR of all the supported COGL features. + c:identifier="cogl_get_modelview_matrix"> + Stores the current model-view matrix in @matrix. @@ -2314,40 +3853,60 @@ value is not required."> + transfer-ownership="none"> + return location for the model-view matrix + Retrieves the #GOptionGroup used by COGL to parse the command line options. Clutter uses this to handle the COGL command line -options during its initialization process." - version="1.0"> - +options during its initialization process. + + a #GOptionGroup + + Gets a pointer to the current path. The path can later be used +again by calling cogl_path_set(). Note that the path isn't copied +so if you later call any functions to add to the path it will +affect the returned object too. No reference is taken on the path +so if you want to retain it you should take your own reference with +cogl_object_ref(). + + a pointer to the current path. + + + + Gets a pointer to a given GL or GL ES extension function. This acts as a wrapper around glXGetProcAddress() or whatever is the appropriate function for the current backend. -function is not available."> - +function is not available. + + a pointer to the requested function or %NULL if the + the name of the function. + c:identifier="cogl_get_projection_matrix"> + Stores the current projection matrix in @matrix. @@ -2355,17 +3914,16 @@ function is not available."> + transfer-ownership="none"> + return location for the projection matrix - + Stores the current viewport in @v. @v[0] and @v[1] get the x and y position of the viewport and @v[2] and @v[3] get the width and -height."> +height. @@ -2373,71 +3931,167 @@ height."> + transfer-ownership="full"> + pointer to a 4 element array of #float<!-- -->s to receive the viewport dimensions. - + - + - + + + + + Increases the reference count of @handle by 1 + + the handle, with its reference count increased + + a #CoglHandle - + + Drecreases the reference count of @handle by 1; if the reference +count reaches 0, the resources allocated by @handle will be freed - + + a #CoglHandle + + + + + + Checks whether @handle is a #CoglHandle for a bitmap +and %FALSE otherwise + + %TRUE if the passed handle represents a bitmap, + + + + + a #CoglHandle for a bitmap - + - - + + - + + Gets whether the given handle references an existing material object. +%FALSE otherwise - + %TRUE if the handle references a #CoglMaterial, + + A CoglHandle - + Determines whether the given #CoglHandle references an offscreen buffer object. -%FALSE otherwise"> +%FALSE otherwise - + %TRUE if the handle references an offscreen buffer, + + + + + A CoglHandle for an offscreen buffer + + + + + + Gets whether the given handle references an existing path object. +%FALSE otherwise + + %TRUE if the handle references a #CoglPath, + + + + + A CoglHandle + + + + + + + + + + + + + + + + Gets whether the given handle references an existing program object. +%FALSE otherwise + + %TRUE if the handle references a program, + + + + + A CoglHandle + + + + + + Gets whether the given handle references an existing shader object. +%FALSE otherwise + + %TRUE if the handle references a shader, + + + + + A CoglHandle + + + + + + Gets whether the given handle references an existing texture object. +%FALSE otherwise + + %TRUE if the handle references a texture, and + + + + + A CoglHandle + + + + + + + @@ -2445,63 +4099,10 @@ object. - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -2511,236 +4112,89 @@ otherwise" + Checks whether @handle is a Vertex Buffer Object +otherwise - + %TRUE if the handle is a VBO, and %FALSE + + a #CoglHandle for a vertex buffer object - - - - - - - - - - - + + Checks whether @handle is a handle to the indices for a vertex +buffer object +otherwise - + %TRUE if the handle is indices, and %FALSE + - + + a #CoglHandle - - - - + + Get the size of points drawn when %COGL_VERTICES_MODE_POINTS is +used with the vertex buffer API. - + the point size of the material. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a #CoglHandle to a material. + Retrieves the type of the layer Currently there is only one type of layer defined: %COGL_MATERIAL_LAYER_TYPE_TEXTURE, but considering we may add purely GLSL based layers in the future, you should write code that checks the type -first."> - +first. + + the type of the layer - + A #CoglMaterialLayer object + - - + introspectable="0"> + Allocates and initializes a blank white material + + a pointer to a new #CoglMaterial + - + Increment the reference count for a #CoglMaterial. + + the @material. @@ -2749,507 +4203,35 @@ first."> - + + Changes the size of points drawn when %COGL_VERTICES_MODE_POINTS is +used with the vertex buffer API. Note that typically the GPU will +only support a limited minimum and maximum range of point sizes. If +the chosen point size is outside that range then the nearest value +within that range will be used instead. The size of a point is in +screen space so it will be the same regardless of any +transformations. The default point size is 1.0. + a #CoglHandle to a material. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Decrement the reference count for a #CoglMaterial. @@ -3259,302 +4241,380 @@ The default value is (0.0, 0.0, 0.0, 1.0)" + + Compares two matrices to see if they represent the same +transformation. Although internally the matrices may have different +annotations associated with them and may potentially have a cached +inverse matrix these are not considered in the comparison. + + + + + + A 4x4 transformation matrix + + + + A 4x4 transformation matrix + + + + + + Increases the reference count of @handle by 1 + + the @object, with its reference count increased + + + + + a #CoglObject + + + + + + Drecreases the reference count of @object by 1; if the reference +count reaches 0, the resources allocated by @object will be freed + + + + + + a #CoglObject + + + + + This creates an offscreen buffer object using the given texture as the +primary color buffer. It doesn't just initialize the contents of the offscreen buffer with the texture; they are tightly bound so that drawing to the offscreen buffer effectivly updates the contents of the -given texture. You don't need to destroy the offscreen buffer before +given texture. You don't need to destroy the offscreen buffer before you can use the texture again. -if it wasn't possible to create the buffer."> +buffer or %COGL_INVALID_HANDLE if it wasn't possible to create the +buffer. + a #CoglHandle for the new offscreen + A CoglHandle for a Cogl texture - + Increments the reference count on the offscreen buffer. + + For convenience it returns the given CoglHandle + A CoglHandle for an offscreen buffer + Decreases the reference count for the offscreen buffer and frees it when +the count reaches 0. + A CoglHandle for an offscreen buffer - + + Replaces the current projection matrix with an orthographic projection +matrix. See <xref linkend="cogl-ortho-matrix"/> to see how the matrix is +calculated. +<figure id="cogl-ortho-matrix"> +<title></title> +<graphic fileref="cogl_ortho.png" format="PNG"/> +</figure> +<note>This function copies the arguments from OpenGL's glOrtho() even +though they are unnecessarily confusing due to the z near and z far +arguments actually being a "distance" from the origin, where +negative values are behind the viewer, instead of coordinates for +the z clipping planes which would have been consistent with the +left, right bottom and top arguments.</note> - + The coordinate for the left clipping plane + - + The coordinate for the right clipping plane + - + The coordinate for the bottom clipping plane + - + The coordinate for the top clipping plane + - - + + The <emphasis>distance</emphasis> to the near clipping plane (negative if the plane is behind the viewer) + - - + + The <emphasis>distance</emphasis> for the far clipping plane (negative if the plane is behind the viewer) + - + Adds an elliptical arc segment to the current path. A straight line segment will link the current pen location with the first vertex of the arc. If you perform a move_to to the arcs start just before drawing it you create a free standing arc. The angles are measured in degrees where 0° is in the direction of the positive X axis and 90° is in the direction of the positive Y axis. The angle of the arc begins at @angle_1 and heads towards -otherwise it will increase)."> +otherwise it will increase). - + X coordinate of the elliptical arc center + - + Y coordinate of the elliptical arc center + - + X radius of the elliptical arc + - + Y radius of the elliptical arc + - + Angle in degrees at which the arc begin + - + Angle in degrees at which the arc ends + - + + Closes the path being constructed by adding a straight line segment +to it that ends at the first vertex of the path. - + Adds a cubic bezier curve segment to the current path with the given second, third and fourth control points and using current pen location -as the first control point."> +as the first control point. - + X coordinate of the second bezier control point + - + Y coordinate of the second bezier control point + - + X coordinate of the third bezier control point + - + Y coordinate of the third bezier control point + - + X coordinate of the fourth bezier control point + - + Y coordinate of the fourth bezier control point + - + + Constructs an ellipse shape. If there is an existing path this will +start a new disjoint sub-path. - + X coordinate of the ellipse center + - + Y coordinate of the ellipse center + - + X radius of the ellipse + - + Y radius of the ellipse + - + Fills the interior of the constructed shape using the current drawing color. The current path is then cleared. To use the path again, call cogl_path_fill_preserve() instead. -The interior of the shape is determined using the 'even-odd' -rule. Any open sub-paths are treated as if there is an extra line -joining the last point and first point. You can work out whether -any point in the stage will be filled if you imagine drawing an -infinitely long line in any direction from that point and then -counting the number times it crosses a line in the path. If the -number is odd it will be filled, otherwise it will not. -See <xref linkend="fill-rule"/> for a demonstration of the fill -rule. -<figure id="fill-rule"> -<title>Example of filling various paths</title> -<graphic fileref="fill-rule.png" format="PNG"/> -</figure>"> +The interior of the shape is determined using the fill rule of the +path. See %CoglPathFillRule for details. + Fills the interior of the constructed shape using the current drawing color and preserves the path to be used again. See cogl_path_fill() for a description what is considered the interior -of the shape." - version="1.0"> +of the shape. - + Retrieves the fill rule set using cogl_path_set_fill_rule(). + + the fill rule that is used for the current path. + + + + + Constructs a straight line shape starting and ending at the given coordinates. If there is an existing path this will start a new -disjoint sub-path."> +disjoint sub-path. - + X coordinate of the start line vertex + - + Y coordinate of the start line vertex + - + X coordinate of the end line vertex + - + Y coordinate of the end line vertex + - + + Adds a straight line segment to the current path that ends at the +given coordinates. - + X coordinate of the end line vertex + - + Y coordinate of the end line vertex + - + + Moves the pen to the given location. If there is an existing path +this will start a new disjoint subpath. - + X coordinate of the pen location to move to. + - + Y coordinate of the pen location to move to. + - + + Clears the current path and starts a new one. Creating a new path +also resets the fill rule to the default which is +%COGL_PATH_FILL_RULE_EVEN_ODD. - + Constructs a polygonal shape of the given number of vertices. If there is an existing path this will start a new disjoint sub-path. The coords array must contain 2 * num_points values. The first value represents the X coordinate of the first vertex, the second value represents the Y coordinate of the first vertex, continuing in the same -fashion for the rest of the vertices."> +fashion for the rest of the vertices. - + + A pointer to the first element of an array of fixed-point values that specify the vertex coordinates. - + - + The total number of vertices. + - + Constructs a series of straight line segments, starting from the first given vertex coordinate. If there is an existing path this will start a new disjoint sub-path. Each subsequent segment starts where the previous one ended and ends at the next given vertex @@ -3563,263 +4623,236 @@ The coords array must contain 2 * num_points values. The first value represents the X coordinate of the first vertex, the second value represents the Y coordinate of the first vertex, continuing in the same fashion for the rest of the vertices. (num_points - 1) segments will -be constructed."> +be constructed. - + + A pointer to the first element of an array of fixed-point values that specify the vertex coordinates. - + - + The total number of vertices. + - + + Constructs a rectangular shape at the given coordinates. If there +is an existing path this will start a new disjoint sub-path. - + X coordinate of the top-left corner. + - + Y coordinate of the top-left corner. + - + X coordinate of the bottom-right corner. + - + Y coordinate of the bottom-right corner. + - + Adds a cubic bezier curve segment to the current path with the given second, third and fourth control points and using current pen location as the first control point. The given coordinates are relative to the -current pen location."> +current pen location. - + X coordinate of the second bezier control point + - + Y coordinate of the second bezier control point + - + X coordinate of the third bezier control point + - + Y coordinate of the third bezier control point + - + X coordinate of the fourth bezier control point + - + Y coordinate of the fourth bezier control point + - + + Adds a straight line segment to the current path that ends at the +given coordinates relative to the current pen location. - + X offset from the current pen location of the end line vertex + - + Y offset from the current pen location of the end line vertex + - + Moves the pen to the given offset relative to the current pen location. If there is an existing path this will start a new -disjoint subpath."> +disjoint subpath. - + X offset from the current pen location to move the pen to. + - + Y offset from the current pen location to move the pen to. + + c:identifier="cogl_path_round_rectangle"> + Constructs a rectangular shape with rounded corners. If there is an +existing path this will start a new disjoint sub-path. - + X coordinate of the top-left corner. + - + Y coordinate of the top-left corner. + - + X coordinate of the bottom-right corner. + - + Y coordinate of the bottom-right corner. + - + Radius of the corner arcs. + - - + + Angle increment resolution for subdivision of the corner arcs. + - + Sets the fill rule of the current path to @fill_rule. This will +affect how the path is filled when cogl_path_fill() is later +called. Note that the fill rule state is attached to the path so +calling cogl_get_path() will preserve the fill rule and calling +cogl_path_new() will reset the fill rule back to the default. + + + + + + The new fill rule. + + + + + + Strokes the constructed shape using the current drawing color and a width of 1 pixel (regardless of the current transformation matrix). To current path is then cleared. To use the path again, -call cogl_path_stroke_preserve() instead."> +call cogl_path_stroke_preserve() instead. + Strokes the constructed shape using the current drawing color and +preserves the path to be used again. - + + Replaces the current projection matrix with a perspective matrix +based on the provided values. - + Vertical of view angle in degrees. + - + Aspect ratio of diesplay + - + Nearest visible point + - + Furthest visible point along the z-axis + - - - - - - - - - - - - - - - - - - - - - - - + + + - + - + - - + + - - - - - - - - - - - - - - - - - - - - + Draws a convex polygon using the current source material to fill / texture with according to the texture coordinates passed. If @use_color is %TRUE then the color will be changed for each vertex using the value specified in the color member of #CoglTextureVertex. This can be @@ -3830,268 +4863,442 @@ texture is not supported. Because of the way this function is implemented it will currently only work if either the texture is not sliced or the backend is not OpenGL ES and the minifying and magnifying functions are both set -to COGL_MATERIAL_FILTER_NEAREST." - version="1.0"> +to COGL_MATERIAL_FILTER_NEAREST. + An array of #CoglTextureVertex structs - + The length of the vertices array + - + %TRUE if the color member of #CoglTextureVertex should be used + + Restore cogl_set_draw_buffer() state. + Restores the framebuffer that was previously at the top of the stack. +All subsequent drawing will be redirected to this framebuffer. - + + Restores the current model-view matrix from the matrix stack. + c:identifier="cogl_program_attach_shader"> + Attaches a shader to a program object, a program can have one vertex shader +and one fragment shader attached. + a #CoglHandle for a shdaer program. + a #CoglHandle for a vertex of fragment shader. + Retrieve the location (offset) of a uniform variable in a shader program, a uniform is a variable that is constant for all vertices/fragments for a shader object and is possible to modify as an external parameter. This uniform can be set using cogl_program_uniform_1f() when the -program is in use."> +program is in use. - + the offset of a uniform in a specified program. + + a #CoglHandle for a shader program. + the name of a uniform. - + + Links a program making it ready for use. + a #CoglHandle for a shader program. - + introspectable="0"> + Add an extra reference to a program. + + @handle + A #CoglHandle to a program. + + Changes the value of a floating point uniform for the given linked + + + + + + A #CoglHandle for a linked program + + + + the uniform location retrieved from cogl_program_get_uniform_location(). + + + + the new value of the uniform. + + + + + + Changes the value of an integer uniform for the given linked + + + + + + A #CoglHandle for a linked program + + + + the uniform location retrieved from cogl_program_get_uniform_location(). + + + + the new value of the uniform. + + + + + + Changes the value of a float vector uniform, or uniform array for +the given linked @program. + + + + + + A #CoglHandle for a linked program + + + + the uniform location retrieved from cogl_program_get_uniform_location(). + + + + The number of components for the uniform. For example with glsl you'd use 3 for a vec3 or 4 for a vec4. + + + + For uniform arrays this is the array length otherwise just pass 1 + + + + the new value of the uniform[s]. + + + + + + + + Changes the value of a int vector uniform, or uniform array for +the given linked @program. + + + + + + A #CoglHandle for a linked program + + + + the uniform location retrieved from cogl_program_get_uniform_location(). + + + + The number of components for the uniform. For example with glsl you'd use 3 for a vec3 or 4 for a vec4. + + + + For uniform arrays this is the array length otherwise just pass 1 + + + + the new value of the uniform[s]. + + + + + + + + Changes the value of a matrix uniform, or uniform array in the +given linked @program. + + + + + + A #CoglHandle for a linked program + + + + the uniform location retrieved from cogl_program_get_uniform_location(). + + + + The dimensions of the matrix. So for for example pass 2 for a 2x2 matrix or 3 for 3x3. + + + + For uniform arrays this is the array length otherwise just pass 1 + + + + Whether to transpose the matrix when setting the uniform. + + + + the new value of the uniform. + + + + + + + deprecated="Use cogl_program_set_uniform_1f() instead." + deprecated-version="1.4"> + Changes the value of a floating point uniform in the currently +used (see cogl_program_use()) shader program. - + the uniform to set. + - + the new value of the uniform. + + deprecated="Use cogl_program_set_uniform_1i() instead." + deprecated-version="1.4"> + Changes the value of an integer uniform in the currently +used (see cogl_program_use()) shader program. - + the uniform to set. + - + the new value of the uniform. + + deprecated="Use cogl_program_set_uniform_float() instead." + deprecated-version="1.4"> + Changes the value of a float vector uniform, or uniform array in the +currently used (see cogl_program_use()) shader program. - + the uniform to set. + - + Size of float vector. + - + Size of array of uniforms. + - - - + + the new value of the uniform. + + + c:identifier="cogl_program_uniform_int"> + Changes the value of a int vector uniform, or uniform array in the +currently used (see cogl_program_use()) shader program. - + the uniform to set. + - + Size of int vector. + - + Size of array of uniforms. + - + + the new value of the uniform. - + + Changes the value of a matrix uniform, or uniform array in the currently used (see cogl_program_use()) shader program. The @size -parameter is used to determine the square size of the matrix."> +parameter is used to determine the square size of the matrix. - + the uniform to set. + - + Size of matrix. + - + Size of array of uniforms. + - + Whether to transpose the matrix when setting the uniform. + - + + the new value of the uniform. - + - + + Removes a reference to a program. If it was the last reference the +program object will be destroyed. + A #CoglHandle to a program. - + Activate a specific shader program replacing that part of the GL rendering pipeline, if passed in %COGL_INVALID_HANDLE the default -behavior of GL is reinstated."> +behavior of GL is reinstated. + a #CoglHandle for a shader program or %COGL_INVALID_HANDLE. + Save cogl_set_draw_buffer() state. + Redirects all subsequent drawing to the specified framebuffer. This can either be an offscreen buffer created with cogl_offscreen_new_to_texture () or in the future it may be an onscreen framebuffer too. You should understand that a framebuffer owns the following state: <itemizedlist> -<li>The projection matrix</li> -<li>The modelview matrix stack</li> -<li>The viewport</li> -<li>The clip stack</li> +<listitem><simpara>The projection matrix</simpara></listitem> +<listitem><simpara>The modelview matrix stack</simpara></listitem> +<listitem><simpara>The viewport</simpara></listitem> +<listitem><simpara>The clip stack</simpara></listitem> </itemizedlist> So these items will automatically be saved and restored when you push and pop between different framebuffers. @@ -4117,348 +5324,364 @@ CoglMatrix projection_matrix; CoglMatrix mv_matrix; cogl_set_viewport (0, 0, width, height); cogl_perspective (fovy, aspect, z_near, z_far); -cogl_get_projection_matrix (&projection_matrix); +cogl_get_projection_matrix (&amp;projection_matrix); z_camera = 0.5 * projection_matrix.xx; -cogl_matrix_init_identity (&mv_matrix); -cogl_matrix_translate (&mv_matrix, -0.5f, -0.5f, -z_camera); -cogl_matrix_scale (&mv_matrix, 1.0f / width, -1.0f / height, 1.0f / width); -cogl_matrix_translate (&mv_matrix, 0.0f, -1.0 * height, 0.0f); -cogl_set_modelview_matrix (&mv_matrix); +cogl_matrix_init_identity (&amp;mv_matrix); +cogl_matrix_translate (&amp;mv_matrix, -0.5f, -0.5f, -z_camera); +cogl_matrix_scale (&amp;mv_matrix, 1.0f / width, -1.0f / height, 1.0f / width); +cogl_matrix_translate (&amp;mv_matrix, 0.0f, -1.0 * height, 0.0f); +cogl_set_modelview_matrix (&amp;mv_matrix); } static void -my_init_framebuffer (CoglHandle framebuffer, +my_init_framebuffer (ClutterStage *stage, +CoglFramebuffer *framebuffer, unsigned int framebuffer_width, unsigned int framebuffer_height) { -ClutterActor *stage = clutter_stage_get_default (); ClutterPerspective perspective; -clutter_stage_get_perspective (CLUTTER_STAGE (stage), &perspective); +clutter_stage_get_perspective (stage, &perspective); cogl_push_framebuffer (framebuffer); setup_viewport (framebuffer_width, framebuffer_height, -perspective->fovy, +perspective.fovy, perspective.aspect, perspective.z_near, perspective.z_far); -cogl_pop_framebuffer (); } ]| -The previous framebuffer can be restored by calling cogl_pop_framebuffer()" - version="1.2"> +The previous framebuffer can be restored by calling cogl_pop_framebuffer() - - + + A #CoglFramebuffer object, either onscreen or offscreen. + - + + Stores the current model-view matrix on the matrix stack. The matrix +can later be restored with cogl_pop_matrix(). - + This reads a rectangle of pixels from the current framebuffer where position (0, 0) is the top left. The pixel at (x, y) is the first read, and the data is returned with a rowstride of (width * 4). Currently Cogl assumes that the framebuffer is in a premultiplied format so if @format is non-premultiplied it will convert it. To read the pixel values without any conversion you should either -specify a format that doesn't use an alpha channel or use one of -the formats ending in PRE."> +specify a format that doesn't use an alpha channel or use one of +the formats ending in PRE. - + The window x position to start reading from + - + The window y position to start reading from + - + The width of the rectangle you want to read + - + The height of the rectangle you want to read + - + + Identifies which auxillary buffer you want to read (only COGL_READ_PIXELS_COLOR_BUFFER supported currently) - + + The pixel format you want the result in (only COGL_PIXEL_FORMAT_RGBA_8888 supported currently) - - - + The location to write the pixel data. + - + + Fills a rectangle at the given coordinates with the current source material - + X coordinate of the top-left corner + - + Y coordinate of the top-left corner + - + X coordinate of the bottom-right corner + - + Y coordinate of the bottom-right corner + + This function draws a rectangle using the current source material to texture or fill with. As a material may contain multiple texture layers this interface lets you supply texture coordinates for each layer of the material. The first pair of coordinates are for the first layer (with the smallest layer index) and if you supply less texture coordinates than there are layers in the current source material then default texture coordinates -(0.0, 0.0, 1.0, 1.0) are generated." - version="1.0"> +(0.0, 0.0, 1.0, 1.0) are generated. - + x coordinate upper left on screen. + - + y coordinate upper left on screen. + - + x coordinate lower right on screen. + - + y coordinate lower right on screen. + - + + An array containing groups of 4 float values: [tx1, ty1, tx2, ty2] that are interpreted as two texture coordinates; one for the upper left texel, and one for the lower right texel. Each value should be between 0.0 and 1.0, where the coordinate (0.0, 0.0) represents the top left of the texture, and (1.0, 1.0) the bottom right. - + - - + + The length of the tex_coords array. (e.g. for one layer and one group of texture coordinates, this would be 4) + + Draw a rectangle using the current material and supply texture coordinates +to be used for the first texture layer of the material. To draw the entire +texture pass in @tx1=0.0 @ty1=0.0 @tx2=1.0 @ty2=1.0. - + x coordinate upper left on screen. + - + y coordinate upper left on screen. + - + x coordinate lower right on screen. + - + y coordinate lower right on screen. + - + x part of texture coordinate to use for upper left pixel + - + y part of texture coordinate to use for upper left pixel + - + x part of texture coordinate to use for lower right pixel + - + y part of texture coordinate to use for left pixel + - + Draws a series of rectangles in the same way that cogl_rectangle() does. In some situations it can give a significant performance boost to use this function rather than calling cogl_rectangle() separately for each rectangle. parameters x1, y1, x2, and y2, and have the same -meaning as in cogl_rectangle()." - version="1.0"> +meaning as in cogl_rectangle(). - + + an array of vertices - + - + number of rectangles to draw + + Draws a series of rectangles in the same way that cogl_rectangle_with_texture_coords() does. In some situations it can give a significant performance boost to use this function rather than calling cogl_rectangle_with_texture_coords() separately for each rectangle. parameters x1, y1, x2, y2, tx1, ty1, tx2 and ty2 and have the same -meaning as in cogl_rectangle_with_texture_coords()." - version="0.8.6"> +meaning as in cogl_rectangle_with_texture_coords(). - + + an array of vertices - + - + number of rectangles to draw + - + Multiplies the current model-view matrix by one that rotates the model around the vertex specified by @x, @y and @z. The rotation follows the right-hand thumb rule so for example rotating by 10 degrees about the vertex (0, 0, 1) causes a small counter-clockwise -rotation."> +rotation. - + Angle in degrees to rotate. + - + X-component of vertex to rotate around. + - + Y-component of vertex to rotate around. + - + Z-component of vertex to rotate around. + - + + Multiplies the current model-view matrix by one that scales the x, +y and z axes by the given values. - + Amount to scale along the x-axis + - + Amount to scale along the y-axis + - + Amount to scale along the z-axis + + Sets whether textures positioned so that their backface is showing should be hidden. This can be used to efficiently draw two-sided textures or fully closed cubes without enabling depth testing. This only affects calls to the cogl_rectangle* family of functions and -cogl_vertex_buffer_draw*. Backface culling is disabled by default."> +cogl_vertex_buffer_draw*. Backface culling is disabled by default. - + %TRUE to enable backface culling or %FALSE to disable. + + Sets whether depth testing is enabled. If it is disabled then the order that actors are layered on the screen depends solely on the order specified using clutter_actor_raise() and clutter_actor_lower(), otherwise it will also take into account the -actor's depth. Depth testing is disabled by default."> +actor's depth. Depth testing is disabled by default. +instead. - + %TRUE to enable depth testing or %FALSE to disable. + + Redirects all subsequent drawing to the specified framebuffer. This can either be an offscreen buffer created with cogl_offscreen_new_to_texture () or you can revert to your original on screen window buffer. -the type of CoglHandle given instead." - deprecated="The target argument was redundant since we could look at" - deprecated-version="1.2"> +the type of CoglHandle given instead. - + + A #CoglBufferTarget that specifies what kind of framebuffer you are setting as the render target. - + + If you are setting a framebuffer of type COGL_OFFSCREEN_BUFFER then this is a CoglHandle for the offscreen buffer. - + Enables fogging. Fogging causes vertices that are further away from the eye to be rendered with a different color. The color is determined according to -the chosen fog mode; at it's simplest the color is linearly interpolated so +the chosen fog mode; at it's simplest the color is linearly interpolated so that vertices at @z_near are drawn fully with their original color and vertices at @z_far are drawn fully with @fog_color. Fogging will remain enabled until you call cogl_disable_fog(). @@ -4468,163 +5691,190 @@ and cogl_set_source_color() will premultiply colors, so unless you explicitly load your textures requesting an unmultiplied internal format and use cogl_material_set_color() you can only use fogging with fully opaque primitives. This might improve in the future when we can depend -on fragment shaders.</note>"> +on fragment shaders.</note> + The color of the fog - + + A #CoglFogMode that determines the equation used to calculate the fogging blend factor. - - + + Used by %COGL_FOG_MODE_EXPONENTIAL and by %COGL_FOG_MODE_EXPONENTIAL_SQUARED equations. + - + Position along Z axis where no fogging should be applied + - + Position along Z axis where full fogging should be applied + + This redirects all subsequent drawing to the specified framebuffer. This can +either be an offscreen buffer created with cogl_offscreen_new_to_texture () +or in the future it may be an onscreen framebuffers too. - - + + A #CoglFramebuffer object, either onscreen or offscreen. + + c:identifier="cogl_set_modelview_matrix"> + Loads @matrix as the new model-view matrix. + the new model-view matrix + + Replaces the current path with @path. A reference is taken on the +object so if you no longer need the path you should unref with +cogl_object_unref(). + + + + + + A #CoglPath object + + + + + c:identifier="cogl_set_projection_matrix"> + Loads matrix as the new projection matrix. + the new projection matrix - + This function sets the source material that will be used to fill subsequent geometry emitted via the cogl API. <note>In the future we may add the ability to set a front facing material, and a back facing material, in which case this function will set both to the -same.</note>" - version="1.0"> +same.</note> + A #CoglHandle for a material + This is a convenience function for creating a solid fill source material from the given color. This color will be used for any subsequent drawing operation. The color will be premultiplied by Cogl, so the color should be semi-transparent red. See also cogl_set_source_color4ub() and cogl_set_source_color4f() -if you already have the color components." - version="1.0"> +if you already have the color components. + a #CoglColor + This is a convenience function for creating a solid fill source material from the given color using normalized values for each component. This color will be used for any subsequent drawing operation. The value for each component is a fixed point number in the range between 0 and %1.0. If the values passed in are outside that -range, they will be clamped." - version="1.0"> +range, they will be clamped. - + value of the red channel, between 0 and %1.0 + - + value of the green channel, between 0 and %1.0 + - + value of the blue channel, between 0 and %1.0 + - + value of the alpha channel, between 0 and %1.0 + + This is a convenience function for creating a solid fill source material from the given color using unsigned bytes for each component. This color will be used for any subsequent drawing operation. The value for each component is an unsigned byte in the range -between 0 and 255." - version="1.0"> +between 0 and 255. - + value of the red channel, between 0 and 255 + - + value of the green channel, between 0 and 255 + - + value of the blue channel, between 0 and 255 + - + value of the alpha channel, between 0 and 255 + + This is a convenience function for creating a material with the first layer set to #texture_handle and setting that material as the source with cogl_set_source. and cogl_set_source_texture. If you need to blend a texture with a color then @@ -4634,322 +5884,455 @@ material = cogl_material_new (); cogl_material_set_color4ub (material, 0xff, 0x00, 0x00, 0x80); cogl_material_set_layer (material, 0, tex_handle); cogl_set_source (material); -</programlisting>" - version="1.0"> +</programlisting> + The Cogl texture you want as your source + Replaces the current viewport with the given values. - + X offset of the viewport + - + Y offset of the viewport + - + Width of the viewport + - + Height of the viewport + - + + Compiles the shader, no return value, but the shader is now ready for +linking into a program. + #CoglHandle for a shader. + Retrieves the information log for a coglobject, can be used in conjunction with cogl_shader_get_parameteriv() to retrieve the compiler warnings/error messages that caused a shader to not compile correctly, mainly useful for debugging purposes. -g_free() to free it"> +g_free() to free it + a newly allocated string containing the info log. Use + #CoglHandle for a shader. - - + + Retrieves the type of a shader #CoglHandle +or %COGL_SHADER_TYPE_FRAGMENT if the shader is a frament processor + + %COGL_SHADER_TYPE_VERTEX if the shader is a vertex processor + #CoglHandle for a shader. - + + Retrieves whether a shader #CoglHandle has been compiled - + %TRUE if the shader object has sucessfully be compiled + + #CoglHandle for a shader. - + introspectable="0"> + Add an extra reference to a shader. + + @handle + A #CoglHandle to a shader. - + + Replaces the current GLSL source associated with a shader with a new +one. + #CoglHandle for a shader. + GLSL shader source. - + + Removes a reference to a shader. If it was the last reference the +shader object will be destroyed. + A #CoglHandle to a shader. - + Very fast fixed point implementation of square root for integers. This function is at least 6x faster than clib sqrt() on x86, and (this is -not a typo!) about 500x faster on ARM without FPU. It's error is less than +not a typo!) about 500x faster on ARM without FPU. It's error is less than 5% for arguments smaller than %COGL_SQRTI_ARG_5_PERCENT and less than 10% for narguments smaller than %COGL_SQRTI_ARG_10_PERCENT. The maximum -argument that can be passed to this function is %COGL_SQRTI_ARG_MAX." - version="1.0"> +argument that can be passed to this function is %COGL_SQRTI_ARG_MAX. - + integer square root. + - + integer value + - - - + + + - - + + + + + + + + + + + - - + + - - - - + + + + + + + + - - + + + + + + + + + + + + + + + + + + + + + + + + Copies the pixel data from a cogl texture to system memory. +is not valid + + the size of the texture data in bytes, or 0 if the texture + + + + + a #CoglHandle for a texture. + + + + the #CoglPixelFormat to store the texture as. + + + + the rowstride of @data or retrieved from texture if none is specified. + + + + memory location to write contents of buffer, or %NULL if we're only querying the data size through the return value. + + + + + + Queries the #CoglPixelFormat of a cogl texture. + + the #CoglPixelFormat of the GPU side texture + a #CoglHandle for a texture. + Queries the GL handles for a GPU side texture through its #CoglHandle. If the texture is spliced the data for the first sub texture will be queried. -if the handle was invalid"> +if the handle was invalid - + %TRUE if the handle was successfully retrieved, %FALSE + + a #CoglHandle for a texture. + allow-none="1"> + pointer to return location for the textures GL handle, or %NULL. + allow-none="1"> + pointer to return location for the GL target type, or %NULL. - + + Queries the height of a cogl texture. - + the height of the GPU side texture in pixels + + a #CoglHandle for a texture. + c:identifier="cogl_texture_get_max_waste"> + Queries the maximum wasted (unused) pixels in one dimension of a GPU side +texture. - + the maximum waste + + a #CoglHandle for a texture. + c:identifier="cogl_texture_get_rowstride"> + Queries the rowstride of a cogl texture. - + the offset in bytes between each consequetive row of pixels + + a #CoglHandle for a texture. - + + Queries the width of a cogl texture. - + the width of the GPU side texture in pixels + + a #CoglHandle for a texture. - + Queries if a texture is sliced (stored as multiple GPU side tecture objects). -is stored as a single GPU texture"> +is stored as a single GPU texture - + %TRUE if the texture is sliced, %FALSE if the texture + + a #CoglHandle for a texture. - + version="1.0" + introspectable="0"> + Creates a COGL texture from a CoglBitmap. +%COGL_INVALID_HANDLE on failure + + a #CoglHandle to the newly created texture or + A CoglBitmap handle + Optional flags for the texture, or %COGL_TEXTURE_NONE - + + the #CoglPixelFormat to use for the GPU storage of the texture - - + + Creates a new texture using the buffer specified by @handle. If the buffer +has been created using cogl_pixel_buffer_new_for_size() it's possible to omit +the height and width values already specified at creation time. +failure + + a #CoglHandle to the new texture or %COGL_INVALID_HANDLE on + + the #CoglHandle of a pixel buffer + + - + width of texture in pixels or 0 + - + height of texture in pixels or 0 + + + + optional flags for the texture, or %COGL_TEXTURE_NONE + + + + the #CoglPixelFormat the buffer is stored in in RAM + + + + the #CoglPixelFormat that will be used for storing the buffer on the GPU. If %COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here is if you have non-premultiplied source data and are going to adjust the blend mode (see cogl_material_set_blend()) or use the data for something other than straight blending + + + + the memory offset in bytes between the starts of scanlines in @data. If 0 is given the row stride will be deduced from + + + + offset in bytes in @buffer from where the texture data starts + + + + + + + + + + + + + + + + + @@ -4957,49 +6340,89 @@ is stored as a single GPU texture"> - + - - + + + + + + + + + + Creates a new COGL texture based on data residing in memory. +%COGL_INVALID_HANDLE on failure + + a #CoglHandle to the newly created texture or + + + + + width of texture in pixels + + + + height of texture in pixels + + + + Optional flags for the texture, or %COGL_TEXTURE_NONE + + + + the #CoglPixelFormat the buffer is stored in in RAM + + + + the #CoglPixelFormat that will be used for storing the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here is if you have non-premultiplied source data and are going to adjust the blend mode (see cogl_material_set_blend()) or use the data for something other than straight blending. + + + + the memory offset in bytes between the starts of scanlines in @data + - - - + pointer the memory region where the source buffer resides + - + Creates a COGL texture from an image file. +%COGL_INVALID_HANDLE on failure + + a #CoglHandle to the newly created texture or + the file to load + Optional flags for the texture, or %COGL_TEXTURE_NONE - + + the #CoglPixelFormat to use for the GPU storage of the texture. If %COGL_PIXEL_FORMAT_ANY is given then a premultiplied format similar to the format of the source data will be used. The default blending equations of Cogl expect premultiplied color data; the main use of passing a non-premultiplied format here is if you have non-premultiplied source data and are going to adjust the blend mode (see cogl_material_set_blend()) or use the data for something other than straight blending. + Creates a COGL texture based on an existing OpenGL texture; the width, height and format are passed along since it is not always possible to query these from OpenGL. The waste arguments allow you to create a Cogl texture that maps to @@ -5008,38 +6431,47 @@ hardware only supports power-of-two textures you may load a non-power-of-two image into a larger power-of-two texture and use the waste arguments to tell Cogl which region should be mapped to the texture coordinate range [0:1]. -%COGL_INVALID_HANDLE on failure" - version="0.8"> - +%COGL_INVALID_HANDLE on failure + + a #CoglHandle to the newly created texture or + opengl handle of foreign texture. + opengl target type of foreign texture + width of foreign texture + height of foreign texture. + horizontal waste on the right hand edge of the texture. + vertical waste on the bottom edge of the texture. + format of the foreign texture. + Creates a new texture which represents a subregion of another texture. The GL resources will be shared so that no new texture data is actually allocated. Sub textures have undefined behaviour texture coordinates outside @@ -5047,161 +6479,275 @@ of the range [0,1] are used. They also do not work with CoglVertexBuffers. The sub texture will keep a reference to the full texture so you do not need to keep one separately if you only want to use the sub -texture." - version="1.2"> - +texture. + + a #CoglHandle to the new texture. + a #CoglHandle to an existing texture - + X coordinate of the top-left of the subregion + - + Y coordinate of the top-left of the subregion + - + Width in pixels of the subregion + - + Height in pixels of the subregion + - + version="0.8" + introspectable="0"> + Creates a new COGL texture with the specified dimensions and pixel format. +%COGL_INVALID_HANDLE on failure + + a #CoglHandle to the newly created texture or - + width of texture in pixels. + - + height of texture in pixels. + + Optional flags for the texture, or %COGL_TEXTURE_NONE - + + the #CoglPixelFormat to use for the GPU storage of the texture. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + Increment the reference count for a cogl texture. + + the @handle. + a @CoglHandle. - + Sets the pixels in a rectangular subregion of @handle from an in-memory buffer containing pixel data. -%FALSE otherwise"> +%FALSE otherwise - + %TRUE if the subregion upload was successful, and + + a #CoglHandle. - + upper left coordinate to use from source data. + - + upper left coordinate to use from source data. + - + upper left destination horizontal coordinate. + - + upper left destination vertical coordinate. + - + width of destination region to write. + - + height of destination region to write. + - + width of source data buffer. + - + height of source data buffer. + + the #CoglPixelFormat used in the source buffer. - - + + rowstride of source buffer (computed from width if none specified) + - - - + the actual pixel data. + + Decrement the reference count for a cogl texture. + a @CoglHandle. - + + Multiplies the current model-view matrix by the given matrix. + + + + + + the matrix to multiply with the current model-view + + + + + + Multiplies the current model-view matrix by one that translates the +model along all three axes according to the given values. - + Distance to translate along the x-axis + - + Distance to translate along the y-axis + - + Distance to translate along the z-axis + - + + + + + + + + + + + + + + Adds an attribute to a buffer. +You either can use one of the built-in names such as "gl_Vertex", or +"gl_MultiTexCoord0" to add standard attributes, like positions, colors and normals, or you can add custom attributes for use in shaders. The number of vertices declared when calling cogl_vertex_buffer_new() determines how many attribute values will be read from the supplied -The data for your attribute isn't copied anywhere until you call +The data for your attribute isn't copied anywhere until you call cogl_vertex_buffer_submit(), or issue a draw call which automatically submits pending attribute changes. so the supplied pointer must remain valid until then. If you are updating an existing attribute (done by @@ -5218,212 +6764,223 @@ This is not ok: <programlisting> |- - - - -0-0-0-0-0-0 0 0 0 0| </programlisting> -(Though you can have multiple groups of interleved attributes)</note>"> +(Though you can have multiple groups of interleved attributes)</note> + A vertex buffer handle - + + The name of your attribute. It should be a valid GLSL variable name and standard attribute types must use one of following built-in names: (Note: they correspond to the built-in names of GLSL) <itemizedlist> <listitem>"gl_Color"</listitem> <listitem>"gl_Normal"</listitem> <listitem>"gl_MultiTexCoord0, gl_MultiTexCoord1, ..."</listitem> <listitem>"gl_Vertex"</listitem> </itemizedlist> To support adding multiple variations of the same attribute the name can have a detail component, E.g. "gl_Color::active" or "gl_Color::inactive" - - + + The number of components per attribute and must be 1, 2, 3 or 4 + + a #CoglAttributeType specifying the data type of each component. - - + + If %TRUE, this specifies that values stored in an integer format should be mapped into the range [-1.0, 1.0] or [0.0, 1.0] for unsigned values. If %FALSE they are converted to floats directly. + - - + + This specifies the number of bytes from the start of one attribute value to the start of the next value (for the same attribute). So, for example, with a position interleved with color like this: XYRGBAXYRGBAXYRGBA, then if each letter represents a byte, the stride for both attributes is 6. The special value 0 means the values are stored sequentially in memory. + - - + + This addresses the first attribute in the vertex array. This must remain valid until you either call cogl_vertex_buffer_submit() or issue a draw call. + + Deletes an attribute from a buffer. You will need to call cogl_vertex_buffer_submit() or issue a draw call to commit this -change to the GPU."> +change to the GPU. + A vertex buffer handle + The name of a previously added attribute + Disables a previosuly added attribute. Since it can be costly to add and remove new attributes to buffers; to make individual buffers more reuseable it is possible to enable and disable attributes before using a buffer for drawing. -You don't need to call cogl_vertex_buffer_submit() after using this -function."> +You don't need to call cogl_vertex_buffer_submit() after using this +function. + A vertex buffer handle + The name of the attribute you want to disable - + Allows you to draw geometry using all or a subset of the vertices in a vertex buffer. Any un-submitted attribute changes are automatically submitted before -drawing."> +drawing. + A vertex buffer handle - + + A #CoglVerticesMode specifying how the vertices should be interpreted. - + Specifies the index of the first vertex you want to draw with + - + Specifies the number of vertices you want to draw. + + This function lets you use an array of indices to specify the vertices within your vertex buffer that you want to draw. The indices themselves are created by calling cogl_vertex_buffer_indices_new () Any un-submitted attribute changes are automatically submitted before -drawing."> +drawing. + A vertex buffer handle - + + A #CoglVerticesMode specifying how the vertices should be interpreted. - + + A CoglHandle for a set of indices allocated via cogl_vertex_buffer_indices_new () - + Specifies the minimum vertex index contained in indices + - + Specifies the maximum vertex index contained in indices + - - + + An offset into named indices. The offset marks the first index to use for drawing. + - + Specifies the number of vertices you want to draw. + + Enables a previosuly disabled attribute. Since it can be costly to add and remove new attributes to buffers; to make individual buffers more reuseable it is possible to enable and disable attributes before using a buffer for drawing. -You don't need to call cogl_vertex_buffer_submit() after using this function"> +You don't need to call cogl_vertex_buffer_submit() after using this function + A vertex buffer handle + The name of the attribute you want to enable + c:identifier="cogl_vertex_buffer_get_n_vertices"> + Retrieves the number of vertices that @handle represents - + the number of vertices + + A vertex buffer handle + Creates a vertex buffer containing the indices needed to draw pairs of triangles from a list of vertices grouped as quads. There will be at least @n_indices entries in the buffer (but there may be more). The indices will follow this pattern: 0, 1, 2, 0, 2, 3, 4, 5, 6, 4, 6, 7 ... etc -For example, if you submit vertices for a quad like this: -|[ -0 3 -######## -# # -# # -######## -1 2 -]| -Then you can request 6 indices to render two triangles like this: -|[ -0 0 3 -## ######## -# ## ## # -# ## ## # -######## ## -1 2 2 -]| -owned by Cogl and should not be modified or unref'd."> - +For example, if you submit vertices for a quad like like that shown +in <xref linkend="quad-indices-order"/> then you can request 6 +indices to render two triangles like those shown in <xref +linkend="quad-indices-triangles"/>. +<figure id="quad-indices-order"> +<title>Example of vertices submitted to form a quad</title> +<graphic fileref="quad-indices-order.png" format="PNG"/> +</figure> +<figure id="quad-indices-triangles"> +<title>Illustration of the triangle indices that will be generated</title> +<graphic fileref="quad-indices-triangles.png" format="PNG"/> +</figure> +owned by Cogl and should not be modified or unref'd. + + A %CoglHandle containing the indices. The handled is - + the number of indices in the vertex buffer. + - + c:identifier="cogl_vertex_buffer_indices_get_type"> + Queries back the data type used for the given indices + + The CoglIndicesType used @@ -5434,104 +6991,115 @@ owned by Cogl and should not be modified or unref'd."> + Depending on how much geometry you are submitting it can be worthwhile optimizing the number of redundant vertices you submit. Using an index array allows you to reference vertices multiple times, for example during triangle strips. -cogl_vertex_buffer_draw_elements()."> - +cogl_vertex_buffer_draw_elements(). + + A CoglHandle for the indices which you can pass to - + + a #CoglIndicesType specifying the data type used for the indices. - + + Specifies the address of your array of indices - + - + The number of indices in indices_array + - + introspectable="0"> + Creates a new vertex buffer that you can use to add attributes. + + a new #CoglHandle - + The number of vertices that your attributes will correspond to. + - + Increment the reference count for a vertex buffer + + the @handle. + a @CoglHandle. + Submits all the user added attributes to the GPU; once submitted, the attributes can be used for drawing. You should aim to minimize calls to this function since it implies validating your data; it potentially incurs a transport cost (especially if you are using GLX indirect rendering) and potentially a format conversion -cost if the GPU doesn't natively support any of the given attribute formats."> +cost if the GPU doesn't natively support any of the given attribute formats. + A vertex buffer handle + Decrement the reference count for a vertex buffer + a @CoglHandle. + Replace the current viewport with the given values. - + Width of the viewport + - + Height of the viewport + diff --git a/extra/clutter/cogl/ffi/ffi.factor b/extra/clutter/cogl/ffi/ffi.factor index e1d85c9ae3..199fa07272 100644 --- a/extra/clutter/cogl/ffi/ffi.factor +++ b/extra/clutter/cogl/ffi/ffi.factor @@ -1,10 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries alien.syntax -combinators kernel opengl.gl system -gobject-introspection glib.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel opengl.gl system vocabs.loader ; IN: clutter.cogl.ffi +<< +"gobject.ffi" require +>> + +LIBRARY: clutter.cogl + << "clutter.cogl" { { [ os winnt? ] [ drop ] } @@ -13,13 +18,8 @@ IN: clutter.cogl.ffi } cond >> -TYPEDEF: int CoglAngle -TYPEDEF: int CoglFixed -TYPEDEF: void* CoglHandle - -REPLACE-C-TYPE: unsigned\schar uchar -REPLACE-C-TYPE: unsigned\sint uint -REPLACE-C-TYPE: unsigned\slong ulong +FOREIGN-ATOMIC-TYPE: GL.uint GLuint +FOREIGN-ATOMIC-TYPE: GL.enum GLenum GIR: vocab:clutter/cogl/Cogl-1.0.gir diff --git a/extra/clutter/ffi/ffi.factor b/extra/clutter/ffi/ffi.factor index bbb929468e..4a4441296c 100644 --- a/extra/clutter/ffi/ffi.factor +++ b/extra/clutter/ffi/ffi.factor @@ -1,11 +1,18 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries cairo.ffi -combinators kernel system -gobject-introspection clutter.cogl.ffi clutter.json.ffi -glib.ffi gobject.ffi pango.ffi ; +USING: alien alien.libraries alien.syntax cairo.ffi combinators +gobject-introspection kernel system vocabs.loader ; IN: clutter.ffi +<< +"atk.ffi" require +"pango.cairo.ffi" require +"clutter.cogl.ffi" require +"clutter.json.ffi" require +>> + +LIBRARY: clutter + << "clutter" { { [ os winnt? ] [ drop ] } @@ -14,7 +21,7 @@ IN: clutter.ffi } cond >> -IMPLEMENT-STRUCTS: ClutterVertex ; +FOREIGN-RECORD-TYPE: cairo.Path cairo_path_t GIR: vocab:clutter/Clutter-1.0.gir diff --git a/extra/clutter/gtk/GtkClutter-0.10.gir b/extra/clutter/gtk/GtkClutter-0.10.gir index 7d929326ac..3811379217 100644 --- a/extra/clutter/gtk/GtkClutter-0.10.gir +++ b/extra/clutter/gtk/GtkClutter-0.10.gir @@ -2,13 +2,12 @@ - - @@ -18,66 +17,48 @@ and/or use gtk-doc annotations. --> + - - - - - - - - - - - + c:identifier-prefixes="GtkClutter" + c:symbol-prefixes="gtk_clutter"> + A #GtkWidget containing the default Clutter stage. - - + Creates a new #GtkClutterEmbed widget. This widget can be +used to build a scene using Clutter API into a GTK+ application. + + the newly created #GtkClutterEmbed + + Retrieves the #ClutterStage from @embed. The returned stage can be used to add actors to the Clutter scene. Multiple calls to this function on the same #GtkClutterEmbed widget will return the same stage. -or unref the returned actor." - version="0.6"> - +or unref the returned actor. + + a #ClutterStage. You should never destroy @@ -91,132 +72,147 @@ or unref the returned actor." + Base class for #GtkClutterEmbed. - - + + - - + + - - + + - - + + - - + + - - + + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Retrieves the horizontal and vertical adjustments used to +determine the position of the scrollable actor. - + direction="out" + caller-allocates="0" + transfer-ownership="full"> + return location for a #GtkAdjustment, or %NULL + + direction="out" + caller-allocates="0" + transfer-ownership="full"> + return location for a #GtkAdjustment, or %NULL + + + + + + Sets the horizontal and vertical adjustments used to determine +the position of the scrollable actor. + + + + + + a #GtkAdjustment, or %NULL + + a #GtkAdjustment, or %NULL + + + + + + Retrieves the horizontal and vertical adjustments used to +determine the position of the scrollable actor. + + + + + + return location for a #GtkAdjustment, or %NULL + + + + return location for a #GtkAdjustment, or %NULL + + - + Sets the horizontal and vertical adjustments used to determine +the position of the scrollable actor. - - + + a #GtkAdjustment, or %NULL + - - + + a #GtkAdjustment, or %NULL + @@ -224,30 +220,32 @@ determine the position of the scrollable actor." version="0.10" writable="1" construct="1" - doc="The #GtkAdjustment that determines the value of the -horizontal position for this scrollable actor."> - + transfer-ownership="none"> + The #GtkAdjustment that determines the value of the +horizontal position for this scrollable actor. + - + transfer-ownership="none"> + The #GtkAdjustment that determines the value of the +vertical position for this scrollable actor. + + The #GtkClutterScrollableIface structure contains only private data +and should be accessed using the provided functions. - + @@ -255,17 +253,23 @@ and should be accessed using the provided functions." - + + a #GtkAdjustment, or %NULL - + + a #GtkAdjustment, or %NULL - + @@ -273,10 +277,18 @@ and should be accessed using the provided functions." - + + return location for a #GtkAdjustment, or %NULL - + + return location for a #GtkAdjustment, or %NULL @@ -284,78 +296,79 @@ and should be accessed using the provided functions." + The #GtkClutterViewport structure contains only private data and +should be accessed using the provided functions. + + - - + Creates a new #GtkClutterViewport with the given adjustments. + + the newly created viewport actor + + horizontal adjustment, or %NULL + vertical adjustment, or %NULL + zoom adjustment, or %NULL + Retrieves the current translation factor ("origin") used when +displaying the child of @viewport. - - + + return location for the X origin in pixels, or %NULL + - - + + return location for the Y origin in pixels, or %NULL + - - + + return location for the Z origin in pixels, or %NULL + - + transfer-ownership="none"> + The #ClutterActor inside the viewport. + - + The current origin of the viewport. You should use the vertex to convert event coordinates for the child of the -viewport."> - +viewport. + @@ -367,80 +380,93 @@ viewport."> + The #GtkClutterViewportClass structure contains only private data and +should be accessed using the provided functions. - + - + + Retrieves the adjustment used to determine the zoom factor of +the zoomable actor - - - - - - - - - - + a #GtkAdjustment - + + Sets the adjustment used to determine the zoom factor of +the zoomable actor - + + a #GtkAdjustment, or %NULL - + - + Retrieves the adjustment used to determine the zoom factor of +the zoomable actor + + a #GtkAdjustment + + Sets the adjustment used to determine the zoom factor of +the zoomable actor + + + + + + a #GtkAdjustment, or %NULL + + + + - + transfer-ownership="none"> + The #GtkAdjustment that determines the value of +the zoom factor for this zoomable actor + + The #GtkClutterZoomableIface structure contains only private data - + @@ -448,15 +474,19 @@ the zoom factor for this zoomable actor"> - + + a #GtkAdjustment, or %NULL - - + + + a #GtkAdjustment @@ -469,338 +499,411 @@ the zoom factor for this zoomable actor"> + Retrieves the base color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the background color of @widget for the given @state and copies +it into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the dark color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the foreground color of @widget for the given @state and copies +it into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the light color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the mid color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the text-aa color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor + Retrieves the text color of @widget for the given @state and copies it +into @color. + a #GtkWidget + a state + return location for a #ClutterColor - + This function should be called instead of clutter_init() and gtk_init(). -on failure." - version="0.8"> - +on failure. + + %CLUTTER_INIT_SUCCESS on success, a negative integer - + pointer to the arguments count, or %NULL + - - + + pointer to the arguments vector, or %NULL + + + - + This function should be called instead of clutter_init() and +gtk_init_with_args(). +on failure. + + %CLUTTER_INIT_SUCCESS on success, a negative integer - + a pointer to the number of command line arguments. + - - + + a pointer to the array of command line arguments. + + + + allow-none="1"> + a string which is displayed in the first line of <option>--help</option> output, after <literal><replaceable>programname</replaceable> [OPTION...]</literal> - + + a %NULL-terminated array of #GOptionEntry<!-- -->s describing the options of your program, or %NULL + allow-none="1"> + a translation domain to use for translating the <option>--help</option> output for the options in @entries with gettext(), or %NULL + + + + + + Creates a new #ClutterTexture and sets its contents to be the @icon_name from the current icon theme. -was %NULL and @icon_name was not found." - version="0.8"> - +was %NULL and @icon_name was not found. + + the newly created texture, or %NULL if @widget + a #GtkWidget or %NULL + the name of the icon + the size of the icon, or -1 - + version="0.8" + introspectable="0"> + Creates a new #ClutterTexture and sets its contents with a copy +of @pixbuf. + + the newly created #ClutterTexture + a #GdkPixbuf - + version="0.8" + introspectable="0"> + Creates a new #ClutterTexture and sets its contents using the stock +icon @stock_id as rendered by @widget. + + the newly created #ClutterTexture + a #GtkWidget + the stock id of the icon + the size of the icon, or -1 + Sets the contents of @texture using the @icon_name from the +current icon theme. - + %TRUE on success, %FALSE on failure. + + a #ClutterTexture + a #GtkWidget or %NULL + the name of the icon + the icon size or -1 + Sets the contents of @texture with a copy of @pixbuf. - + %TRUE on success, %FALSE on failure. + + a #ClutterTexture + a #GdkPixbuf + Sets the contents of @texture using the stock icon @stock_id, as +rendered by @widget. - + %TRUE on success, %FALSE on failure. + + a #ClutterTexture + a #GtkWidget + the stock id of the icon + the size of the icon, or -1 diff --git a/extra/clutter/gtk/ffi/ffi.factor b/extra/clutter/gtk/ffi/ffi.factor index eba6b39f38..088899aaf0 100644 --- a/extra/clutter/gtk/ffi/ffi.factor +++ b/extra/clutter/gtk/ffi/ffi.factor @@ -1,11 +1,16 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system -gobject-introspection clutter.ffi gdk.pixbuf.ffi glib.ffi -gtk.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: clutter.gtk.ffi +<< +"clutter.ffi" require +"gtk.ffi" require +>> + +LIBRARY: clutter.gtk + << "clutter.gtk" { { [ os winnt? ] [ drop ] } diff --git a/extra/clutter/json/ClutterJson-1.0.gir b/extra/clutter/json/ClutterJson-1.0.gir deleted file mode 100644 index e0b3cf9dff..0000000000 --- a/extra/clutter/json/ClutterJson-1.0.gir +++ /dev/null @@ -1,1549 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/extra/clutter/json/Json-1.0.gir b/extra/clutter/json/Json-1.0.gir new file mode 100644 index 0000000000..e9454087fd --- /dev/null +++ b/extra/clutter/json/Json-1.0.gir @@ -0,0 +1,2925 @@ + + + + + + + + + + A JSON array type. The contents of the #JsonArray structure are private +and should only be accessed by the provided API + + Creates a new #JsonArray. + + the newly created #JsonArray + + + + + Creates a new #JsonArray with @n_elements slots already allocated. + + the newly created #JsonArray + + + + + number of slots to pre-allocate + + + + + + Conveniently adds an array into @array. The @array takes ownership +of the newly added #JsonArray + + + + + + a #JsonArray + + + + + + Conveniently adds a boolean @value into @array + + + + + + a boolean value + + + + + + Conveniently adds a floating point @value into @array + + + + + + a floating point value + + + + + + Appends @node inside @array. The array will take ownership of the +#JsonNode. + + + + + + a #JsonNode + + + + + + Conveniently adds an integer @value into @array + + + + + + an integer value + + + + + + Conveniently adds a null element into @array + + + + + + Conveniently adds an object into @array. The @array takes ownership +of the newly added #JsonObject + + + + + + a #JsonObject + + + + + + Conveniently adds a string @value into @array + + + + + + a string value + + + + + + Retrieves a copy of the #JsonNode containing the value of the +element at @index_ inside a #JsonArray +index. Use json_node_free() when done. + + a copy of the #JsonNode at the requested + + + + + the index of the element to retrieve + + + + + + Iterates over all elements of @array and calls @func on +each one of them. +It is safe to change the value of a #JsonNode of the @array +from within the iterator @func, but it is not safe to add or +remove elements from the @array. + + + + + + the function to be called on each element + + + + data to be passed to the function + + + + + + Conveniently retrieves the array from the element at @index_ +inside @array + + the array + + + + + the index of the element to retrieve + + + + + + Conveniently retrieves the boolean value of the element at @index_ +inside @array + + the integer value + + + + + the index of the element to retrieve + + + + + + Conveniently retrieves the floating point value of the element at + + the floating point value + + + + + the index of the element to retrieve + + + + + + Retrieves the #JsonNode containing the value of the element at @index_ +inside a #JsonArray. + + a pointer to the #JsonNode at the requested index + + + + + the index of the element to retrieve + + + + + + Gets the elements of a #JsonArray as a list of #JsonNode<!-- -->s. +containing the elements of the array. The contents of the list are +owned by the array and should never be modified or freed. Use +g_list_free() on the returned list when done using it + + a #GList + + + + + + + Conveniently retrieves the integer value of the element at @index_ +inside @array + + the integer value + + + + + the index of the element to retrieve + + + + + + Retrieves the length of a #JsonArray + + the length of the array + + + + + Conveniently retrieves whether the element at @index_ is set to null + + %TRUE if the element is null + + + + + the index of the element to retrieve + + + + + + Conveniently retrieves the object from the element at @index_ +inside @array + + the object + + + + + the index of the element to retrieve + + + + + + Conveniently retrieves the string value of the element at @index_ +inside @array +the #JsonArray and should not be modified or freed + + the string value; the returned string is owned by + + + + + the index of the element to retrieve + + + + + + Increase by one the reference count of a #JsonArray. +increased by one. + + the passed #JsonArray, with the reference count + + + + + Removes the #JsonNode inside @array at @index_ freeing its allocated +resources. + + + + + + the position of the element to be removed + + + + + + Decreases by one the reference count of a #JsonArray. If the +reference count reaches zero, the array is destroyed and all +its allocated resources are freed. + + + + + + + The function to be passed to json_array_foreach_element(). You +should not add or remove elements to and from @array within +this function. It is safe to change the value of @element_node. + + + + + + the iterated #JsonArray + + + + the index of the element + + + + a #JsonNode containing the value at @index_ + + + + data passed to the function + + + + + + Deserializes the contents of the passed #JsonNode into a #GBoxed + + the newly created boxed type + + + + + a #JsonNode + + + + + + Serializes the passed #GBoxed and stores it inside a #JsonNode + + the newly created #JsonNode + + + + + a #GBoxed + + + + + + The <structname>JsonBuilder</structname> structure contains only +private data and shouls be accessed using the provided API + + Creates a new #JsonBuilder. You can use this object to generate a +JSON tree and obtain the root #JsonNode<!-- -->s. + + the newly created #JsonBuilder instance + + + + + If called after json_builder_set_member_name(), sets @value as member of the +most recent opened object, otherwise @value is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the value of the member or element + + + + + + If called after json_builder_set_member_name(), sets @value as member of the +most recent opened object, otherwise @value is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the value of the member or element + + + + + + If called after json_builder_set_member_name(), sets @value as member of the +most recent opened object, otherwise @value is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the value of the member or element + + + + + + If called after json_builder_set_member_name(), sets null as member of the +most recent opened object, otherwise null is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + If called after json_builder_set_member_name(), sets @value as member of the +most recent opened object, otherwise @value is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the value of the member or element + + + + + + If called after json_builder_set_member_name(), sets @node as member of the +most recent opened object, otherwise @node is added as element of the most +recent opened array. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the value of the member or element + + + + + + Opens a subarray inside the given @builder. When done adding members to +the subarray, json_builder_end_array() must be called. +Can be called for first or only if the call is associated to an object member +or an array element. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + Opens a subobject inside the given @builder. When done adding members to +the subobject, json_builder_end_object() must be called. +Can be called for first or only if the call is associated to an object member +or an array element. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + Closes the subarray inside the given @builder that was opened by the most +recent call to json_builder_begin_array(). +Cannot be called after json_builder_set_member_name(). + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + Closes the subobject inside the given @builder that was opened by the most +recent call to json_builder_begin_object(). +Cannot be called after json_builder_set_member_name(). + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + Returns the root of the current constructed tree, if the build is complete +(ie: all opened objects, object members and arrays are being closed). +Free the returned value with json_node_free(). + + the #JsonNode, or %NULL if the build is not complete. + + + + + Resets the state of the @builder back to its initial state. + + + + + + Set the name of the next member in an object. The next call must add a value, +open an object or an array. +Can be called only if the call is associated to an object. + + the #JsonBuilder, or %NULL if the call was inconsistent + + + + + the name of the member + + + + + + + + + + + + + The <structname>JsonBuilder</structname> structure contains only +private data + + + + + + + + + + + + + + + + + + + + + + JSON data streams generator. The contents of the #JsonGenerator structure +are private and should only be accessed via the provided API. + + Creates a new #JsonGenerator. You can use this object to generate a +JSON data stream starting from a data object model composed by +#JsonNode<!-- -->s. + + the newly created #JsonGenerator instance + + + + + Sets @node as the root of the JSON data stream to be serialized by +the #JsonGenerator. +<note>The node is copied by the generator object, so it can be safely +freed after calling this function.</note> + + + + + + a #JsonNode + + + + + + Generates a JSON data stream from @generator and returns it as a +buffer. +Use g_free() to free the allocated resources. + + a newly allocated buffer holding a JSON data stream. + + + + + return location for the length of the returned buffer, or %NULL + + + + + + Creates a JSON data stream and puts it inside @filename, overwriting the +current file contents. This operation is atomic. + + %TRUE if saving was successful. + + + + + path to the target file + + + + + + Outputs JSON data and streams it (synchronously) to @stream. +on failure. In case of error, the #GError will be filled accordingly + + %TRUE if the write operation was successful, and %FALSE + + + + + a #GOutputStream + + + + a #GCancellable, or %NULL + + + + + + Number of spaces to be used to indent when pretty printing. + + + + The character that should be used when indenting in pretty print. + + + + Whether the output should be "pretty-printed", with indentation and +newlines. The indentation level can be controlled by using the +JsonGenerator:indent property + + + + The root #JsonNode to be used when constructing a JSON data +stream. + + + + + + + + + + + #JsonGenerator class + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A generic container of JSON data types. The contents of the #JsonNode +structure are private and should only be accessed via the provided +functions and never directly. + + Creates a new #JsonNode of @type. + + the newly created #JsonNode + + + + + a #JsonNodeType + + + + + + Copies @node. If the node contains complex data types then the reference +count of the objects is increased. + + the copied #JsonNode + + + + + + + + + + Retrieves the #JsonObject inside @node. The reference count of +the returned object is increased. + + the #JsonObject + + + + + Gets a copy of the string value stored inside a #JsonNode +of the #JsonNode contents. Use g_free() to free the allocated resources + + a newly allocated string containing a copy + + + + + Frees the resources allocated by @node. + + + + + + Retrieves the #JsonArray stored inside a #JsonNode + + the #JsonArray + + + + + Gets the boolean value stored inside a #JsonNode + + a boolean value. + + + + + Gets the double value stored inside a #JsonNode + + a double value. + + + + + Gets the integer value stored inside a #JsonNode + + an integer value. + + + + + Retrieves the #JsonNodeType of @node + + the type of the node + + + + + Retrieves the #JsonObject stored inside a #JsonNode + + the #JsonObject + + + + + Retrieves the parent #JsonNode of @node. + + the parent node, or %NULL if @node is the root node + + + + + Gets the string value stored inside a #JsonNode + + a string value. + + + + + Retrieves a value from a #JsonNode and copies into @value. When done +using it, call g_value_unset() on the #GValue. + + + + + + return location for an uninitialized value + + + + + + Returns the #GType of the payload of the node. + + a #GType for the payload. + + + + + Checks whether @node is a %JSON_NODE_NULL +<note>A null node is not the same as a %NULL #JsonNode</note> + + %TRUE if the node is null + + + + + Sets @array inside @node and increases the #JsonArray reference count + + + + + + a #JsonArray + + + + + + Sets @value as the boolean content of the @node, replacing any existing +content. + + + + + + a boolean value + + + + + + Sets @value as the double content of the @node, replacing any existing +content. + + + + + + a double value + + + + + + Sets @value as the integer content of the @node, replacing any existing +content. + + + + + + an integer value + + + + + + Sets @objects inside @node. The reference count of @object is increased. + + + + + + a #JsonObject + + + + + + Sets the parent #JsonNode of @node + + + + + + the parent #JsonNode of @node + + + + + + Sets @value as the string content of the @node, replacing any existing +content. + + + + + + a string value + + + + + + Sets @value inside @node. The passed #GValue is copied into the #JsonNode + + + + + + the #GValue to set + + + + + + Sets @array into @node without increasing the #JsonArray reference count. + + + + + + a #JsonArray + + + + + + Sets @object inside @node. The reference count of @object is not increased. + + + + + + a #JsonObject + + + + + + Retrieves the user readable name of the data type contained by @node. +is owned by the node and should never be modified or freed + + a string containing the name of the type. The returned string + + + + + + Indicates the content of a #JsonNode. + + + + + + + A JSON object type. The contents of the #JsonObject structure are private +and should only be accessed by the provided API + + Creates a new #JsonObject, an JSON object type representation. + + the newly created #JsonObject + + + + + Adds a member named @member_name and containing @node into a #JsonObject. +The object will take ownership of the #JsonNode. +This function will return if the @object already contains a member + + + + + + the name of the member + + + + the value of the member + + + + + + Retrieves a copy of the #JsonNode containing the value of @member_name +inside a #JsonObject +object member or %NULL. Use json_node_free() when done. + + (transfer full) a copy of the node for the requested + + + + + the name of the JSON object member to access + + + + + + Iterates over all members of @object and calls @func on +each one of them. +It is safe to change the value of a #JsonNode of the @object +from within the iterator @func, but it is not safe to add or +remove members from the @object. + + + + + + the function to be called on each member + + + + data to be passed to the function + + + + + + Convenience function that retrieves the array +stored in @member_name of @object + + the array inside the object's member + + + + + the name of the member + + + + + + Convenience function that retrieves the boolean value +stored in @member_name of @object + + the boolean value of the object's member + + + + + the name of the member + + + + + + Convenience function that retrieves the floating point value +stored in @member_name of @object + + the floating point value of the object's member + + + + + the name of the member + + + + + + Convenience function that retrieves the integer value +stored in @member_name of @object + + the integer value of the object's member + + + + + the name of the member + + + + + + Retrieves the #JsonNode containing the value of @member_name inside +a #JsonObject. +member, or %NULL + + a pointer to the node for the requested object + + + + + the name of the JSON object member to access + + + + + + Retrieves all the names of the members of a #JsonObject. You can +obtain the value for each member using json_object_get_member(). +of member names. The content of the list is owned by the #JsonObject +and should never be modified or freed. When you have finished using +the returned list, use g_list_free() to free the resources it has +allocated. + + a #GList + + + + + + + Convenience function that checks whether the value +stored in @member_name of @object is null + + %TRUE if the value is null + + + + + the name of the member + + + + + + Convenience function that retrieves the object +stored in @member_name of @object + + the object inside the object's member + + + + + the name of the member + + + + + + Retrieves the number of members of a #JsonObject. + + the number of members + + + + + Convenience function that retrieves the string value +stored in @member_name of @object + + the string value of the object's member + + + + + the name of the member + + + + + + Retrieves all the values of the members of a #JsonObject. +#JsonNode<!-- -->s. The content of the list is owned by the #JsonObject +and should never be modified or freed. When you have finished using the +returned list, use g_list_free() to free the resources it has allocated. + + a #GList of + + + + + + + Checks whether @object has a member named @member_name. + + %TRUE if the JSON object has the requested member + + + + + the name of a JSON object member + + + + + + Increase by one the reference count of a #JsonObject. +increased by one. + + the passed #JsonObject, with the reference count + + + + + Removes @member_name from @object, freeing its allocated resources. + + + + + + the name of the member to remove + + + + + + Convenience function for setting an array @value of +The @object will take ownership of the passed #JsonArray + + + + + + the name of the member + + + + the value of the member + + + + + + Convenience function for setting a boolean @value of + + + + + + the name of the member + + + + the value of the member + + + + + + Convenience function for setting a floating point @value +of @member_name inside @object. + + + + + + the name of the member + + + + the value of the member + + + + + + Convenience function for setting an integer @value of + + + + + + the name of the member + + + + the value of the member + + + + + + Sets @node as the value of @member_name inside @object. +If @object already contains a member called @member_name then +the member's current value is overwritten. Otherwise, a new +member is added to @object. + + + + + + the name of the member + + + + the value of the member + + + + + + Convenience function for setting a null @value of + + + + + + the name of the member + + + + + + Convenience function for setting an object @value of +The @object will take ownership of the passed #JsonObject + + + + + + the name of the member + + + + the value of the member + + + + + + Convenience function for setting a string @value of + + + + + + the name of the member + + + + the value of the member + + + + + + Decreases by one the reference count of a #JsonObject. If the +reference count reaches zero, the object is destroyed and all +its allocated resources are freed. + + + + + + + The function to be passed to json_object_foreach_member(). You +should not add or remove members to and from @object within +this function. It is safe to change the value of @member_node. + + + + + + the iterated #JsonObject + + + + the name of the member + + + + a #JsonNode containing the @member_name value + + + + data passed to the function + + + + + + JSON data streams parser. The contents of the #JsonParser structure are +private and should only be accessed via the provided API. + + Creates a new #JsonParser instance. You can use the #JsonParser to +load a JSON stream from either a file or a buffer and then walk the +hierarchy using the data types API. +to release all the memory it allocates. + + the newly created #JsonParser. Use g_object_unref() + + + + + + + + + + Retrieves the line currently parsed, starting from 1. +This function has defined behaviour only while parsing; calling this +function from outside the signal handlers emitted by #JsonParser will +yield 0. + + the currently parsed line, or 0. + + + + + Retrieves the current position inside the current line, starting +from 0. +This function has defined behaviour only while parsing; calling this +function from outside the signal handlers emitted by #JsonParser will +yield 0. + + the position in the current line, or 0. + + + + + Retrieves the top level node from the parsed JSON stream. +node is owned by the #JsonParser and should never be modified +or freed. + + the root #JsonNode . The returned + + + + + A JSON data stream might sometimes contain an assignment, like: +|[ +]| +even though it would technically constitute a violation of the RFC. +#JsonParser will ignore the left hand identifier and parse the right +hand value of the assignment. #JsonParser will record, though, the +existence of the assignment in the data stream and the variable name +used. +used in the assignment. The string is owned by #JsonParser and should +never be modified or freed. + + %TRUE if there was an assignment, %FALSE otherwise. If + + + + + Return location for the variable name, or %NULL + + + + + + Loads a JSON stream from a buffer and parses it. You can call this function +multiple times with the same #JsonParser object, but the contents of the +parser will be destroyed each time. +of error, @error is set accordingly and %FALSE is returned + + %TRUE if the buffer was succesfully parser. In case + + + + + the buffer to parse + + + + the length of the buffer, or -1 + + + + + + Loads a JSON stream from the content of @filename and parses it. See +json_parser_load_from_data(). +In case of error, @error is set accordingly and %FALSE is returned + + %TRUE if the file was successfully loaded and parsed. + + + + + the path for the file to parse + + + + + + Loads the contents of an input stream and parses them. +If @cancellable is not %NULL, then the operation can be cancelled by +triggering the @cancellable object from another thread. If the +operation was cancelled, the error %G_IO_ERROR_CANCELLED will be set +on the passed @error. +parsed, and %FALSE otherwise + + %TRUE if the data stream was successfully read and + + + + + an open #GInputStream + + + + a #GCancellable, or %NULL + + + + + + Asynchronously reads the contents of @stream. +For more details, see json_parser_load_from_stream() which is the +synchronous version of this call. +When the operation is finished, @callback will be called. You should +then call json_parser_load_from_stream_finish() to get the result +of the operation. + + + + + + a #GInputStream + + + + a #GCancellable, or %NULL + + + + a #GAsyncReadyCallback to call when the request is satisfied + + + + the data to pass to @callback + + + + + + Finishes an asynchronous stream loading started with +json_parser_load_from_stream_async(). +and parsed, and %FALSE otherwise. In case of error, the #GError will be +filled accordingly. + + %TRUE if the content of the stream was successfully retrieves + + + + + a #GAsyncResult + + + + + + + + + + + + The ::array-element signal is emitted each time the #JsonParser +has successfully parsed a single element of a #JsonArray. The +array and element index are passed to the signal handlers. + + + + + + a #JsonArray + + + + the index of the newly parsed element + + + + + + The ::array-end signal is emitted each time the #JsonParser +has successfully parsed an entire #JsonArray + + + + + + the parsed #JsonArray + + + + + + The ::array-start signal is emitted each time the #JsonParser +starts parsing a #JsonArray + + + + + + The ::error signal is emitted each time a #JsonParser encounters +an error in a JSON stream. + + + + + + a pointer to the #GError + + + + + + The ::object-end signal is emitted each time the #JsonParser +has successfully parsed an entire #JsonObject. + + + + + + the parsed #JsonObject + + + + + + The ::object-member signal is emitted each time the #JsonParser +has successfully parsed a single member of a #JsonObject. The +object and member are passed to the signal handlers. + + + + + + a #JsonObject + + + + the name of the newly parsed member + + + + + + The ::object-start signal is emitted each time the #JsonParser +starts parsing a #JsonObject. + + + + + + The ::parse-end signal is emitted when the parser successfully +finished parsing a JSON data stream + + + + + + The ::parse-start signal is emitted when the parser began parsing +a JSON data stream. + + + + + + + #JsonParser class. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error enumeration for #JsonParser +This enumeration can be extended at later date + + + + + + + + + + + The <structname>JsonReader</structname> structure contains only +private data and should only be accessed using the provided API + + Creates a new #JsonReader. You can use this object to read the contents of +the JSON tree starting from @node +release the allocated resources when done + + the newly created #JsonReader. Use g_object_unref() to + + + + + a #JsonNode, or %NULL + + + + + + + + + + + Counts the elements of the current position, if @reader is +positioned on an array +the #JsonReader is set in an error state + + the number of elements, or -1. In case of failure + + + + + Counts the members of the current position, if @reader is +positioned on an object +the #JsonReader is set in an error state + + the number of members, or -1. In case of failure + + + + + Moves the cursor back to the previous node after being positioned +inside an array +This function resets the error state of @reader, if any was set + + + + + + Moves the cursor back to the previous node after being positioned +inside an object +This function resets the error state of @reader, if any was set + + + + + + Retrieves the boolean value of the current position of @reader + + the boolean value + + + + + Retrieves the floating point value of the current position of @reader + + the floating point value + + + + + Retrieves the #GError currently set on @reader, if the #JsonReader +is in error state + + the pointer to the error, or %NULL + + + + + Retrieves the integer value of the current position of @reader + + the integer value + + + + + Checks whether the value of the current position of @reader is 'null' + + %TRUE if 'null' is set, and %FALSE otherwise + + + + + Retrieves the string value of the current position of @reader + + the string value + + + + + Retrieves the #JsonNode of the current position of @reader +is owned by the #JsonReader and it should not be modified or freed +directly + + a #JsonNode, or %NULL. The returned node + + + + + Checks whether the @reader is currently on an array +otherwise + + %TRUE if the #JsonReader is on an array, and %FALSE + + + + + Checks whether the @reader is currently on an object +otherwise + + %TRUE if the #JsonReader is on an object, and %FALSE + + + + + Checks whether the @reader is currently on a value +otherwise + + %TRUE if the #JsonReader is on a value, and %FALSE + + + + + Advances the cursor of @reader to the element @index_ of array at the +current position. +You can use the json_reader_get_value* family of functions to retrieve +the value of the element; for instance: +|[ +json_reader_read_element (reader, 0); +int_value = json_reader_get_int_value (reader); +]| +After reading the value, json_reader_end_element() should be called to +reposition the cursor inside the #JsonReader, e.g.: +|[ +json_reader_read_element (reader, 1); +str_value = json_reader_get_string_value (reader); +json_reader_end_element (reader); +json_reader_read_element (reader, 2); +str_value = json_reader_get_string_value (reader); +json_reader_end_element (reader); +]| +If @reader is not currently on an array, or if the @index_ is bigger than +the size of the array, the #JsonReader will be put in an error state until +json_reader_end_element() is called. + + %TRUE on success, and %FALSE otherwise + + + + + the index of the element + + + + + + Advances the cursor of @reader to the @member_name of the object at the +current position. +You can use the json_reader_get_value* family of functions to retrieve +the value of the member; for instance: +|[ +json_reader_read_member (reader, "width"); +width = json_reader_get_int_value (reader); +]| +After reading the value, json_reader_end_member() should be called to +reposition the cursor inside the #JsonReader, e.g.: +|[ +json_reader_read_member (reader, "author"); +author = json_reader_get_string_value (reader); +json_reader_end_element (reader); +json_reader_read_element (reader, "title"); +title = json_reader_get_string_value (reader); +json_reader_end_element (reader); +]| +If @reader is not currently on an object, or if the @member_name is not +defined in the object, the #JsonReader will be put in an error state until +json_reader_end_member() is called. + + %TRUE on success, and %FALSE otherwise + + + + + the name of the member to read + + + + + + Sets the root #JsonNode to be read by @reader. The @reader will take +a copy of @root +If another #JsonNode is currently set as root, it will be replaced. + + + + + + a #JsonNode + + + + + + The root of the JSON tree that the #JsonReader should read. + + + + + + + + + + + The <structname>JsonReaderClass</structname> structure contains only +private data + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error codes enumeration for #JsonReader errors + + + + + + + + + + Asks a #JsonSerializable implementation to deserialize the +property contained inside @property_node into @value. + + %TRUE if the property was successfully deserialized. + + + + + the name of the property + + + + a pointer to an uninitialized #GValue + + + + a #GParamSpec + + + + a #JsonNode containing the serialized property + + + + + + Asks a #JsonSerializable implementation to serialize a #GObject +property into a #JsonNode object. + + a #JsonNode containing the serialized property + + + + + the name of the property + + + + the value of the property + + + + a #GParamSpec + + + + + + Calls the default implementation of the #JsonSerializable +deserialize_property() virtual function +This function can be used inside a custom implementation +of the deserialize_property() virtual function in lieu of: +|[ +JsonSerializable *iface; +gboolean res; +iface = g_type_default_interface_peek (JSON_TYPE_SERIALIZABLE); +res = iface->deserialize_property (serializable, property_name, +value, +pspec, +property_node); +]| + + %TRUE if the property was successfully deserialized. + + + + + the name of the property + + + + a pointer to an uninitialized #GValue + + + + a #GParamSpec + + + + a #JsonNode containing the serialized property + + + + + + Calls the default implementation of the #JsonSerializable +serialize_property() virtual function +This function can be used inside a custom implementation +of the serialize_property() virtual function in lieu of: +|[ +JsonSerializable *iface; +JsonNode *node; +iface = g_type_default_interface_peek (JSON_TYPE_SERIALIZABLE); +node = iface->serialize_property (serializable, property_name, +value, +pspec); +]| +property + + a #JsonNode containing the serialized + + + + + the name of the property + + + + the value of the property + + + + a #GParamSpec + + + + + + Asks a #JsonSerializable implementation to deserialize the +property contained inside @property_node into @value. + + %TRUE if the property was successfully deserialized. + + + + + the name of the property + + + + a pointer to an uninitialized #GValue + + + + a #GParamSpec + + + + a #JsonNode containing the serialized property + + + + + + Asks a #JsonSerializable implementation to serialize a #GObject +property into a #JsonNode object. + + a #JsonNode containing the serialized property + + + + + the name of the property + + + + the value of the property + + + + a #GParamSpec + + + + + + + Interface that allows serializing and deserializing #GObject<!-- -->s +with properties storing complex data types. The json_serialize_gobject() +function will check if the passed #GObject implements this interface, +so it can also be used to override the default property serialization +sequence. + + + + + + + a #JsonNode containing the serialized property + + + + + + + + the name of the property + + + + the value of the property + + + + a #GParamSpec + + + + + + + + + %TRUE if the property was successfully deserialized. + + + + + + + + the name of the property + + + + a pointer to an uninitialized #GValue + + + + a #GParamSpec + + + + a #JsonNode containing the serialized property + + + + + + + + Checks whether it is possible to deserialize a #GBoxed of +type @gboxed_type from a #JsonNode of type @node_type + + %TRUE if the type can be deserialized, %FALSE otherwise + + + + + a boxed type + + + + a #JsonNode type + + + + + + Checks whether it is possible to serialize a #GBoxed of +type @gboxed_type into a #JsonNode. The type of the +#JsonNode is placed inside @node_type if the function +returns %TRUE and it's undefined otherwise. +and %FALSE otherwise. + + %TRUE if the type can be serialized, + + + + + a boxed type + + + + the #JsonNode type to which the boxed type can be serialized into + + + + + + Deserializes @node into a #GBoxed of @gboxed_type +g_boxed_free() to release the resources allocated by this +function + + the newly allocated #GBoxed. Use + + + + + a boxed type + + + + a #JsonNode + + + + + + Registers a deserialization function for a #GBoxed of type @gboxed_type +from a #JsonNode of type @node_type + + + + + + a boxed type + + + + a node type + + + + deserialization function for @boxed_type from a #JsonNode of type @node_type + + + + + + Registers a serialization function for a #GBoxed of type @gboxed_type +to a #JsonNode of type @node_type + + + + + + a boxed type + + + + a node type + + + + serialization function for @boxed_type into a #JsonNode of type @node_type + + + + + + Serializes @boxed, a pointer to a #GBoxed of type @gboxed_type, +into a #JsonNode +boxed type, or %NULL if serialization either failed or was not possible + + a #JsonNode with the serialization of the + + + + + a boxed type + + + + a pointer to a #GBoxed of type @gboxed_type + + + + + + Deserializes a JSON data stream and creates the corresponding +#GObject class. If @gtype implements the #JsonSerializableIface +interface, it will be asked to deserialize all the JSON members +into the respective properties; otherwise, the default implementation +will be used to translate the compatible JSON native types. + + a #GObject or %NULL + + + + + the #GType of object to construct + + + + a JSON data stream + + + + length of the data stream + + + + + + Creates a new #GObject of type @gtype, and constructs it +using the members of the passed #JsonObject +instance. Use g_object_unref() to free the resources +allocated by this function + + The newly created #GObject + + + + + the type of the #GObject to create + + + + a #JsonNode of type %JSON_NODE_OBJECT describing the instance of type @gtype + + + + + + Deserializes a JSON data stream and creates the corresponding +#GObject class. If @gtype implements the #JsonSerializableIface +interface, it will be asked to deserialize all the JSON members +into the respective properties; otherwise, the default implementation +will be used to translate the compatible JSON native types. + + a #GObject or %NULL + + + + + the #GType of object to construct + + + + a JSON data stream + + + + length of the data stream, or -1 if it is NUL-terminated + + + + + + Creates a #JsonNode representing the passed #GObject +instance. Each member of the returned JSON object will +map to a property of the #GObject +of type %JSON_NODE_OBJECT. Use json_node_free() to free +the resources allocated by this function + + the newly created #JsonNode + + + + + a #GObject + + + + + + Serializes a #GObject into a JSON data stream, iterating recursively +over each property. +If @gobject implements the #JsonSerializableIface interface, it will +be asked to serialize all its properties; otherwise, the default +implementation will be use to translate the compatible types into +JSON native types. + + a JSON data stream representing the passed #GObject + + + + + a #GObject + + + + return value for the length of the buffer, or %NULL + + + + + + Serializes a #GObject into a JSON data stream. If @gobject implements +the #JsonSerializableIface interface, it will be asked to serizalize all +its properties; otherwise, the default implementation will be use to +translate the compatible types into JSON native types. + + a JSON data stream representing the passed #GObject + + + + + a #GObject + + + + return value for the length of the buffer, or %NULL + + + + + + diff --git a/extra/clutter/json/ffi/ffi.factor b/extra/clutter/json/ffi/ffi.factor index e9b811c311..5a9d118f75 100644 --- a/extra/clutter/json/ffi/ffi.factor +++ b/extra/clutter/json/ffi/ffi.factor @@ -1,9 +1,16 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection glib.ffi gobject.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: clutter.json.ffi +<< +"gobject.ffi" require +"gio.ffi" require +>> + +LIBRARY: clutter.json + << "clutter.json" { { [ os winnt? ] [ drop ] } @@ -12,5 +19,5 @@ IN: clutter.json.ffi } cond >> -GIR: vocab:clutter/json/ClutterJson-1.0.gir +GIR: vocab:clutter/json/Json-1.0.gir From 005f48986ec3270589a36bdbd668ca422aa29060 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 16 Jan 2011 14:50:18 +0600 Subject: [PATCH 59/76] ui.backend.gtk: update for alien.data changes ('' -> 'int ', etc.); --- basis/ui/backend/gtk/gtk.factor | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index 743d98be51..a5e9a14173 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -542,8 +542,8 @@ M:: gtk-ui-backend system-alert ( caption text -- ) M: gtk-ui-backend (with-ui) [ - 0 f gtk_init - 0 f gtk_gl_init + 0 gint f void* gtk_init + 0 gint f void* gtk_gl_init init-clipboard start-ui stop-io-thread From 4d4dccd96ff550ea53e154e7358d561239964181 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 19 Jan 2011 21:03:13 +0600 Subject: [PATCH 60/76] gdk.ffi: fix stupid typo (the cause for incorrect mouse events on 32-bit); --- basis/gdk/ffi/ffi.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 7107b52aa8..42d901407c 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -47,7 +47,7 @@ STRUCT: GdkEventButton { time guint32 } { x gdouble } { y gdouble } - { axes* gdouble } + { axes gdouble* } { state guint } { button guint } { device GdkDevice* } From 73a07eee31794d844926ec9687c9d1165646444a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 26 Jan 2011 20:27:41 +0600 Subject: [PATCH 61/76] gobject-introspection.ffi: USING: clean up; --- basis/gobject-introspection/ffi/ffi.factor | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/basis/gobject-introspection/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor index ff0eb9a85b..53f0944c20 100644 --- a/basis/gobject-introspection/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -1,16 +1,10 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors alien alien.c-types alien.parser arrays assocs -classes.parser classes.struct combinators -combinators.short-circuit definitions effects fry -gobject-introspection.common gobject-introspection.types kernel -math.parser namespaces parser quotations sequences - -gobject-introspection.standard-types -prettyprint ascii gobject-introspection.repository locals -compiler.units make splitting.monotonic - -sequences.generalizations words words.constant ; +USING: accessors alien.c-types alien.parser arrays ascii +classes.parser classes.struct combinators gobject-introspection.common +gobject-introspection.repository gobject-introspection.types kernel +locals make math.parser namespaces parser sequences +splitting.monotonic words words.constant ; IN: gobject-introspection.ffi SYMBOL: constant-prefix From e9515c1a9c9be1005fe1a1ed76eb45695c756279 Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 26 Jan 2011 21:00:35 +0600 Subject: [PATCH 62/76] ui.backend.gtk: split off unix io support into ui.backend.gtk.io.unix; --- basis/ui/backend/gtk/gtk.factor | 59 ++++-------------------- basis/ui/backend/gtk/io/authors.txt | 1 + basis/ui/backend/gtk/io/io.factor | 8 ++++ basis/ui/backend/gtk/io/unix/authors.txt | 1 + basis/ui/backend/gtk/io/unix/unix.factor | 43 +++++++++++++++++ 5 files changed, 63 insertions(+), 49 deletions(-) create mode 100644 basis/ui/backend/gtk/io/authors.txt create mode 100644 basis/ui/backend/gtk/io/io.factor create mode 100644 basis/ui/backend/gtk/io/unix/authors.txt create mode 100644 basis/ui/backend/gtk/io/unix/unix.factor diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index a5e9a14173..d012de8e18 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -3,12 +3,12 @@ USING: accessors alien.accessors alien.c-types alien.data alien.strings arrays assocs classes.struct command-line destructors gdk.ffi gdk.gl.ffi glib.ffi gobject-introspection.standard-types -gobject.ffi gtk.ffi gtk.gl.ffi io.backend io.backend.unix.multiplexers -io.encodings.utf8 io.thread kernel libc literals locals math -math.bitwise math.order math.vectors namespaces sequences strings -system threads ui ui.backend ui.clipboards ui.event-loop ui.gadgets -ui.gadgets.editors ui.gadgets.private ui.gadgets.worlds ui.gestures -ui.pixel-formats ui.pixel-formats.private ui.private ; +gobject.ffi gtk.ffi gtk.gl.ffi io.encodings.utf8 kernel libc literals +locals math math.bitwise math.order math.vectors namespaces sequences +strings system threads ui ui.backend ui.backend.gtk.io ui.clipboards +ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.private +ui.gadgets.worlds ui.gestures ui.pixel-formats +ui.pixel-formats.private ui.private vocabs.loader ; IN: ui.backend.gtk SINGLETON: gtk-ui-backend @@ -51,48 +51,7 @@ M: gtk-clipboard set-clipboard-contents gtk_clipboard_get swap set-global ] 2bi@ ; -! IO events - -: io-source-prepare ( source timeout -- ? ) - 2drop f ; - -: io-source-check ( source -- ? ) - poll_fds>> 0 g_slist_nth_data GPollFD memory>struct - revents>> 0 = not ; - -: io-source-dispatch ( source callback user_data -- ? ) - 3drop - 0 mx get wait-for-events - yield t ; - -CONSTANT: poll-fd-events - flags{ - G_IO_IN - G_IO_OUT - G_IO_PRI - G_IO_ERR - G_IO_HUP - G_IO_NVAL - } - -: create-poll-fd ( -- poll-fd ) - GPollFD malloc-struct &free - mx get fd>> >>fd - poll-fd-events >>events ; - -HOOK: init-io-event-source io-backend ( -- ) - -M: f init-io-event-source ; -M: c-io-backend init-io-event-source ; - -M: object init-io-event-source - GSourceFuncs malloc-struct &free - [ io-source-prepare ] GSourceFuncsPrepareFunc >>prepare - [ io-source-check ] GSourceFuncsCheckFunc >>check - [ io-source-dispatch ] GSourceFuncsDispatchFunc >>dispatch - GSource heap-size g_source_new &g_source_unref - [ create-poll-fd g_source_add_poll ] - [ f g_source_attach drop ] bi ; +! Timeouts SYMBOL: next-timeout @@ -546,7 +505,6 @@ M: gtk-ui-backend (with-ui) 0 gint f void* gtk_gl_init init-clipboard start-ui - stop-io-thread [ init-io-event-source init-timeout @@ -557,4 +515,7 @@ M: gtk-ui-backend (with-ui) gtk-ui-backend ui-backend set-global +{ "ui.backend.gtk" "io.backend.unix" } +"ui.backend.gtk.io.unix" require-when + [ "ui.tools" ] main-vocab-hook set-global diff --git a/basis/ui/backend/gtk/io/authors.txt b/basis/ui/backend/gtk/io/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/ui/backend/gtk/io/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/ui/backend/gtk/io/io.factor b/basis/ui/backend/gtk/io/io.factor new file mode 100644 index 0000000000..8288c893cc --- /dev/null +++ b/basis/ui/backend/gtk/io/io.factor @@ -0,0 +1,8 @@ +! Copyright (C) 2011 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: io.backend kernel ; +IN: ui.backend.gtk.io + +HOOK: init-io-event-source io-backend ( -- ) + +M: object init-io-event-source ; \ No newline at end of file diff --git a/basis/ui/backend/gtk/io/unix/authors.txt b/basis/ui/backend/gtk/io/unix/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/ui/backend/gtk/io/unix/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/ui/backend/gtk/io/unix/unix.factor b/basis/ui/backend/gtk/io/unix/unix.factor new file mode 100644 index 0000000000..50a1059678 --- /dev/null +++ b/basis/ui/backend/gtk/io/unix/unix.factor @@ -0,0 +1,43 @@ +! Copyright (C) 2011 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: accessors alien.c-types classes.struct glib.ffi +io.backend.unix.multiplexers io.thread kernel libc literals namespaces +system threads ui.backend.gtk.io ; +IN: ui.backend.gtk.io.unix + +: prepare ( source timeout -- ? ) + 2drop f ; + +: check ( source -- ? ) + poll_fds>> 0 g_slist_nth_data GPollFD memory>struct + revents>> 0 = not ; + +: dispatch ( source callback user-data -- ? ) + 3drop + 0 mx get wait-for-events + yield t ; + +CONSTANT: poll-fd-events + flags{ + G_IO_IN + G_IO_OUT + G_IO_PRI + G_IO_ERR + G_IO_HUP + G_IO_NVAL + } + +: ( -- poll-fd ) + GPollFD malloc-struct &free + mx get fd>> >>fd + poll-fd-events >>events ; + +M: unix init-io-event-source + stop-io-thread + GSourceFuncs malloc-struct &free + [ prepare ] GSourceFuncsPrepareFunc >>prepare + [ check ] GSourceFuncsCheckFunc >>check + [ dispatch ] GSourceFuncsDispatchFunc >>dispatch + GSource heap-size g_source_new &g_source_unref + [ g_source_add_poll ] + [ f g_source_attach drop ] bi ; From 640b05d4573fce1c5e1b80ad68febab67151b66d Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Wed, 26 Jan 2011 21:37:26 +0600 Subject: [PATCH 63/76] ui.backend.gtk: split off input methods support for ui.editors into .input-methods.editors (no more ui.editors with its dependencies in a deployed image for hello-ui); --- basis/ui/backend/gtk/gtk.factor | 31 +++++-------------- .../ui/backend/gtk/input-methods/authors.txt | 1 + .../gtk/input-methods/editors/authors.txt | 1 + .../gtk/input-methods/editors/editors.factor | 16 ++++++++++ .../gtk/input-methods/input-methods.factor | 11 +++++++ 5 files changed, 37 insertions(+), 23 deletions(-) create mode 100644 basis/ui/backend/gtk/input-methods/authors.txt create mode 100644 basis/ui/backend/gtk/input-methods/editors/authors.txt create mode 100644 basis/ui/backend/gtk/input-methods/editors/editors.factor create mode 100644 basis/ui/backend/gtk/input-methods/input-methods.factor diff --git a/basis/ui/backend/gtk/gtk.factor b/basis/ui/backend/gtk/gtk.factor index d012de8e18..378a2b56c2 100644 --- a/basis/ui/backend/gtk/gtk.factor +++ b/basis/ui/backend/gtk/gtk.factor @@ -5,9 +5,9 @@ alien.strings arrays assocs classes.struct command-line destructors gdk.ffi gdk.gl.ffi glib.ffi gobject-introspection.standard-types gobject.ffi gtk.ffi gtk.gl.ffi io.encodings.utf8 kernel libc literals locals math math.bitwise math.order math.vectors namespaces sequences -strings system threads ui ui.backend ui.backend.gtk.io ui.clipboards -ui.event-loop ui.gadgets ui.gadgets.editors ui.gadgets.private -ui.gadgets.worlds ui.gestures ui.pixel-formats +strings system threads ui ui.backend ui.backend.gtk.input-methods +ui.backend.gtk.io ui.clipboards ui.event-loop ui.gadgets +ui.gadgets.private ui.gadgets.worlds ui.gestures ui.pixel-formats ui.pixel-formats.private ui.private vocabs.loader ; IN: ui.backend.gtk @@ -240,27 +240,9 @@ CONSTANT: action-key-codes ! Input methods -GENERIC: support-input-methods? ( gadget -- ? ) -GENERIC: get-cursor-surrounding ( gadget -- text cursor-pos ) -GENERIC: delete-cursor-surrounding ( offset count gadget -- ) -GENERIC: get-cursor-loc&dim ( gadget -- loc dim ) - -M: gadget support-input-methods? drop f ; - -M: editor support-input-methods? drop t ; - -M: editor get-cursor-surrounding - dup editor-caret first2 [ swap editor-line ] dip ; - -M: editor delete-cursor-surrounding - 3drop ; - -M: editor get-cursor-loc&dim - [ caret-loc ] [ caret-dim ] bi ; - : on-retrieve-surrounding ( im-context win -- ? ) window world-focus dup support-input-methods? [ - get-cursor-surrounding [ utf8 string>alien -1 ] dip + cursor-surrounding [ utf8 string>alien -1 ] dip gtk_im_context_set_surrounding t ] [ 2drop f ] if ; @@ -272,7 +254,7 @@ M: editor get-cursor-loc&dim [ drop ] [ utf8 alien>string ] [ window ] tri* user-input ; : gadget-cursor-location ( gadget -- rectangle ) - [ screen-loc ] [ get-cursor-loc&dim ] bi [ v+ ] dip + [ screen-loc ] [ cursor-loc&dim ] bi [ v+ ] dip [ first2 [ >fixnum ] bi@ ] bi@ cairo_rectangle_int_t ; @@ -518,4 +500,7 @@ gtk-ui-backend ui-backend set-global { "ui.backend.gtk" "io.backend.unix" } "ui.backend.gtk.io.unix" require-when +{ "ui.backend.gtk" "ui.gadgets.editors" } +"ui.backend.gtk.input-methods.editors" require-when + [ "ui.tools" ] main-vocab-hook set-global diff --git a/basis/ui/backend/gtk/input-methods/authors.txt b/basis/ui/backend/gtk/input-methods/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/ui/backend/gtk/input-methods/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/ui/backend/gtk/input-methods/editors/authors.txt b/basis/ui/backend/gtk/input-methods/editors/authors.txt new file mode 100644 index 0000000000..4af9fbeb0a --- /dev/null +++ b/basis/ui/backend/gtk/input-methods/editors/authors.txt @@ -0,0 +1 @@ +Anton Gorenko diff --git a/basis/ui/backend/gtk/input-methods/editors/editors.factor b/basis/ui/backend/gtk/input-methods/editors/editors.factor new file mode 100644 index 0000000000..2f648a4e95 --- /dev/null +++ b/basis/ui/backend/gtk/input-methods/editors/editors.factor @@ -0,0 +1,16 @@ +! Copyright (C) 2011 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: kernel sequences ui.backend.gtk.input-methods +ui.gadgets.editors ; +IN: ui.backend.gtk.input-methods.editors + +M: editor support-input-methods? drop t ; + +M: editor cursor-surrounding + dup editor-caret first2 [ swap editor-line ] dip ; + +M: editor delete-cursor-surrounding + 3drop ; + +M: editor cursor-loc&dim + [ caret-loc ] [ caret-dim ] bi ; diff --git a/basis/ui/backend/gtk/input-methods/input-methods.factor b/basis/ui/backend/gtk/input-methods/input-methods.factor new file mode 100644 index 0000000000..1ad6cd3693 --- /dev/null +++ b/basis/ui/backend/gtk/input-methods/input-methods.factor @@ -0,0 +1,11 @@ +! Copyright (C) 2011 Anton Gorenko. +! See http://factorcode.org/license.txt for BSD license. +USING: kernel ui.gadgets ; +IN: ui.backend.gtk.input-methods + +GENERIC: support-input-methods? ( gadget -- ? ) +GENERIC: cursor-surrounding ( gadget -- text cursor-pos ) +GENERIC: delete-cursor-surrounding ( offset count gadget -- ) +GENERIC: cursor-loc&dim ( gadget -- loc dim ) + +M: gadget support-input-methods? drop f ; From 779468f5a0998ce087752850bb929b7c505a57e7 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 13:55:02 -0800 Subject: [PATCH 64/76] calendar: make it deploy with threads disabled --- basis/calendar/calendar.factor | 7 +++---- basis/calendar/threads/threads.factor | 7 +++++++ 2 files changed, 10 insertions(+), 4 deletions(-) create mode 100644 basis/calendar/threads/threads.factor diff --git a/basis/calendar/calendar.factor b/basis/calendar/calendar.factor index 4e6b35161f..85a1c72d11 100644 --- a/basis/calendar/calendar.factor +++ b/basis/calendar/calendar.factor @@ -2,7 +2,7 @@ ! See http://factorcode.org/license.txt for BSD license. USING: accessors arrays classes.tuple combinators combinators.short-circuit kernel locals math math.functions -math.order sequences summary system threads vocabs.loader ; +math.order sequences summary system vocabs.loader ; IN: calendar HOOK: gmt-offset os ( -- hours minutes seconds ) @@ -540,10 +540,9 @@ M: integer end-of-year 12 31 ; : unix-time>timestamp ( seconds -- timestamp ) seconds unix-1970 time+ ; -M: duration sleep - duration>nanoseconds >integer nano-count + sleep-until ; - { { [ os unix? ] [ "calendar.unix" ] } { [ os windows? ] [ "calendar.windows" ] } } cond require + +{ "threads" "calendar" } "calendar.threads" require-when diff --git a/basis/calendar/threads/threads.factor b/basis/calendar/threads/threads.factor new file mode 100644 index 0000000000..efdbb6923d --- /dev/null +++ b/basis/calendar/threads/threads.factor @@ -0,0 +1,7 @@ +! Copyright (C) 2011 Slava Pestov. +! See http://factorcode.org/license.txt for BSD license. +USING: calendar math system threads ; +IN: calendar.threads + +M: duration sleep + duration>nanoseconds >integer nano-count + sleep-until ; From 25c60b6869e72046161d1f2a3366bf2b797c691f Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 13:55:15 -0800 Subject: [PATCH 65/76] tools.deploy.test.21: deploy without threads to reduce image size --- basis/tools/deploy/test/21/deploy.factor | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/basis/tools/deploy/test/21/deploy.factor b/basis/tools/deploy/test/21/deploy.factor index 7c155dee3e..8def1d373f 100644 --- a/basis/tools/deploy/test/21/deploy.factor +++ b/basis/tools/deploy/test/21/deploy.factor @@ -10,6 +10,6 @@ H{ { deploy-reflection 1 } { deploy-word-props? f } { deploy-math? t } - { deploy-threads? t } + { deploy-threads? f } { deploy-word-defs? f } } From e3c08f32ced112bc9b99a10f7c40a108cc61fa58 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 13:55:43 -0800 Subject: [PATCH 66/76] bootstrap.{io, ui}: load dependencies to make deploy tool less error-prone --- basis/bootstrap/io/io.factor | 5 ++++- basis/bootstrap/ui/ui.factor | 20 +++++++++++--------- 2 files changed, 15 insertions(+), 10 deletions(-) diff --git a/basis/bootstrap/io/io.factor b/basis/bootstrap/io/io.factor index 5740d44431..45cd2a1ce2 100644 --- a/basis/bootstrap/io/io.factor +++ b/basis/bootstrap/io/io.factor @@ -2,7 +2,10 @@ USING: system vocabs vocabs.loader kernel combinators namespaces sequences io.backend accessors ; IN: bootstrap.io -"bootstrap.compiler" vocab [ +"bootstrap.compiler" require +"bootstrap.threads" require + +[ "io.backend." { { [ "io-backend" get ] [ "io-backend" get ] } { [ os unix? ] [ "unix." os name>> append ] } diff --git a/basis/bootstrap/ui/ui.factor b/basis/bootstrap/ui/ui.factor index 271a99c223..0b39ea1866 100644 --- a/basis/bootstrap/ui/ui.factor +++ b/basis/bootstrap/ui/ui.factor @@ -2,12 +2,14 @@ USING: alien namespaces system combinators kernel sequences vocabs vocabs.loader ; IN: bootstrap.ui -"bootstrap.compiler" vocab [ - "ui-backend" get [ - { - { [ os macosx? ] [ "cocoa" ] } - { [ os windows? ] [ "windows" ] } - { [ os unix? ] [ "x11" ] } - } cond - ] unless* "ui.backend." prepend require -] when +"bootstrap.math" require +"bootstrap.compiler" require +"bootstrap.threads" require + +"ui-backend" get [ + { + { [ os macosx? ] [ "cocoa" ] } + { [ os windows? ] [ "windows" ] } + { [ os unix? ] [ "x11" ] } + } cond +] unless* "ui.backend." prepend require From db29973ccbc88877a913c05daf1ccdb21be441ae Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 13:55:54 -0800 Subject: [PATCH 67/76] io.sockets: fix unit test on Windows --- basis/io/sockets/sockets-tests.factor | 7 +++++-- basis/io/sockets/sockets.factor | 8 ++++---- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/basis/io/sockets/sockets-tests.factor b/basis/io/sockets/sockets-tests.factor index 0c79323a24..7e57f87a9e 100644 --- a/basis/io/sockets/sockets-tests.factor +++ b/basis/io/sockets/sockets-tests.factor @@ -1,10 +1,13 @@ USING: io.sockets io.sockets.private sequences math tools.test namespaces accessors kernel destructors calendar io.timeouts io.encodings.utf8 io concurrency.promises threads -io.streams.string present ; +io.streams.string present system ; IN: io.sockets.tests -[ T{ local f "/tmp/foo" } ] [ "/tmp/foo" ] unit-test +os unix? [ + [ T{ local f "/tmp/foo" } ] [ "/tmp/foo" ] unit-test +] when + [ T{ inet4 f f 0 } ] [ f 0 ] unit-test [ T{ inet6 f f 0 1 } ] [ f 1 ] unit-test diff --git a/basis/io/sockets/sockets.factor b/basis/io/sockets/sockets.factor index b567721e3f..0865500f76 100644 --- a/basis/io/sockets/sockets.factor +++ b/basis/io/sockets/sockets.factor @@ -1,10 +1,10 @@ -! Copyright (C) 2007, 2010 Slava Pestov, Doug Coleman, +! Copyright (C) 2007, 2011 Slava Pestov, Doug Coleman, ! Daniel Ehrenberg. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.c-types alien.data alien.strings arrays assocs byte-arrays classes classes.struct combinators combinators.short-circuit continuations destructors fry generic -grouping init io.backend io.binary io.encodings +grouping init io.backend io.pathnames io.binary io.encodings io.encodings.ascii io.encodings.binary io.ports io.streams.duplex kernel math math.parser memoize namespaces parser present sequences splitting strings summary system @@ -55,10 +55,10 @@ HOOK: addrspec-of-family os ( af -- addrspec ) PRIVATE> -TUPLE: local { path read-only } ; +TUPLE: local { path string read-only } ; : ( path -- addrspec ) - normalize-path local boa ; + absolute-path local boa ; M: local present path>> "Unix domain socket: " prepend ; From 609d6f9166f99292dd5b46351d7fb952d167f698 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 15:02:20 -0800 Subject: [PATCH 68/76] bootstrap.io: fix load error --- basis/bootstrap/io/io.factor | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/basis/bootstrap/io/io.factor b/basis/bootstrap/io/io.factor index 45cd2a1ce2..789bb1556b 100644 --- a/basis/bootstrap/io/io.factor +++ b/basis/bootstrap/io/io.factor @@ -5,10 +5,8 @@ IN: bootstrap.io "bootstrap.compiler" require "bootstrap.threads" require -[ - "io.backend." { - { [ "io-backend" get ] [ "io-backend" get ] } - { [ os unix? ] [ "unix." os name>> append ] } - { [ os windows? ] [ "windows" ] } - } cond append require -] when +"io.backend." { + { [ "io-backend" get ] [ "io-backend" get ] } + { [ os unix? ] [ "unix." os name>> append ] } + { [ os windows? ] [ "windows" ] } +} cond append require From 5a3c5c7749862eff3e9a090f9de8edb6bfb7d5f6 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 16:43:26 -0800 Subject: [PATCH 69/76] compiler.cfg.branch-splitting was totally broken --- .../branch-splitting/branch-splitting.factor | 56 +++++++++++++------ .../compiler/cfg/builder/builder-tests.factor | 3 + 2 files changed, 42 insertions(+), 17 deletions(-) diff --git a/basis/compiler/cfg/branch-splitting/branch-splitting.factor b/basis/compiler/cfg/branch-splitting/branch-splitting.factor index 985d296cc6..eab1453b3d 100644 --- a/basis/compiler/cfg/branch-splitting/branch-splitting.factor +++ b/basis/compiler/cfg/branch-splitting/branch-splitting.factor @@ -1,19 +1,20 @@ -! Copyright (C) 2009, 2010 Doug Coleman, Slava Pestov. +! Copyright (C) 2009, 2011 Doug Coleman, Slava Pestov. ! See http://factorcode.org/license.txt for BSD license. -USING: accessors combinators combinators.short-circuit kernel -locals math math.order sequences assocs namespaces vectors fry -arrays splitting compiler.cfg.def-use compiler.cfg +USING: arrays accessors assocs combinators combinators.short-circuit +dlists deques kernel locals math math.order sequences +sets vectors fry splitting compiler.cfg.def-use compiler.cfg compiler.cfg.rpo compiler.cfg.predecessors compiler.cfg.renaming compiler.cfg.instructions compiler.cfg.utilities ; +FROM: namespaces => get set ; IN: compiler.cfg.branch-splitting : clone-instructions ( insns -- insns' ) [ clone dup rename-insn-temps ] map ; : clone-basic-block ( bb -- bb' ) - ! The new block temporarily gets the same RPO number as the old one, - ! until the next time RPO is computed. This is just to make - ! 'back-edge?' work. + ! The new block temporarily gets the same RPO number as the + ! old one, until the next time RPO is computed. This is just + ! to make 'back-edge?' work. swap { @@ -25,18 +26,21 @@ IN: compiler.cfg.branch-splitting : new-blocks ( bb -- copies ) dup predecessors>> [ - [ clone-basic-block ] dip - 1vector >>predecessors + [ clone-basic-block ] [ 1vector ] bi* + >>predecessors ] with map ; : update-predecessor-successors ( copies old-bb -- ) [ predecessors>> swap ] keep - '[ [ _ ] 2dip update-predecessors ] 2each ; + '[ [ _ ] dip update-successors ] 2each ; :: update-successor-predecessor ( copies old-bb succ -- ) - succ - [ { old-bb } split copies join V{ } like ] change-predecessors - drop ; + succ predecessors>> dup >array :> ( preds preds' ) + preds delete-all + preds' [ + dup old-bb eq? + [ drop copies preds push-all ] [ preds push ] if + ] each ; : update-successor-predecessors ( copies old-bb -- ) dup successors>> @@ -77,11 +81,29 @@ UNION: irrelevant ##peek ##replace ##inc-d ##inc-r ; ] if ] if ; +SYMBOL: worklist +SYMBOL: visited + +: add-to-worklist ( bb -- ) + dup visited get in? [ drop ] [ + [ visited get adjoin ] + [ worklist get push-front ] bi + ] if ; + +: init-worklist ( cfg -- ) + worklist set + HS{ } clone visited set + entry>> add-to-worklist ; + : split-branches ( cfg -- cfg' ) needs-predecessors - - dup [ - dup split-branch? [ split-branch ] [ drop ] if - ] each-basic-block + dup init-worklist + ! For back-edge? + dup post-order drop + + worklist get [ + dup split-branch? [ dup split-branch ] when + successors>> [ add-to-worklist ] each + ] slurp-deque cfg-changed ; diff --git a/basis/compiler/cfg/builder/builder-tests.factor b/basis/compiler/cfg/builder/builder-tests.factor index 5f2b75f0e0..9677dc30ca 100644 --- a/basis/compiler/cfg/builder/builder-tests.factor +++ b/basis/compiler/cfg/builder/builder-tests.factor @@ -221,3 +221,6 @@ IN: compiler.cfg.builder.tests ! Regression. Make sure everything is inlined correctly [ f ] [ M\ hashtable set-at [ { [ ##call? ] [ word>> \ set-slot eq? ] } 1&& ] contains-insn? ] unit-test + +! Regression. Make sure branch splitting works. +[ 2 ] [ [ 1 2 ? ] [ ##return? ] count-insns ] unit-test From d6fe7f4c283fe079b19d0c5799aef1c42999aadf Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 16:36:01 -0600 Subject: [PATCH 70/76] On Unix, link VM with GTK libraries instead of loading them dynamically --- basis/atk/ffi/ffi.factor | 3 +-- basis/gdk/ffi/ffi.factor | 3 +-- basis/gdk/gl/ffi/ffi.factor | 8 -------- basis/gdk/pixbuf/ffi/ffi.factor | 3 +-- basis/gio/ffi/ffi.factor | 3 +-- basis/glib/ffi/ffi.factor | 6 +++--- basis/gobject/ffi/ffi.factor | 5 ++--- basis/gtk/ffi/ffi.factor | 3 +-- basis/pango/cairo/ffi/ffi.factor | 6 +++--- basis/pango/ffi/ffi.factor | 5 ++--- vm/Config.unix | 2 +- 11 files changed, 16 insertions(+), 31 deletions(-) diff --git a/basis/atk/ffi/ffi.factor b/basis/atk/ffi/ffi.factor index 1f2c5b4926..147a7e4909 100644 --- a/basis/atk/ffi/ffi.factor +++ b/basis/atk/ffi/ffi.factor @@ -13,8 +13,7 @@ LIBRARY: atk << "atk" { { [ os winnt? ] [ "libatk-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libatk-1.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/gdk/ffi/ffi.factor b/basis/gdk/ffi/ffi.factor index 42d901407c..689193a8d9 100644 --- a/basis/gdk/ffi/ffi.factor +++ b/basis/gdk/ffi/ffi.factor @@ -16,8 +16,7 @@ LIBRARY: gdk << "gdk" { { [ os winnt? ] [ "libgdk-win32-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdk-x11-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/gdk/gl/ffi/ffi.factor b/basis/gdk/gl/ffi/ffi.factor index 27ea883919..d1f93cf62a 100644 --- a/basis/gdk/gl/ffi/ffi.factor +++ b/basis/gdk/gl/ffi/ffi.factor @@ -10,12 +10,4 @@ IN: gdk.gl.ffi LIBRARY: gdk.gl -<< -"gdk.gl" { - { [ os winnt? ] [ drop ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdkglext-x11-1.0.so" cdecl add-library ] } -} cond ->> - GIR: vocab:gdk/gl/GdkGLExt-1.0.gir diff --git a/basis/gdk/pixbuf/ffi/ffi.factor b/basis/gdk/pixbuf/ffi/ffi.factor index ecc73bd5d4..113cf8d0c8 100644 --- a/basis/gdk/pixbuf/ffi/ffi.factor +++ b/basis/gdk/pixbuf/ffi/ffi.factor @@ -13,8 +13,7 @@ LIBRARY: gdk.pixbuf << "gdk.pixbuf" { { [ os winnt? ] [ "libgdk_pixbuf-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgdk_pixbuf-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/gio/ffi/ffi.factor b/basis/gio/ffi/ffi.factor index e2247e8a9e..3eb09c5105 100644 --- a/basis/gio/ffi/ffi.factor +++ b/basis/gio/ffi/ffi.factor @@ -13,8 +13,7 @@ LIBRARY: gio << "gio" { { [ os winnt? ] [ "libgio-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgio-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/glib/ffi/ffi.factor b/basis/glib/ffi/ffi.factor index 0fd972f226..860d34bb8d 100644 --- a/basis/glib/ffi/ffi.factor +++ b/basis/glib/ffi/ffi.factor @@ -1,8 +1,8 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.destructors alien.libraries alien.syntax -combinators gobject-introspection gobject-introspection.standard-types -system ; +combinators kernel gobject-introspection +gobject-introspection.standard-types system ; IN: glib.ffi LIBRARY: glib @@ -11,7 +11,7 @@ LIBRARY: glib "glib" { { [ os winnt? ] [ "libglib-2.0-0.dll" cdecl add-library ] } { [ os macosx? ] [ "/opt/local/lib/libglib-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libglib-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/gobject/ffi/ffi.factor b/basis/gobject/ffi/ffi.factor index 070a2c5dea..705adedb7e 100644 --- a/basis/gobject/ffi/ffi.factor +++ b/basis/gobject/ffi/ffi.factor @@ -1,6 +1,6 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.destructors alien.libraries alien.syntax +USING: alien alien.destructors alien.libraries alien.syntax kernel combinators gobject-introspection literals math system vocabs.loader ; IN: gobject.ffi @@ -13,8 +13,7 @@ LIBRARY: gobject << "gobject" { { [ os winnt? ] [ "libobject-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libgobject-2.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libgobject-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/gtk/ffi/ffi.factor b/basis/gtk/ffi/ffi.factor index 1a4c3ebca0..a2d6e7be32 100644 --- a/basis/gtk/ffi/ffi.factor +++ b/basis/gtk/ffi/ffi.factor @@ -16,8 +16,7 @@ LIBRARY: gtk << "gtk" { { [ os winnt? ] [ "libgtk-win32-2.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ drop ] } - { [ os unix? ] [ "libgtk-x11-2.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/pango/cairo/ffi/ffi.factor b/basis/pango/cairo/ffi/ffi.factor index 1b19ba6ab7..4cb61326e2 100644 --- a/basis/pango/cairo/ffi/ffi.factor +++ b/basis/pango/cairo/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.libraries alien.syntax cairo.ffi combinators -gobject-introspection system vocabs.loader ; +kernel gobject-introspection system vocabs.loader ; IN: pango.cairo.ffi << @@ -13,8 +13,8 @@ LIBRARY: pango.cairo << "pango.cairo" { { [ os winnt? ] [ "libpangocairo-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libpangocairo-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libpangocairo-1.0.so" cdecl add-library ] } + { [ os macosx? ] [ drop ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/basis/pango/ffi/ffi.factor b/basis/pango/ffi/ffi.factor index 4e05226edc..fb3cb3cdbf 100644 --- a/basis/pango/ffi/ffi.factor +++ b/basis/pango/ffi/ffi.factor @@ -1,7 +1,7 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: alien alien.c-types alien.destructors alien.libraries -alien.syntax combinators gobject-introspection +alien.syntax combinators kernel gobject-introspection gobject-introspection.standard-types system vocabs.loader ; IN: pango.ffi @@ -14,8 +14,7 @@ LIBRARY: pango << "pango" { { [ os winnt? ] [ "libpango-1.0-0.dll" cdecl add-library ] } - { [ os macosx? ] [ "/opt/local/lib/libpango-1.0.0.dylib" cdecl add-library ] } - { [ os unix? ] [ "libpango-1.0.so" cdecl add-library ] } + { [ os unix? ] [ drop ] } } cond >> diff --git a/vm/Config.unix b/vm/Config.unix index d7214a622b..9289ae0ad4 100644 --- a/vm/Config.unix +++ b/vm/Config.unix @@ -14,7 +14,7 @@ PLAF_EXE_OBJS += vm/main-unix.o ifdef NO_UI X11_UI_LIBS = else - X11_UI_LIBS = -lpango-1.0 -lpangocairo-1.0 -lcairo -lglib-2.0 -lgobject-2.0 -lGL -lX11 + X11_UI_LIBS = -lpango-1.0 -lpangocairo-1.0 -lcairo -lglib-2.0 -lgobject-2.0 -lgtk-x11-2.0 -lgdk-x11-2.0 -lgdk_pixbuf-2.0 -lgtkglext-x11-1.0 -latk-1.0 -lgio-2.0 -lgdkglext-x11-1.0 -lGL endif # CFLAGS += -fPIC From 8c14dd65b5c33f1a6c2a31bc152d22ce6c90ba0b Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Sun, 27 Feb 2011 20:00:30 -0600 Subject: [PATCH 71/76] tools.deploy.shaker: strip out GObject introspection info --- basis/tools/deploy/shaker/shaker.factor | 8 ++++++++ basis/tools/deploy/shaker/strip-gobject.factor | 3 +++ 2 files changed, 11 insertions(+) create mode 100644 basis/tools/deploy/shaker/strip-gobject.factor diff --git a/basis/tools/deploy/shaker/shaker.factor b/basis/tools/deploy/shaker/shaker.factor index 941b3e07f2..2329b06b13 100755 --- a/basis/tools/deploy/shaker/shaker.factor +++ b/basis/tools/deploy/shaker/shaker.factor @@ -93,6 +93,13 @@ IN: tools.deploy.shaker run-file ] when ; +: strip-gobject ( -- ) + "gobject-introspection.types" vocab [ + "Stripping GObject type info" show + "vocab:tools/deploy/shaker/strip-gobject.factor" + run-file + ] when ; + : strip-specialized-arrays ( -- ) strip-dictionary? "specialized-arrays" vocab and [ "Stripping specialized arrays" show @@ -534,6 +541,7 @@ SYMBOL: deploy-vocab strip-destructors strip-call strip-cocoa + strip-gobject strip-debugger strip-ui-error-hook strip-specialized-arrays diff --git a/basis/tools/deploy/shaker/strip-gobject.factor b/basis/tools/deploy/shaker/strip-gobject.factor new file mode 100644 index 0000000000..53c4419025 --- /dev/null +++ b/basis/tools/deploy/shaker/strip-gobject.factor @@ -0,0 +1,3 @@ +USING: namespaces assocs gobject-introspection.types ; + +type-infos global delete-at From 368d2a081898a969ce98b63b54ea069545b1b766 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Fri, 4 Mar 2011 18:11:42 -0500 Subject: [PATCH 72/76] Move gstreamer and clutter bindings to unmaintained/ for now, until Anton can fix them, to make the build work --- {extra => unmaintained}/clutter/Clutter-1.0.gir | 0 {extra => unmaintained}/clutter/authors.txt | 0 {extra => unmaintained}/clutter/clutter.factor | 0 {extra => unmaintained}/clutter/cogl/Cogl-1.0.gir | 0 {extra => unmaintained}/clutter/cogl/cogl.factor | 0 {extra => unmaintained}/clutter/cogl/ffi/ffi.factor | 0 {extra => unmaintained}/clutter/ffi/ffi.factor | 0 {extra => unmaintained}/clutter/gtk/GtkClutter-0.10.gir | 0 {extra => unmaintained}/clutter/gtk/ffi/ffi.factor | 0 {extra => unmaintained}/clutter/gtk/gtk.factor | 0 {extra => unmaintained}/clutter/json/Json-1.0.gir | 0 {extra => unmaintained}/clutter/json/ffi/ffi.factor | 0 {extra => unmaintained}/clutter/json/json.factor | 0 {extra => unmaintained}/clutter/summary.txt | 0 {extra => unmaintained}/clutter/tags.txt | 0 .../gir/samples/lowlevel/gstreamer/authors.txt | 0 .../gir/samples/lowlevel/gstreamer/gstreamer.factor | 0 {extra => unmaintained}/gstreamer/Gst-0.10.gir | 0 {extra => unmaintained}/gstreamer/app/GstApp-0.10.gir | 0 {extra => unmaintained}/gstreamer/app/app.factor | 0 {extra => unmaintained}/gstreamer/app/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/audio/GstAudio-0.10.gir | 0 {extra => unmaintained}/gstreamer/audio/audio.factor | 0 {extra => unmaintained}/gstreamer/audio/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/authors.txt | 0 {extra => unmaintained}/gstreamer/base/GstBase-0.10.gir | 0 {extra => unmaintained}/gstreamer/base/base.factor | 0 {extra => unmaintained}/gstreamer/base/ffi/ffi.factor | 0 .../gstreamer/controller/GstController-0.10.gir | 0 {extra => unmaintained}/gstreamer/controller/controller.factor | 0 {extra => unmaintained}/gstreamer/controller/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/fft/GstFft-0.10.gir | 0 {extra => unmaintained}/gstreamer/fft/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/fft/fft.factor | 0 {extra => unmaintained}/gstreamer/gstreamer.factor | 0 .../gstreamer/interfaces/GstInterfaces-0.10.gir | 0 {extra => unmaintained}/gstreamer/interfaces/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/interfaces/interfaces.factor | 0 {extra => unmaintained}/gstreamer/net/GstNet-0.10.gir | 0 {extra => unmaintained}/gstreamer/net/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/net/net.factor | 0 {extra => unmaintained}/gstreamer/netbuffer/GstNetbuffer-0.10.gir | 0 {extra => unmaintained}/gstreamer/netbuffer/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/netbuffer/netbuffer.factor | 0 {extra => unmaintained}/gstreamer/pbutils/GstPbutils-0.10.gir | 0 {extra => unmaintained}/gstreamer/pbutils/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/pbutils/pbutils.factor | 0 {extra => unmaintained}/gstreamer/riff/GstRiff-0.10.gir | 0 {extra => unmaintained}/gstreamer/riff/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/riff/riff.factor | 0 {extra => unmaintained}/gstreamer/rtp/GstRtp-0.10.gir | 0 {extra => unmaintained}/gstreamer/rtp/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/rtp/rtp.factor | 0 {extra => unmaintained}/gstreamer/rtsp/GstRtsp-0.10.gir | 0 {extra => unmaintained}/gstreamer/rtsp/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/rtsp/rtsp.factor | 0 {extra => unmaintained}/gstreamer/sdp/GstSdp-0.10.gir | 0 {extra => unmaintained}/gstreamer/sdp/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/sdp/sdp.factor | 0 {extra => unmaintained}/gstreamer/summary.txt | 0 {extra => unmaintained}/gstreamer/tag/GstTag-0.10.gir | 0 {extra => unmaintained}/gstreamer/tag/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/tag/tag.factor | 0 {extra => unmaintained}/gstreamer/tags.txt | 0 {extra => unmaintained}/gstreamer/video/GstVideo-0.10.gir | 0 {extra => unmaintained}/gstreamer/video/ffi/ffi.factor | 0 {extra => unmaintained}/gstreamer/video/video.factor | 0 68 files changed, 0 insertions(+), 0 deletions(-) rename {extra => unmaintained}/clutter/Clutter-1.0.gir (100%) rename {extra => unmaintained}/clutter/authors.txt (100%) rename {extra => unmaintained}/clutter/clutter.factor (100%) rename {extra => unmaintained}/clutter/cogl/Cogl-1.0.gir (100%) rename {extra => unmaintained}/clutter/cogl/cogl.factor (100%) rename {extra => unmaintained}/clutter/cogl/ffi/ffi.factor (100%) rename {extra => unmaintained}/clutter/ffi/ffi.factor (100%) rename {extra => unmaintained}/clutter/gtk/GtkClutter-0.10.gir (100%) rename {extra => unmaintained}/clutter/gtk/ffi/ffi.factor (100%) rename {extra => unmaintained}/clutter/gtk/gtk.factor (100%) rename {extra => unmaintained}/clutter/json/Json-1.0.gir (100%) rename {extra => unmaintained}/clutter/json/ffi/ffi.factor (100%) rename {extra => unmaintained}/clutter/json/json.factor (100%) rename {extra => unmaintained}/clutter/summary.txt (100%) rename {extra => unmaintained}/clutter/tags.txt (100%) rename {extra => unmaintained}/gir/samples/lowlevel/gstreamer/authors.txt (100%) rename {extra => unmaintained}/gir/samples/lowlevel/gstreamer/gstreamer.factor (100%) rename {extra => unmaintained}/gstreamer/Gst-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/app/GstApp-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/app/app.factor (100%) rename {extra => unmaintained}/gstreamer/app/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/audio/GstAudio-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/audio/audio.factor (100%) rename {extra => unmaintained}/gstreamer/audio/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/authors.txt (100%) rename {extra => unmaintained}/gstreamer/base/GstBase-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/base/base.factor (100%) rename {extra => unmaintained}/gstreamer/base/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/controller/GstController-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/controller/controller.factor (100%) rename {extra => unmaintained}/gstreamer/controller/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/fft/GstFft-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/fft/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/fft/fft.factor (100%) rename {extra => unmaintained}/gstreamer/gstreamer.factor (100%) rename {extra => unmaintained}/gstreamer/interfaces/GstInterfaces-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/interfaces/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/interfaces/interfaces.factor (100%) rename {extra => unmaintained}/gstreamer/net/GstNet-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/net/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/net/net.factor (100%) rename {extra => unmaintained}/gstreamer/netbuffer/GstNetbuffer-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/netbuffer/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/netbuffer/netbuffer.factor (100%) rename {extra => unmaintained}/gstreamer/pbutils/GstPbutils-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/pbutils/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/pbutils/pbutils.factor (100%) rename {extra => unmaintained}/gstreamer/riff/GstRiff-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/riff/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/riff/riff.factor (100%) rename {extra => unmaintained}/gstreamer/rtp/GstRtp-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/rtp/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/rtp/rtp.factor (100%) rename {extra => unmaintained}/gstreamer/rtsp/GstRtsp-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/rtsp/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/rtsp/rtsp.factor (100%) rename {extra => unmaintained}/gstreamer/sdp/GstSdp-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/sdp/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/sdp/sdp.factor (100%) rename {extra => unmaintained}/gstreamer/summary.txt (100%) rename {extra => unmaintained}/gstreamer/tag/GstTag-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/tag/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/tag/tag.factor (100%) rename {extra => unmaintained}/gstreamer/tags.txt (100%) rename {extra => unmaintained}/gstreamer/video/GstVideo-0.10.gir (100%) rename {extra => unmaintained}/gstreamer/video/ffi/ffi.factor (100%) rename {extra => unmaintained}/gstreamer/video/video.factor (100%) diff --git a/extra/clutter/Clutter-1.0.gir b/unmaintained/clutter/Clutter-1.0.gir similarity index 100% rename from extra/clutter/Clutter-1.0.gir rename to unmaintained/clutter/Clutter-1.0.gir diff --git a/extra/clutter/authors.txt b/unmaintained/clutter/authors.txt similarity index 100% rename from extra/clutter/authors.txt rename to unmaintained/clutter/authors.txt diff --git a/extra/clutter/clutter.factor b/unmaintained/clutter/clutter.factor similarity index 100% rename from extra/clutter/clutter.factor rename to unmaintained/clutter/clutter.factor diff --git a/extra/clutter/cogl/Cogl-1.0.gir b/unmaintained/clutter/cogl/Cogl-1.0.gir similarity index 100% rename from extra/clutter/cogl/Cogl-1.0.gir rename to unmaintained/clutter/cogl/Cogl-1.0.gir diff --git a/extra/clutter/cogl/cogl.factor b/unmaintained/clutter/cogl/cogl.factor similarity index 100% rename from extra/clutter/cogl/cogl.factor rename to unmaintained/clutter/cogl/cogl.factor diff --git a/extra/clutter/cogl/ffi/ffi.factor b/unmaintained/clutter/cogl/ffi/ffi.factor similarity index 100% rename from extra/clutter/cogl/ffi/ffi.factor rename to unmaintained/clutter/cogl/ffi/ffi.factor diff --git a/extra/clutter/ffi/ffi.factor b/unmaintained/clutter/ffi/ffi.factor similarity index 100% rename from extra/clutter/ffi/ffi.factor rename to unmaintained/clutter/ffi/ffi.factor diff --git a/extra/clutter/gtk/GtkClutter-0.10.gir b/unmaintained/clutter/gtk/GtkClutter-0.10.gir similarity index 100% rename from extra/clutter/gtk/GtkClutter-0.10.gir rename to unmaintained/clutter/gtk/GtkClutter-0.10.gir diff --git a/extra/clutter/gtk/ffi/ffi.factor b/unmaintained/clutter/gtk/ffi/ffi.factor similarity index 100% rename from extra/clutter/gtk/ffi/ffi.factor rename to unmaintained/clutter/gtk/ffi/ffi.factor diff --git a/extra/clutter/gtk/gtk.factor b/unmaintained/clutter/gtk/gtk.factor similarity index 100% rename from extra/clutter/gtk/gtk.factor rename to unmaintained/clutter/gtk/gtk.factor diff --git a/extra/clutter/json/Json-1.0.gir b/unmaintained/clutter/json/Json-1.0.gir similarity index 100% rename from extra/clutter/json/Json-1.0.gir rename to unmaintained/clutter/json/Json-1.0.gir diff --git a/extra/clutter/json/ffi/ffi.factor b/unmaintained/clutter/json/ffi/ffi.factor similarity index 100% rename from extra/clutter/json/ffi/ffi.factor rename to unmaintained/clutter/json/ffi/ffi.factor diff --git a/extra/clutter/json/json.factor b/unmaintained/clutter/json/json.factor similarity index 100% rename from extra/clutter/json/json.factor rename to unmaintained/clutter/json/json.factor diff --git a/extra/clutter/summary.txt b/unmaintained/clutter/summary.txt similarity index 100% rename from extra/clutter/summary.txt rename to unmaintained/clutter/summary.txt diff --git a/extra/clutter/tags.txt b/unmaintained/clutter/tags.txt similarity index 100% rename from extra/clutter/tags.txt rename to unmaintained/clutter/tags.txt diff --git a/extra/gir/samples/lowlevel/gstreamer/authors.txt b/unmaintained/gir/samples/lowlevel/gstreamer/authors.txt similarity index 100% rename from extra/gir/samples/lowlevel/gstreamer/authors.txt rename to unmaintained/gir/samples/lowlevel/gstreamer/authors.txt diff --git a/extra/gir/samples/lowlevel/gstreamer/gstreamer.factor b/unmaintained/gir/samples/lowlevel/gstreamer/gstreamer.factor similarity index 100% rename from extra/gir/samples/lowlevel/gstreamer/gstreamer.factor rename to unmaintained/gir/samples/lowlevel/gstreamer/gstreamer.factor diff --git a/extra/gstreamer/Gst-0.10.gir b/unmaintained/gstreamer/Gst-0.10.gir similarity index 100% rename from extra/gstreamer/Gst-0.10.gir rename to unmaintained/gstreamer/Gst-0.10.gir diff --git a/extra/gstreamer/app/GstApp-0.10.gir b/unmaintained/gstreamer/app/GstApp-0.10.gir similarity index 100% rename from extra/gstreamer/app/GstApp-0.10.gir rename to unmaintained/gstreamer/app/GstApp-0.10.gir diff --git a/extra/gstreamer/app/app.factor b/unmaintained/gstreamer/app/app.factor similarity index 100% rename from extra/gstreamer/app/app.factor rename to unmaintained/gstreamer/app/app.factor diff --git a/extra/gstreamer/app/ffi/ffi.factor b/unmaintained/gstreamer/app/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/app/ffi/ffi.factor rename to unmaintained/gstreamer/app/ffi/ffi.factor diff --git a/extra/gstreamer/audio/GstAudio-0.10.gir b/unmaintained/gstreamer/audio/GstAudio-0.10.gir similarity index 100% rename from extra/gstreamer/audio/GstAudio-0.10.gir rename to unmaintained/gstreamer/audio/GstAudio-0.10.gir diff --git a/extra/gstreamer/audio/audio.factor b/unmaintained/gstreamer/audio/audio.factor similarity index 100% rename from extra/gstreamer/audio/audio.factor rename to unmaintained/gstreamer/audio/audio.factor diff --git a/extra/gstreamer/audio/ffi/ffi.factor b/unmaintained/gstreamer/audio/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/audio/ffi/ffi.factor rename to unmaintained/gstreamer/audio/ffi/ffi.factor diff --git a/extra/gstreamer/authors.txt b/unmaintained/gstreamer/authors.txt similarity index 100% rename from extra/gstreamer/authors.txt rename to unmaintained/gstreamer/authors.txt diff --git a/extra/gstreamer/base/GstBase-0.10.gir b/unmaintained/gstreamer/base/GstBase-0.10.gir similarity index 100% rename from extra/gstreamer/base/GstBase-0.10.gir rename to unmaintained/gstreamer/base/GstBase-0.10.gir diff --git a/extra/gstreamer/base/base.factor b/unmaintained/gstreamer/base/base.factor similarity index 100% rename from extra/gstreamer/base/base.factor rename to unmaintained/gstreamer/base/base.factor diff --git a/extra/gstreamer/base/ffi/ffi.factor b/unmaintained/gstreamer/base/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/base/ffi/ffi.factor rename to unmaintained/gstreamer/base/ffi/ffi.factor diff --git a/extra/gstreamer/controller/GstController-0.10.gir b/unmaintained/gstreamer/controller/GstController-0.10.gir similarity index 100% rename from extra/gstreamer/controller/GstController-0.10.gir rename to unmaintained/gstreamer/controller/GstController-0.10.gir diff --git a/extra/gstreamer/controller/controller.factor b/unmaintained/gstreamer/controller/controller.factor similarity index 100% rename from extra/gstreamer/controller/controller.factor rename to unmaintained/gstreamer/controller/controller.factor diff --git a/extra/gstreamer/controller/ffi/ffi.factor b/unmaintained/gstreamer/controller/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/controller/ffi/ffi.factor rename to unmaintained/gstreamer/controller/ffi/ffi.factor diff --git a/extra/gstreamer/ffi/ffi.factor b/unmaintained/gstreamer/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/ffi/ffi.factor rename to unmaintained/gstreamer/ffi/ffi.factor diff --git a/extra/gstreamer/fft/GstFft-0.10.gir b/unmaintained/gstreamer/fft/GstFft-0.10.gir similarity index 100% rename from extra/gstreamer/fft/GstFft-0.10.gir rename to unmaintained/gstreamer/fft/GstFft-0.10.gir diff --git a/extra/gstreamer/fft/ffi/ffi.factor b/unmaintained/gstreamer/fft/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/fft/ffi/ffi.factor rename to unmaintained/gstreamer/fft/ffi/ffi.factor diff --git a/extra/gstreamer/fft/fft.factor b/unmaintained/gstreamer/fft/fft.factor similarity index 100% rename from extra/gstreamer/fft/fft.factor rename to unmaintained/gstreamer/fft/fft.factor diff --git a/extra/gstreamer/gstreamer.factor b/unmaintained/gstreamer/gstreamer.factor similarity index 100% rename from extra/gstreamer/gstreamer.factor rename to unmaintained/gstreamer/gstreamer.factor diff --git a/extra/gstreamer/interfaces/GstInterfaces-0.10.gir b/unmaintained/gstreamer/interfaces/GstInterfaces-0.10.gir similarity index 100% rename from extra/gstreamer/interfaces/GstInterfaces-0.10.gir rename to unmaintained/gstreamer/interfaces/GstInterfaces-0.10.gir diff --git a/extra/gstreamer/interfaces/ffi/ffi.factor b/unmaintained/gstreamer/interfaces/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/interfaces/ffi/ffi.factor rename to unmaintained/gstreamer/interfaces/ffi/ffi.factor diff --git a/extra/gstreamer/interfaces/interfaces.factor b/unmaintained/gstreamer/interfaces/interfaces.factor similarity index 100% rename from extra/gstreamer/interfaces/interfaces.factor rename to unmaintained/gstreamer/interfaces/interfaces.factor diff --git a/extra/gstreamer/net/GstNet-0.10.gir b/unmaintained/gstreamer/net/GstNet-0.10.gir similarity index 100% rename from extra/gstreamer/net/GstNet-0.10.gir rename to unmaintained/gstreamer/net/GstNet-0.10.gir diff --git a/extra/gstreamer/net/ffi/ffi.factor b/unmaintained/gstreamer/net/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/net/ffi/ffi.factor rename to unmaintained/gstreamer/net/ffi/ffi.factor diff --git a/extra/gstreamer/net/net.factor b/unmaintained/gstreamer/net/net.factor similarity index 100% rename from extra/gstreamer/net/net.factor rename to unmaintained/gstreamer/net/net.factor diff --git a/extra/gstreamer/netbuffer/GstNetbuffer-0.10.gir b/unmaintained/gstreamer/netbuffer/GstNetbuffer-0.10.gir similarity index 100% rename from extra/gstreamer/netbuffer/GstNetbuffer-0.10.gir rename to unmaintained/gstreamer/netbuffer/GstNetbuffer-0.10.gir diff --git a/extra/gstreamer/netbuffer/ffi/ffi.factor b/unmaintained/gstreamer/netbuffer/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/netbuffer/ffi/ffi.factor rename to unmaintained/gstreamer/netbuffer/ffi/ffi.factor diff --git a/extra/gstreamer/netbuffer/netbuffer.factor b/unmaintained/gstreamer/netbuffer/netbuffer.factor similarity index 100% rename from extra/gstreamer/netbuffer/netbuffer.factor rename to unmaintained/gstreamer/netbuffer/netbuffer.factor diff --git a/extra/gstreamer/pbutils/GstPbutils-0.10.gir b/unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir similarity index 100% rename from extra/gstreamer/pbutils/GstPbutils-0.10.gir rename to unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir diff --git a/extra/gstreamer/pbutils/ffi/ffi.factor b/unmaintained/gstreamer/pbutils/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/pbutils/ffi/ffi.factor rename to unmaintained/gstreamer/pbutils/ffi/ffi.factor diff --git a/extra/gstreamer/pbutils/pbutils.factor b/unmaintained/gstreamer/pbutils/pbutils.factor similarity index 100% rename from extra/gstreamer/pbutils/pbutils.factor rename to unmaintained/gstreamer/pbutils/pbutils.factor diff --git a/extra/gstreamer/riff/GstRiff-0.10.gir b/unmaintained/gstreamer/riff/GstRiff-0.10.gir similarity index 100% rename from extra/gstreamer/riff/GstRiff-0.10.gir rename to unmaintained/gstreamer/riff/GstRiff-0.10.gir diff --git a/extra/gstreamer/riff/ffi/ffi.factor b/unmaintained/gstreamer/riff/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/riff/ffi/ffi.factor rename to unmaintained/gstreamer/riff/ffi/ffi.factor diff --git a/extra/gstreamer/riff/riff.factor b/unmaintained/gstreamer/riff/riff.factor similarity index 100% rename from extra/gstreamer/riff/riff.factor rename to unmaintained/gstreamer/riff/riff.factor diff --git a/extra/gstreamer/rtp/GstRtp-0.10.gir b/unmaintained/gstreamer/rtp/GstRtp-0.10.gir similarity index 100% rename from extra/gstreamer/rtp/GstRtp-0.10.gir rename to unmaintained/gstreamer/rtp/GstRtp-0.10.gir diff --git a/extra/gstreamer/rtp/ffi/ffi.factor b/unmaintained/gstreamer/rtp/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/rtp/ffi/ffi.factor rename to unmaintained/gstreamer/rtp/ffi/ffi.factor diff --git a/extra/gstreamer/rtp/rtp.factor b/unmaintained/gstreamer/rtp/rtp.factor similarity index 100% rename from extra/gstreamer/rtp/rtp.factor rename to unmaintained/gstreamer/rtp/rtp.factor diff --git a/extra/gstreamer/rtsp/GstRtsp-0.10.gir b/unmaintained/gstreamer/rtsp/GstRtsp-0.10.gir similarity index 100% rename from extra/gstreamer/rtsp/GstRtsp-0.10.gir rename to unmaintained/gstreamer/rtsp/GstRtsp-0.10.gir diff --git a/extra/gstreamer/rtsp/ffi/ffi.factor b/unmaintained/gstreamer/rtsp/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/rtsp/ffi/ffi.factor rename to unmaintained/gstreamer/rtsp/ffi/ffi.factor diff --git a/extra/gstreamer/rtsp/rtsp.factor b/unmaintained/gstreamer/rtsp/rtsp.factor similarity index 100% rename from extra/gstreamer/rtsp/rtsp.factor rename to unmaintained/gstreamer/rtsp/rtsp.factor diff --git a/extra/gstreamer/sdp/GstSdp-0.10.gir b/unmaintained/gstreamer/sdp/GstSdp-0.10.gir similarity index 100% rename from extra/gstreamer/sdp/GstSdp-0.10.gir rename to unmaintained/gstreamer/sdp/GstSdp-0.10.gir diff --git a/extra/gstreamer/sdp/ffi/ffi.factor b/unmaintained/gstreamer/sdp/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/sdp/ffi/ffi.factor rename to unmaintained/gstreamer/sdp/ffi/ffi.factor diff --git a/extra/gstreamer/sdp/sdp.factor b/unmaintained/gstreamer/sdp/sdp.factor similarity index 100% rename from extra/gstreamer/sdp/sdp.factor rename to unmaintained/gstreamer/sdp/sdp.factor diff --git a/extra/gstreamer/summary.txt b/unmaintained/gstreamer/summary.txt similarity index 100% rename from extra/gstreamer/summary.txt rename to unmaintained/gstreamer/summary.txt diff --git a/extra/gstreamer/tag/GstTag-0.10.gir b/unmaintained/gstreamer/tag/GstTag-0.10.gir similarity index 100% rename from extra/gstreamer/tag/GstTag-0.10.gir rename to unmaintained/gstreamer/tag/GstTag-0.10.gir diff --git a/extra/gstreamer/tag/ffi/ffi.factor b/unmaintained/gstreamer/tag/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/tag/ffi/ffi.factor rename to unmaintained/gstreamer/tag/ffi/ffi.factor diff --git a/extra/gstreamer/tag/tag.factor b/unmaintained/gstreamer/tag/tag.factor similarity index 100% rename from extra/gstreamer/tag/tag.factor rename to unmaintained/gstreamer/tag/tag.factor diff --git a/extra/gstreamer/tags.txt b/unmaintained/gstreamer/tags.txt similarity index 100% rename from extra/gstreamer/tags.txt rename to unmaintained/gstreamer/tags.txt diff --git a/extra/gstreamer/video/GstVideo-0.10.gir b/unmaintained/gstreamer/video/GstVideo-0.10.gir similarity index 100% rename from extra/gstreamer/video/GstVideo-0.10.gir rename to unmaintained/gstreamer/video/GstVideo-0.10.gir diff --git a/extra/gstreamer/video/ffi/ffi.factor b/unmaintained/gstreamer/video/ffi/ffi.factor similarity index 100% rename from extra/gstreamer/video/ffi/ffi.factor rename to unmaintained/gstreamer/video/ffi/ffi.factor diff --git a/extra/gstreamer/video/video.factor b/unmaintained/gstreamer/video/video.factor similarity index 100% rename from extra/gstreamer/video/video.factor rename to unmaintained/gstreamer/video/video.factor From bb71050a230be4afa8c5133123125dedd82056d6 Mon Sep 17 00:00:00 2001 From: Slava Pestov Date: Fri, 4 Mar 2011 18:12:36 -0500 Subject: [PATCH 73/76] tools.deploy: increase size limits for recently-added deploy tests that never passed --- basis/tools/deploy/deploy-tests.factor | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/basis/tools/deploy/deploy-tests.factor b/basis/tools/deploy/deploy-tests.factor index aa2bca26f1..d7b0f0b918 100644 --- a/basis/tools/deploy/deploy-tests.factor +++ b/basis/tools/deploy/deploy-tests.factor @@ -140,13 +140,13 @@ os macosx? [ [ "Factor" ] [ deploy-test-command ascii [ readln ] with-process-reader ] unit-test -[ ] [ 800000 small-enough? ] unit-test +[ ] [ 850000 small-enough? ] unit-test [ ] [ "tools.deploy.test.21" shake-and-bake ] unit-test [ "1 2 3" ] [ deploy-test-command ascii [ readln ] with-process-reader ] unit-test -[ ] [ 600000 small-enough? ] unit-test +[ ] [ 800000 small-enough? ] unit-test [ ] [ "benchmark.ui-panes" shake-and-bake run-temp-image ] unit-test From 952aad80ce2a386468ee8f42c3ef71f62b3fc61a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 5 Mar 2011 14:11:26 +0600 Subject: [PATCH 74/76] gobject-introspection: add FOREIGN-ATOMIC-TYPE: (used in clutter.cogl.ffi); move clutter from unmaintainded to extra; --- basis/gobject-introspection/gobject-introspection.factor | 3 +++ {unmaintained => extra}/clutter/Clutter-1.0.gir | 0 {unmaintained => extra}/clutter/authors.txt | 0 {unmaintained => extra}/clutter/clutter.factor | 0 {unmaintained => extra}/clutter/cogl/Cogl-1.0.gir | 0 {unmaintained => extra}/clutter/cogl/cogl.factor | 0 {unmaintained => extra}/clutter/cogl/ffi/ffi.factor | 0 {unmaintained => extra}/clutter/ffi/ffi.factor | 0 {unmaintained => extra}/clutter/gtk/GtkClutter-0.10.gir | 0 {unmaintained => extra}/clutter/gtk/ffi/ffi.factor | 0 {unmaintained => extra}/clutter/gtk/gtk.factor | 0 {unmaintained => extra}/clutter/json/Json-1.0.gir | 0 {unmaintained => extra}/clutter/json/ffi/ffi.factor | 0 {unmaintained => extra}/clutter/json/json.factor | 0 {unmaintained => extra}/clutter/summary.txt | 0 {unmaintained => extra}/clutter/tags.txt | 0 16 files changed, 3 insertions(+) rename {unmaintained => extra}/clutter/Clutter-1.0.gir (100%) rename {unmaintained => extra}/clutter/authors.txt (100%) rename {unmaintained => extra}/clutter/clutter.factor (100%) rename {unmaintained => extra}/clutter/cogl/Cogl-1.0.gir (100%) rename {unmaintained => extra}/clutter/cogl/cogl.factor (100%) rename {unmaintained => extra}/clutter/cogl/ffi/ffi.factor (100%) rename {unmaintained => extra}/clutter/ffi/ffi.factor (100%) rename {unmaintained => extra}/clutter/gtk/GtkClutter-0.10.gir (100%) rename {unmaintained => extra}/clutter/gtk/ffi/ffi.factor (100%) rename {unmaintained => extra}/clutter/gtk/gtk.factor (100%) rename {unmaintained => extra}/clutter/json/Json-1.0.gir (100%) rename {unmaintained => extra}/clutter/json/ffi/ffi.factor (100%) rename {unmaintained => extra}/clutter/json/json.factor (100%) rename {unmaintained => extra}/clutter/summary.txt (100%) rename {unmaintained => extra}/clutter/tags.txt (100%) diff --git a/basis/gobject-introspection/gobject-introspection.factor b/basis/gobject-introspection/gobject-introspection.factor index 5104f757ce..00ef41eefb 100755 --- a/basis/gobject-introspection/gobject-introspection.factor +++ b/basis/gobject-introspection/gobject-introspection.factor @@ -24,6 +24,9 @@ SYNTAX: IMPLEMENT-STRUCTS: ";" parse-tokens implement-structs [ swap append! ] change-global ; +SYNTAX: FOREIGN-ATOMIC-TYPE: + scan-token scan-object swap register-atomic-type ; + SYNTAX: FOREIGN-ENUM-TYPE: scan-token scan-object swap register-enum-type ; diff --git a/unmaintained/clutter/Clutter-1.0.gir b/extra/clutter/Clutter-1.0.gir similarity index 100% rename from unmaintained/clutter/Clutter-1.0.gir rename to extra/clutter/Clutter-1.0.gir diff --git a/unmaintained/clutter/authors.txt b/extra/clutter/authors.txt similarity index 100% rename from unmaintained/clutter/authors.txt rename to extra/clutter/authors.txt diff --git a/unmaintained/clutter/clutter.factor b/extra/clutter/clutter.factor similarity index 100% rename from unmaintained/clutter/clutter.factor rename to extra/clutter/clutter.factor diff --git a/unmaintained/clutter/cogl/Cogl-1.0.gir b/extra/clutter/cogl/Cogl-1.0.gir similarity index 100% rename from unmaintained/clutter/cogl/Cogl-1.0.gir rename to extra/clutter/cogl/Cogl-1.0.gir diff --git a/unmaintained/clutter/cogl/cogl.factor b/extra/clutter/cogl/cogl.factor similarity index 100% rename from unmaintained/clutter/cogl/cogl.factor rename to extra/clutter/cogl/cogl.factor diff --git a/unmaintained/clutter/cogl/ffi/ffi.factor b/extra/clutter/cogl/ffi/ffi.factor similarity index 100% rename from unmaintained/clutter/cogl/ffi/ffi.factor rename to extra/clutter/cogl/ffi/ffi.factor diff --git a/unmaintained/clutter/ffi/ffi.factor b/extra/clutter/ffi/ffi.factor similarity index 100% rename from unmaintained/clutter/ffi/ffi.factor rename to extra/clutter/ffi/ffi.factor diff --git a/unmaintained/clutter/gtk/GtkClutter-0.10.gir b/extra/clutter/gtk/GtkClutter-0.10.gir similarity index 100% rename from unmaintained/clutter/gtk/GtkClutter-0.10.gir rename to extra/clutter/gtk/GtkClutter-0.10.gir diff --git a/unmaintained/clutter/gtk/ffi/ffi.factor b/extra/clutter/gtk/ffi/ffi.factor similarity index 100% rename from unmaintained/clutter/gtk/ffi/ffi.factor rename to extra/clutter/gtk/ffi/ffi.factor diff --git a/unmaintained/clutter/gtk/gtk.factor b/extra/clutter/gtk/gtk.factor similarity index 100% rename from unmaintained/clutter/gtk/gtk.factor rename to extra/clutter/gtk/gtk.factor diff --git a/unmaintained/clutter/json/Json-1.0.gir b/extra/clutter/json/Json-1.0.gir similarity index 100% rename from unmaintained/clutter/json/Json-1.0.gir rename to extra/clutter/json/Json-1.0.gir diff --git a/unmaintained/clutter/json/ffi/ffi.factor b/extra/clutter/json/ffi/ffi.factor similarity index 100% rename from unmaintained/clutter/json/ffi/ffi.factor rename to extra/clutter/json/ffi/ffi.factor diff --git a/unmaintained/clutter/json/json.factor b/extra/clutter/json/json.factor similarity index 100% rename from unmaintained/clutter/json/json.factor rename to extra/clutter/json/json.factor diff --git a/unmaintained/clutter/summary.txt b/extra/clutter/summary.txt similarity index 100% rename from unmaintained/clutter/summary.txt rename to extra/clutter/summary.txt diff --git a/unmaintained/clutter/tags.txt b/extra/clutter/tags.txt similarity index 100% rename from unmaintained/clutter/tags.txt rename to extra/clutter/tags.txt From 70718fc73c7d338d12f9c09c2b9ed9be16af043a Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sat, 5 Mar 2011 17:34:01 +0600 Subject: [PATCH 75/76] fix gstreamer.*; move gstreamer from unmaintained to extra; --- .../gstreamer/Gst-0.10.gir | 27106 +++++++++------- {unmaintained => extra}/gstreamer/authors.txt | 0 .../gstreamer/base/GstBase-0.10.gir | 6814 ++-- .../gstreamer/base/base.factor | 0 .../gstreamer/base/ffi/ffi.factor | 10 +- .../controller/GstController-0.10.gir | 923 +- .../gstreamer/controller/controller.factor | 0 .../gstreamer/controller/ffi/ffi.factor | 11 +- .../riff => extra/gstreamer}/ffi/ffi.factor | 25 +- .../gstreamer/gstreamer.factor | 0 extra/gstreamer/net/GstNet-0.10.gir | 299 + .../gstreamer/net/ffi/ffi.factor | 13 +- .../gstreamer/net/net.factor | 0 {unmaintained => extra}/gstreamer/summary.txt | 0 {unmaintained => extra}/gstreamer/tags.txt | 0 unmaintained/gstreamer/fft/GstFft-0.10.gir | 462 - unmaintained/gstreamer/net/GstNet-0.10.gir | 279 - .../gstreamer/pbutils/GstPbutils-0.10.gir | 665 - .../{ => plugins}/app/GstApp-0.10.gir | 1090 +- .../gstreamer/{ => plugins}/app/app.factor | 0 .../{ => plugins}/app/ffi/ffi.factor | 0 .../{ => plugins}/audio/GstAudio-0.10.gir | 1928 +- .../{ => plugins}/audio/audio.factor | 0 .../{ => plugins}/audio/ffi/ffi.factor | 0 .../gstreamer/plugins/fft/GstFft-0.10.gir | 480 + .../{ => plugins}/fft/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/fft/fft.factor | 0 .../interfaces/GstInterfaces-0.10.gir | 3124 +- .../{ => plugins}/interfaces/ffi/ffi.factor | 0 .../interfaces/interfaces.factor | 0 .../netbuffer/GstNetbuffer-0.10.gir | 205 +- .../{ => plugins}/netbuffer/ffi/ffi.factor | 0 .../{ => plugins}/netbuffer/netbuffer.factor | 0 .../plugins/pbutils/GstPbutils-0.10.gir | 2336 ++ .../{ => plugins}/pbutils/ffi/ffi.factor | 0 .../{ => plugins}/pbutils/pbutils.factor | 0 .../gstreamer/plugins/riff/GstRiff-0.10.gir | 834 + .../{ => plugins/riff}/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/riff/riff.factor | 0 .../gstreamer/plugins/rtp/GstRtp-0.10.gir | 3195 ++ .../{ => plugins}/rtp/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/rtp/rtp.factor | 0 .../{ => plugins}/rtsp/GstRtsp-0.10.gir | 2351 +- .../{ => plugins}/rtsp/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/rtsp/rtsp.factor | 0 .../gstreamer/plugins/sdp/GstSdp-0.10.gir | 1220 + .../{ => plugins}/sdp/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/sdp/sdp.factor | 0 .../gstreamer/plugins/tag/GstTag-0.10.gir | 963 + .../{ => plugins}/tag/ffi/ffi.factor | 0 .../gstreamer/{ => plugins}/tag/tag.factor | 0 .../gstreamer/plugins/video/GstVideo-0.10.gir | 1188 + .../{ => plugins}/video/ffi/ffi.factor | 0 .../{ => plugins}/video/video.factor | 0 unmaintained/gstreamer/riff/GstRiff-0.10.gir | 983 - unmaintained/gstreamer/rtp/GstRtp-0.10.gir | 2550 -- unmaintained/gstreamer/sdp/GstSdp-0.10.gir | 1056 - unmaintained/gstreamer/tag/GstTag-0.10.gir | 797 - .../gstreamer/video/GstVideo-0.10.gir | 925 - 59 files changed, 35238 insertions(+), 26594 deletions(-) rename {unmaintained => extra}/gstreamer/Gst-0.10.gir (51%) rename {unmaintained => extra}/gstreamer/authors.txt (100%) rename {unmaintained => extra}/gstreamer/base/GstBase-0.10.gir (55%) rename {unmaintained => extra}/gstreamer/base/base.factor (100%) rename {unmaintained => extra}/gstreamer/base/ffi/ffi.factor (66%) rename {unmaintained => extra}/gstreamer/controller/GstController-0.10.gir (55%) rename {unmaintained => extra}/gstreamer/controller/controller.factor (100%) rename {unmaintained => extra}/gstreamer/controller/ffi/ffi.factor (67%) rename {unmaintained/gstreamer/riff => extra/gstreamer}/ffi/ffi.factor (52%) rename {unmaintained => extra}/gstreamer/gstreamer.factor (100%) create mode 100644 extra/gstreamer/net/GstNet-0.10.gir rename {unmaintained => extra}/gstreamer/net/ffi/ffi.factor (66%) rename {unmaintained => extra}/gstreamer/net/net.factor (100%) rename {unmaintained => extra}/gstreamer/summary.txt (100%) rename {unmaintained => extra}/gstreamer/tags.txt (100%) delete mode 100644 unmaintained/gstreamer/fft/GstFft-0.10.gir delete mode 100644 unmaintained/gstreamer/net/GstNet-0.10.gir delete mode 100644 unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir rename unmaintained/gstreamer/{ => plugins}/app/GstApp-0.10.gir (53%) rename unmaintained/gstreamer/{ => plugins}/app/app.factor (100%) rename unmaintained/gstreamer/{ => plugins}/app/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/audio/GstAudio-0.10.gir (59%) rename unmaintained/gstreamer/{ => plugins}/audio/audio.factor (100%) rename unmaintained/gstreamer/{ => plugins}/audio/ffi/ffi.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/fft/GstFft-0.10.gir rename unmaintained/gstreamer/{ => plugins}/fft/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/fft/fft.factor (100%) rename unmaintained/gstreamer/{ => plugins}/interfaces/GstInterfaces-0.10.gir (57%) rename unmaintained/gstreamer/{ => plugins}/interfaces/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/interfaces/interfaces.factor (100%) rename unmaintained/gstreamer/{ => plugins}/netbuffer/GstNetbuffer-0.10.gir (51%) rename unmaintained/gstreamer/{ => plugins}/netbuffer/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/netbuffer/netbuffer.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/pbutils/GstPbutils-0.10.gir rename unmaintained/gstreamer/{ => plugins}/pbutils/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/pbutils/pbutils.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/riff/GstRiff-0.10.gir rename unmaintained/gstreamer/{ => plugins/riff}/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/riff/riff.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/rtp/GstRtp-0.10.gir rename unmaintained/gstreamer/{ => plugins}/rtp/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/rtp/rtp.factor (100%) rename unmaintained/gstreamer/{ => plugins}/rtsp/GstRtsp-0.10.gir (62%) rename unmaintained/gstreamer/{ => plugins}/rtsp/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/rtsp/rtsp.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/sdp/GstSdp-0.10.gir rename unmaintained/gstreamer/{ => plugins}/sdp/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/sdp/sdp.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/tag/GstTag-0.10.gir rename unmaintained/gstreamer/{ => plugins}/tag/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/tag/tag.factor (100%) create mode 100644 unmaintained/gstreamer/plugins/video/GstVideo-0.10.gir rename unmaintained/gstreamer/{ => plugins}/video/ffi/ffi.factor (100%) rename unmaintained/gstreamer/{ => plugins}/video/video.factor (100%) delete mode 100644 unmaintained/gstreamer/riff/GstRiff-0.10.gir delete mode 100644 unmaintained/gstreamer/rtp/GstRtp-0.10.gir delete mode 100644 unmaintained/gstreamer/sdp/GstSdp-0.10.gir delete mode 100644 unmaintained/gstreamer/tag/GstTag-0.10.gir delete mode 100644 unmaintained/gstreamer/video/GstVideo-0.10.gir diff --git a/unmaintained/gstreamer/Gst-0.10.gir b/extra/gstreamer/Gst-0.10.gir similarity index 51% rename from unmaintained/gstreamer/Gst-0.10.gir rename to extra/gstreamer/Gst-0.10.gir index d187fe1341..9c73cc1d0d 100644 --- a/unmaintained/gstreamer/Gst-0.10.gir +++ b/extra/gstreamer/Gst-0.10.gir @@ -2,7 +2,7 @@ - @@ -10,76 +10,80 @@ and/or use gtk-doc annotations. --> - - - - - + - - - - + + A datatype to hold the handle to an outstanding sync or async clock callback. + + + + A datatype to hold a time, measured in nanoseconds. + + + + A datatype to hold a time difference, measured in nanoseconds. + + + + + + + The status of a GstPad. After activating a pad, which usually happens when the parent element goes from READY to PAUSED, the GstActivateMode defines if the -pad operates in push or pull mode." - c:type="GstActivateMode"> +pad operates in push or pull mode. - + + The main tracing object - + - + - + + + - + + Print the status of the given GstAllocTrace. - + + Enable the given features on the given GstAllocTrace object. + flags to set - + + Flags indicating which tracing feature to enable. - + + Flags for an association entry. - + - + - + + The GstBin base class. Subclasses can access these fields provided +the LOCK is taken. - + + Creates a new bin with the given name. - + a new #GstBin + + the name of the new bin - - - - - - - - - - - + @@ -151,208 +147,281 @@ the LOCK is taken." - + + + + + + + + + + + Adds the given element to the bin. Sets the element's parent, and thus takes ownership of the element. An element can only be added to one bin. -If the element's pads are linked to other pads, the pads will be unlinked +If the element's pads are linked to other pads, the pads will be unlinked before the element is added to the bin. MT safe. -the bin does not want to accept the element."> +the bin does not want to accept the element. - + TRUE if the element could be added, FALSE if + - + + the #GstElement to add - + + Adds a NULL-terminated list of elements to a bin. This function is +equivalent to calling gst_bin_add() for each member of the list. The return +value of each gst_bin_add() is ignored. - + - + + the #GstElement element to add to the bin + + + + - + Recursively looks for elements with an unlinked pad of the given +direction within the specified bin and returns an unlinked pad +if one is found, or NULL otherwise. If a pad is found, the caller +owns a reference to it and should use gst_object_unref() on the +pad when it is not needed any longer. + + unlinked pad of the given direction, or NULL. + + + + + whether to look for an unlinked source or sink pad + + + + + + Recursively looks for elements with an unlinked pad of the given +direction within the specified bin and returns an unlinked pad +if one is found, or NULL otherwise. If a pad is found, the caller +owns a reference to it and should use gst_object_unref() on the +pad when it is not needed any longer. + + unlinked pad of the given direction, or NULL. + + + + + whether to look for an unlinked source or sink pad + + + + + + Looks for an element inside the bin that implements the given +interface. If such an element is found, it returns the element. +You can cast this element to the given interface afterwards. If you want +all elements that implement the interface, use +gst_bin_iterate_all_by_interface(). This function recurses into child bins. +MT safe. Caller owns returned reference. + + A #GstElement inside the bin implementing the interface + + + + + the #GType of an interface + + + + + + Gets the element with the given name from a bin. This function recurses into child bins. Returns NULL if no element with the given name is found in the bin. -MT safe. Caller owns returned reference."> +MT safe. Caller owns returned reference. + the #GstElement with the given name, or NULL + the element name to search for + Gets the element with the given name from this bin. If the element is not found, a recursion is performed on the parent bin. Returns NULL if: - no element with the given name is found in the bin -MT safe. Caller owns returned reference."> +MT safe. Caller owns returned reference. + the #GstElement with the given name, or NULL + the element name to search for - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Looks for all elements inside the bin that implements the given interface. You can safely cast all returned elements to the given interface. The function recurses inside child bins. The iterator will yield a series of #GstElement that should be unreffed after use. Each element yielded by the iterator will have its refcount increased, so unref after use. MT safe. Caller owns returned value. -implementing the given interface, or NULL"> +in the bin implementing the given interface, or NULL + a #GstIterator of #GstElement for all elements + the #GType of an interface + + Gets an iterator for the elements in this bin. +Each element yielded by the iterator will have its refcount increased, so +unref after use. +MT safe. Caller owns returned value. + + a #GstIterator of #GstElement, or NULL + + + + + Gets an iterator for the elements in this bin. +This iterator recurses into GstBin children. +Each element yielded by the iterator will have its refcount increased, so +unref after use. +MT safe. Caller owns returned value. + + a #GstIterator of #GstElement, or NULL + + + + + Gets an iterator for all elements in the bin that have the +#GST_ELEMENT_IS_SINK flag set. +Each element yielded by the iterator will have its refcount increased, so +unref after use. +MT safe. Caller owns returned value. + + a #GstIterator of #GstElement, or NULL + + + + + Gets an iterator for the elements in this bin in topologically +sorted order. This means that the elements are returned from +the most downstream elements (sinks) to the sources. +This function is used internally to perform the state changes +of the bin elements and for clock selection. +Each element yielded by the iterator will have its refcount increased, so +unref after use. +MT safe. Caller owns returned value. + + a #GstIterator of #GstElement, or NULL + + + + + Gets an iterator for all elements in the bin that have the +#GST_ELEMENT_IS_SOURCE flag set. +Each element yielded by the iterator will have its refcount increased, so +unref after use. +MT safe. Caller owns returned value. + + a #GstIterator of #GstElement, or NULL + + + + Query @bin for the current latency using and reconfigures this latency to all the elements with a LATENCY event. This method is typically called on the pipeline when a #GST_MESSAGE_LATENCY is posted on the bus. -This function simply emits the 'do-latency' signal so any custom latency -calculations will be performed." - version="0.10.22."> +This function simply emits the 'do-latency' signal so any custom latency +calculations will be performed. - + %TRUE if the latency could be queried and reconfigured. + - + + Removes the element from the bin, unparenting it as well. +Unparenting the element means that the element will be dereferenced, +so if the bin holds the only reference to the element, the element +will be freed in the process of removing it from the bin. If you +want the element to still exist after removing, you need to call +gst_object_ref() before removing it from the bin. +If the element's pads are linked to other pads, the pads will be unlinked +before the element is removed from the bin. +MT safe. +the bin does not want to remove the element. - + TRUE if the element could be removed, FALSE if + - + + the #GstElement to remove - - - - + introspectable="0"> + Remove a list of elements from a bin. This function is equivalent +to calling gst_bin_remove() with each member of the list. + the first #GstElement to remove from the bin @@ -361,70 +430,42 @@ to calling gst_bin_remove() with each member of the list."> - - - - - - - - - - - - - - - - - - - - - - + + + + + - + - + + + - + - + + + - + - + - + @@ -437,11 +478,11 @@ pad when it is not needed any longer." - + - + Will be emitted when the bin needs to perform latency calculations. This signal is only emited for toplevel bins or when async-handling is enabled. Only one signal handler is invoked. If no signals are connected, the @@ -449,43 +490,44 @@ default handler is invoked, which will query and distribute the lowest possible latency to all sinks. Connect to this signal if the default latency calculations are not sufficient, like when you need different latencies for different sinks in -the same pipeline." - version="0.10.22"> - - +the same pipeline. + + - - - + + Will be emitted after the element was added to the bin. + + - - + + the #GstElement that was added to the bin + - - - + + Will be emitted after the element was removed from the bin. + + - - + + the #GstElement that was removed from the bin + + Subclasses can override the @add_element and @remove_element to update the list of children in the bin. The @handle_message method can be overridden to implement custom message handling. @handle_message takes ownership of the message, just like -#gst_element_post_message."> +#gst_element_post_message. @@ -493,7 +535,7 @@ message handling. @handle_message takes ownership of the message, just like - + @@ -508,7 +550,7 @@ message handling. @handle_message takes ownership of the message, just like - + @@ -523,9 +565,9 @@ message handling. @handle_message takes ownership of the message, just like - + - + @@ -538,9 +580,9 @@ message handling. @handle_message takes ownership of the message, just like - + - + @@ -553,7 +595,7 @@ message handling. @handle_message takes ownership of the message, just like - + @@ -568,9 +610,9 @@ message handling. @handle_message takes ownership of the message, just like - + - + @@ -581,209 +623,233 @@ message handling. @handle_message takes ownership of the message, just like - + - + GstBinFlags are a set of flags specific to bins. Most are set/used internally. They can be checked using the GST_OBJECT_FLAG_IS_SET () macro, -and (un)set using GST_OBJECT_FLAG_SET () and GST_OBJECT_FLAG_UNSET ()." - c:type="GstBinFlags"> +and (un)set using GST_OBJECT_FLAG_SET () and GST_OBJECT_FLAG_UNSET (). - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + The structure of a #GstBuffer. Use the associated macros to access the public +variables. + + Creates a newly allocated buffer without any data. +MT safe. + the new #GstBuffer. + Creates a newly allocated buffer with data of the given size. The buffer memory is not cleared. If the requested amount of -memory can't be allocated, the program will abort. Use +memory can't be allocated, the program will abort. Use gst_buffer_try_new_and_alloc() if you want to handle this case gracefully or have gotten the size to allocate from an untrusted source such as a media stream. Note that when @size == 0, the buffer data pointer will be NULL. -MT safe."> +MT safe. + the new #GstBuffer. - + the size of the new buffer's data. + + + + + + Tries to create a newly allocated buffer with data of the given size. If +the requested amount of memory can't be allocated, NULL will be returned. +The buffer memory is not cleared. +Note that when @size == 0, the buffer data pointer will be NULL. +MT safe. +be allocated. + + a new #GstBuffer, or NULL if the memory couldn't + + + + + the size of the new buffer's data. + + Copies the metadata from @src into @dest. The data, size and mallocdata fields are not copied. all the metadata fields. This function is typically called from a custom buffer copy function after -creating @dest and setting the data, size, mallocdata." - version="0.10.13"> +creating @dest and setting the data, size, mallocdata. + a source #GstBuffer + flags indicating what metadata fields should be copied. - - - - - - - - - - - - - - - - - - - - - - - - - - + Creates a sub-buffer from @parent at @offset and @size. This sub-buffer uses the actual memory space of the parent buffer. This function will copy the offset and timestamp fields when the -offset is 0. If not, they will be set to #GST_CLOCK_TIME_NONE and +offset is 0. If not, they will be set to #GST_CLOCK_TIME_NONE and #GST_BUFFER_OFFSET_NONE. If @offset equals 0 and @size equals the total size of @buffer, the duration and offset end fields are also copied. If not they will be set to #GST_CLOCK_TIME_NONE and #GST_BUFFER_OFFSET_NONE. MT safe. -Returns NULL if the arguments were invalid."> +invalid. + the new #GstBuffer or NULL if the arguments were - + the offset into parent #GstBuffer at which the new sub-buffer begins. + - + the size of the new #GstBuffer sub-buffer, in bytes. + - + Gets the media type of the buffer. This can be NULL if there +is no media type attached to this buffer. +Returns NULL if there were no caps on this buffer. + + a reference to the #GstCaps. unref after usage. + + + + + Similar to gst_buffer_is_writable, but this only ensures that the +refcount of the buffer is 1, indicating that the caller is the sole +owner and can change the buffer metadata, such as caps and timestamps. + + TRUE if the metadata is writable. + + + + + Determines whether a gst_buffer_span() can be done without copying +the contents, that is, whether the data areas are contiguous sub-buffers of the same buffer. MT safe. -FALSE if a copy would be required."> +FALSE if a copy would be required. - + TRUE if the buffers are contiguous, + + the second #GstBuffer. - + Create a new buffer that is the concatenation of the two source +buffers, and unrefs the original source buffers. +If the buffers point to contiguous areas of memory, the buffer +is created without copying the data. +This is a convenience function for C programmers. See also +gst_buffer_merge(), which does the same thing without +unreffing the input parameters. Language bindings without +explicit reference counting should not wrap this function. +the source buffers. + + the new #GstBuffer which is the concatenation of + + + + + the second source #GstBuffer. + + + + + + Similar to gst_buffer_make_writable, but does not ensure that the buffer +data array is writable. Instead, this just ensures that the returned buffer +is solely owned by the caller, by creating a subbuffer of the original +buffer if necessary. +After calling this function, @buf should not be referenced anymore. The +result of this function has guaranteed writable metadata. +may or may not be the same as @buf. + + a new #GstBuffer with writable metadata, which + + + + + Create a new buffer that is the concatenation of the two source +buffers. The original source buffers will not be modified or +unref'd. Make sure you unref the source buffers if they are not used +anymore afterwards. +If the buffers point to contiguous areas of memory, the buffer +is created without copying the data. +of the source buffers. + + the new #GstBuffer which is the concatenation + + + + + the second source #GstBuffer to merge. + + + + + + Sets the media type on the buffer. The refcount of the caps will +be increased and any previous caps on the buffer will be +unreffed. + + + + + + a #GstCaps. + + + + + + Creates a new buffer that consists of part of buf1 and buf2. Logically, buf1 and buf2 are concatenated into a single larger buffer, and a new buffer is created at the given offset inside this space, with a given length. @@ -792,102 +858,103 @@ and are contiguous, the new buffer will be a child of the shared parent, and thus no copying is necessary. you can use gst_buffer_is_span_fast() to determine if a memcpy will be needed. MT safe. -Returns NULL if the arguments are invalid."> +buffers, or NULL if the arguments are invalid. + the new #GstBuffer that spans the two source - + the offset in the first buffer from where the new buffer should start. + + the second source #GstBuffer to merge. - - - - - - - - - - - - - - - - - - - - - + the total length of the new buffer. + + Copies additional information (the timestamp, duration, and offset start and end) from one buffer to the other. This function does not copy any buffer flags or caps and is equivalent to gst_buffer_copy_metadata(@dest, @src, GST_BUFFER_COPY_TIMESTAMPS). -control." - deprecated="use gst_buffer_copy_metadata() instead, it provides more"> +control. + buffer to stamp from - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A set of flags that can be provided to the gst_buffer_copy_metadata() +function to specify which metadata fields should be copied. - + + A set of buffer flags used to describe properties of a #GstBuffer. @@ -913,33 +980,33 @@ A set of buffer flags used to describe properties of a #GstBuffer." c:identifier="GST_BUFFER_FLAG_MEDIA3"/> - + + Opaque list of grouped buffers. - + Creates a new, empty #GstBufferList. The caller is responsible for unreffing +the returned #GstBufferList. +after usage. + + the new #GstBufferList. gst_buffer_list_unref() - - - - - + Call @func with @data for each buffer in @list. +of @func define if this function returns or if the remaining buffers in a +group should be skipped. @@ -947,49 +1014,66 @@ group should be skipped." + closure="1"> + a #GstBufferListFunc to call - + user data passed to @func + - + Get the buffer at @idx in @group. Note that this function is not efficient for iterating over the entire list. Use an iterator or gst_buffer_list_foreach() instead. -buffer remains valid as long as @list is valid." - version="0.10.24"> - +is no buffer. The buffer remains valid as long as @list is valid. + + the buffer at @idx in @group or NULL when there - + the group + - + the index in @group + + version="0.10.24" + introspectable="0"> + Iterate the buffers in @list. The owner of the iterator must also be the +owner of a reference to @list while the returned iterator is in use. + a new #GstBufferListIterator of the buffers in - - + + Returns the number of groups in @list. + + the number of groups in the buffer list + + + + + + A function for accessing the last buffer returned by gst_buffer_list_iterator_next(). The function can leave @buffer in the list, replace @buffer in the list or remove @buffer from the list, depending on the return value. If the function returns NULL, @buffer will be removed from @@ -998,23 +1082,26 @@ The last buffer returned by gst_buffer_list_iterator_next() will be replaced with the buffer returned from the function. The function takes ownership of unreffed. If NULL is returned, the buffer will be removed from the list. The list must be writable. -from the list" - version="0.10.24"> +to remove @buffer from the list + the buffer to replace @buffer in the list, or NULL - + + the #GstBuffer - + user data + + A function that will be called from gst_buffer_list_foreach(). The @buffer field will point to a the reference of the buffer at @idx in @group. When this function returns #GST_BUFFER_LIST_CONTINUE, the next buffer will be returned. When #GST_BUFFER_LIST_SKIP_GROUP is returned, all remaining buffers @@ -1024,30 +1111,34 @@ gst_buffer_list_foreach() will return. When @buffer is set to NULL, the item will be removed from the bufferlist. When @buffer has been made writable, the new buffer reference can be assigned to @buffer. This function is responsible for unreffing the old buffer when -removing or modifying." - version="0.10.24"> - +removing or modifying. + + a #GstBufferListItem + pointer the buffer - + the group index of @buffer + - + the index in @group of @buffer + - + user data passed to gst_buffer_list_foreach() + + The result of the #GstBufferListFunc. @@ -1058,164 +1149,196 @@ removing or modifying." - - - - - - - - - - - - - - - - - - - - + Opaque iterator for a #GstBufferList. + Inserts @buffer into the #GstBufferList iterated with @it. The buffer is inserted into the current group, immediately before the buffer that would be returned by gst_buffer_list_iterator_next(). The buffer is inserted before the implicit cursor, a subsequent call to gst_buffer_list_iterator_next() will return the buffer after the inserted buffer, if any. -This function takes ownership of @buffer." - version="0.10.24"> +This function takes ownership of @buffer. - + + a #GstBuffer + Inserts a new, empty group into the #GstBufferList iterated with @it. The group is inserted immediately before the group that would be returned by gst_buffer_list_iterator_next_group(). A subsequent call to gst_buffer_list_iterator_next_group() will advance the iterator to the group -after the inserted group, if any." - version="0.10.24"> +after the inserted group, if any. - - - - - - - - - - - + + Inserts @list of buffers into the #GstBufferList iterated with @it. The list is +inserted into the current group, immediately before the buffer that would be +returned by gst_buffer_list_iterator_next(). The list is inserted before +the implicit cursor, a subsequent call to gst_buffer_list_iterator_next() +will return the buffer after the last buffer of the inserted list, if any. +This function takes ownership of @list and all its buffers. - - + + a #GList of buffers + + + + Calls the given function for the last buffer returned by gst_buffer_list_iterator_next(). gst_buffer_list_iterator_next() must have been called on @it before this function is called. gst_buffer_list_iterator_remove() and gst_buffer_list_iterator_steal() must not have been called since the last call to gst_buffer_list_iterator_next(). -See #GstBufferListDoFunction for more details." - version="0.10.24"> - +See #GstBufferListDoFunction for more details. + + the return value from @do_func - + + the function to be called - + the gpointer to optional user data. + + + Free the iterator. + + + + + Merge a buffer list group into a normal #GstBuffer by copying its metadata and memcpying its data into consecutive memory. All buffers in the current group after the implicit cursor will be merged into one new buffer. The metadata of the new buffer will be a copy of the metadata of the buffer that would be returned by gst_buffer_list_iterator_next(). If there is no buffer in the current group after the implicit cursor, NULL will be returned. This function will not move the implicit cursor or in any other way affect -the state of the iterator @it or the list." - version="0.10.24"> - +the state of the iterator @it or the list. +or NULL + + a new #GstBuffer, gst_buffer_unref() after usage, + + Returns the number of buffers left to iterate in the current group. I.e. the +number of calls that can be made to gst_buffer_list_iterator_next() before +it returns NULL. +This function will not move the implicit cursor or in any other way affect +the state of the iterator @it. + + the number of buffers left to iterate in the current group + + + + + Returns the next buffer in the list iterated with @it. If the iterator is at +the end of a group, NULL will be returned. This function may be called +repeatedly to iterate through the current group. +The caller will not get a new ref to the returned #GstBuffer and must not +unref it. +buffer list, or NULL + + the next buffer in the current group of the + + + + + Advance the iterator @it to the first buffer in the next group. If the +iterator is at the last group, FALSE will be returned. This function may be +called repeatedly to iterate through the groups in a buffer list. +the iterator was already at the last group + + TRUE if the iterator could be advanced to the next group, FALSE if + + + + + Removes the last buffer returned by gst_buffer_list_iterator_next() from +the #GstBufferList iterated with @it. gst_buffer_list_iterator_next() must +have been called on @it before this function is called. This function can +only be called once per call to gst_buffer_list_iterator_next(). +The removed buffer is unreffed. + + + + + + Returns the last buffer returned by gst_buffer_list_iterator_next() without +modifying the refcount of the buffer. +gst_buffer_list_iterator_next() + + the last buffer returned by + + + + + Replaces the last buffer returned by gst_buffer_list_iterator_next() with +this function is called. gst_buffer_list_iterator_remove() must not have been +called since the last call to gst_buffer_list_iterator_next(). +This function unrefs the replaced buffer if it has not been stolen with +gst_buffer_list_iterator_steal() and takes ownership of @buffer (i.e. the +refcount of @buffer is not increased). + + + + + + a #GstBuffer + + + + - + + The different types of buffering methods. - + The opaque #GstBus data structure. + + Creates a new #GstBus instance. + a new #GstBus instance - + + Adds a bus signal watch to the default main context with the default priority +(%G_PRIORITY_DEFAULT). +After calling this statement, the bus will emit the "message" signal for each +message posted on the bus. +This function may be called multiple times. To clean up, the caller is +responsible for calling gst_bus_remove_signal_watch() as many times as this +function is called. +MT safe. - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Adds a bus signal watch to the default main context with the given @priority +(e.g. %G_PRIORITY_DEFAULT). +After calling this statement, the bus will emit the "message" signal for each +message posted on the bus when the main loop is running. +This function may be called multiple times. To clean up, the caller is +responsible for calling gst_bus_remove_signal_watch() as many times as this +function is called. +There can only be a single bus watch per bus, you most remove all signal watch +before you can set another type of watch. +MT safe. - - + + The priority of the watch. + - + + Adds a bus watch to the default main context with the default priority +(%G_PRIORITY_DEFAULT). +This function is used to receive asynchronous messages in the main loop. +There can only be a single bus watch per bus, you must remove it before you +can set a new one. +The watch can be removed using g_source_remove() or by returning FALSE +from @func. +MT safe. - + The event source id. + - - + + A function to call when a message is received. + - - + + user data passed to @func. + - - - - - - + Adds a bus watch to the default main context with the given @priority (e.g. +%G_PRIORITY_DEFAULT). This function is used to receive asynchronous messages in the main loop. There can only be a single bus watch per bus, you must remove it before you can set a new one. @@ -1404,63 +1432,127 @@ When @func is called, the message belongs to the caller; if you want to keep a copy of it, call gst_message_ref() before leaving @func. The watch can be removed using g_source_remove() or by returning FALSE from @func. -MT safe."> +MT safe. - + The event source id. + - + The priority of the watch. + + closure="2" + destroy="3"> + A function to call when a message is received. - + user data passed to @func. + - + + the function to call when the source is removed. - + + A helper #GstBusFunc that can be used to convert all asynchronous messages +into signals. - + TRUE + - - + + the #GstMessage received + - - + + user data + - + Create watch for this bus. The GSource will be dispatched whenever +a message is on the bus. After the GSource is dispatched, the +message is popped off the bus and unreffed. + + a #GSource that can be added to a mainloop. + + + + + Instructs GStreamer to stop emitting the "sync-message" signal for this bus. +See gst_bus_enable_sync_message_emission() for more information. +In the event that multiple pieces of code have called +gst_bus_enable_sync_message_emission(), the sync-message emissions will only +be stopped after all calls to gst_bus_enable_sync_message_emission() were +"cancelled" by calling this function. In this way the semantics are exactly +the same as gst_object_ref() that which calls enable should also call +disable. +MT safe. + + + + + + Instructs GStreamer to emit the "sync-message" signal after running the bus's +sync handler. This function is here so that code can ensure that they can +synchronously receive messages without having to affect what the bin's sync +handler is. +This function may be called multiple times. To clean up, the caller is +responsible for calling gst_bus_disable_sync_message_emission() as many times +as this function is called. +While this function looks similar to gst_bus_add_signal_watch(), it is not +exactly the same -- this function enables <emphasis>synchronous</emphasis> emission of +signals when messages arrive; gst_bus_add_signal_watch() adds an idle callback +to pop messages off the bus <emphasis>asynchronously</emphasis>. The sync-message signal +comes from the thread of whatever object posted the message; the "message" +signal is marshalled to the main thread via the main loop. +MT safe. + + + + + + Check if there are pending messages on the bus that +should be handled. +otherwise. +MT safe. + + TRUE if there are messages on the bus to be handled, FALSE + + + + + Peek the message on the top of the bus' queue. The message will remain +on the bus' message queue. A reference is returned, and needs to be unreffed +by the caller. +bus is empty. +MT safe. + + the #GstMessage that is on the bus, or NULL if the + + + + + Poll the bus for messages. Will block while waiting for messages to come. You can specify a maximum time to poll with the @timeout parameter. If All messages not in @events will be popped off the bus and will be ignored. -Because poll is implemented using the "message" signal enabled by -gst_bus_add_signal_watch(), calling gst_bus_poll() will cause the "message" -signal to be emitted for every message that poll sees. Thus a "message" +Because poll is implemented using the "message" signal enabled by +gst_bus_add_signal_watch(), calling gst_bus_poll() will cause the "message" +signal to be emitted for every message that poll sees. Thus a "message" signal handler will see the same messages that this function sees -- neither will steal messages from the other. This function will run a main loop from the default main context when @@ -1475,134 +1567,189 @@ may do things you do not expect, e.g. destroy the main application window or some other resource; change other application state; display a dialog and run another main loop until the user clicks it away. In short, using this function may add a lot of complexity to your code through unexpected -re-entrancy and unexpected changes to your application's state. +re-entrancy and unexpected changes to your application's state. For 0 timeouts use gst_bus_pop_filtered() instead of this function; for other short timeouts use gst_bus_timed_pop_filtered(); everything else is better handled by setting up an asynchronous bus watch and doing things from there. -The message is taken from the bus and needs to be unreffed with -gst_message_unref() after usage."> +poll timed out. The message is taken from the bus and needs to be +unreffed with gst_message_unref() after usage. + the message that was received, or NULL if the + a mask of #GstMessageType, representing the set of message types to poll for. + the poll timeout, as a #GstClockTimeDiff, or -1 to poll indefinitely. - - - - - - - - - - - - - - + + Get a message from the bus. +bus is empty. The message is taken from the bus and needs to be unreffed +with gst_message_unref() after usage. +MT safe. - + the #GstMessage that is on the bus, or NULL if the + + + + + Get a message matching @type from the bus. Will discard all messages on +the bus that do not match @type and that have been posted before the first +message that does match @type. If there is no message matching @type on +the bus, all messages will be discarded. +the bus, or NULL if the bus is empty or there is no message matching +gst_message_unref() after usage. +MT safe. + + the next #GstMessage matching @type that is on + - - - - - + + message types to take into account + - + + Post a message on the given bus. Ownership of the message +is taken by the bus. +MT safe. - - - - - - + TRUE if the message could be posted, FALSE if the bus is flushing. + - - + + the #GstMessage to post + + c:identifier="gst_bus_remove_signal_watch"> + Removes a signal watch previously added with gst_bus_add_signal_watch(). +MT safe. - + + If @flushing, flush out and unref any messages queued in the bus. Releases +references to the message origin objects. Will flush future messages until +gst_bus_set_flushing() sets @flushing to #FALSE. +MT safe. + + + whether or not to flush the bus + + + - + + Sets the synchronous handler on the bus. The function will be called +every time a new message is posted on the bus. Note that the function +will be called in the same thread context as the posting object. This +function is usually only called by the creator of the bus. Applications +should handle messages asynchronously using the gst_bus watch and poll +functions. +You cannot replace an existing sync_handler. You can pass NULL to this +function, which will clear the existing handler. + + + The handler function to install + + + + User data that will be sent to the handler function. + + + + + + A helper GstBusSyncHandler that can be used to convert all synchronous +messages into signals. + + GST_BUS_PASS + + + + + the #GstMessage received + + + + user data + + + + + + Get a message from the bus, waiting up to the specified timeout. +If @timeout is 0, this function behaves like gst_bus_pop(). If @timeout is +#GST_CLOCK_TIME_NONE, this function will block forever until a message was +posted on the bus. +specified timeout or NULL if the bus is empty after the timeout expired. +The message is taken from the bus and needs to be unreffed with +gst_message_unref() after usage. +MT safe. + + the #GstMessage that is on the bus after the + + + + + a timeout + + + + + + Get a message from the bus whose type matches the message type mask @types, +waiting up to the specified timeout (and discarding any messages that do not +match the mask provided). +If @timeout is 0, this function behaves like gst_bus_pop_filtered(). If +matching message was posted on the bus. +or NULL if no matching message was found on the bus until the timeout +expired. The message is taken from the bus and needs to be unreffed +with gst_message_unref() after usage. +MT safe. + + a #GstMessage matching the filter in @types, + + + + + a timeout in nanoseconds, or GST_CLOCK_TIME_NONE to wait forever + + + + message types to take into account, GST_MESSAGE_ANY for any type + + + @@ -1617,50 +1764,52 @@ MT safe."> - + - + - + - + - + A message has been posted on the bus. This signal is emitted from a GSource added to the mainloop. this signal will only be emitted when -there is a mainloop running."> - - +there is a mainloop running. + + - - + + the message that has been posted asynchronously + - + A message has been posted on the bus. This signal is emitted from the thread that posted the message so one has to be careful with locking. This signal will not be emitted by default, you have to set up gst_bus_sync_signal_handler() as a sync handler if you want this signal to be emitted when a message is posted on the bus, like this: <programlisting> gst_bus_set_sync_handler (bus, gst_bus_sync_signal_handler, yourdata); -</programlisting>"> - - +</programlisting> + + - - + + the message that has been posted synchronously + @@ -1672,7 +1821,7 @@ gst_bus_set_sync_handler (bus, gst_bus_sync_signal_handler, yourdata); - + @@ -1687,7 +1836,7 @@ gst_bus_set_sync_handler (bus, gst_bus_sync_signal_handler, yourdata); - + @@ -1703,151 +1852,139 @@ gst_bus_set_sync_handler (bus, gst_bus_sync_signal_handler, yourdata); - + - + + The standard flags that a bus may have. - + Specifies the type of function passed to gst_bus_add_watch() or gst_bus_add_watch_full(), which is called from the mainloop when a message is available on the bus. The message passed to the function will be unreffed after execution of this function so it should not be freed in the function. Note that this function is used as a GSourceFunc which means that returning -FALSE will remove the GSource from the mainloop."> +FALSE will remove the GSource from the mainloop. - + %FALSE if the event source should be removed. + + the #GstBus that sent the message + the #GstMessage - + user data that has been given, when registering the handler + - + - + Handler will be invoked synchronously, when a new message has been injected into the bus. This function is mostly used internally. Only one sync handler can be attached to a given bus. If the handler returns GST_BUS_DROP, it should unref the message, else the -message should not be unreffed by the sync handler."> - +message should not be unreffed by the sync handler. + + #GstBusSyncReply stating what to do with the message + the #GstBus that sent the message + the #GstMessage - + user data that has been given, when registering the handler + - + + The result values for a GstBusSyncHandler. - + - + - + + glib:get-type="gst_caps_get_type" + c:symbol-prefix="caps"> + Object describing media types. - + - + + + - + - + Creates a new #GstCaps that indicates that it is compatible with +any media format. + + the new #GstCaps + + + + + Creates a new #GstCaps that is empty. That is, the returned #GstCaps contains no media formats. -Caller is responsible for unreffing the returned caps."> +Caller is responsible for unreffing the returned caps. + the new #GstCaps - - - - - - - - - - - - - - - - - - - - - - + Creates a new #GstCaps and adds all the structures listed as arguments. The list must be NULL-terminated. The structures -are not copied; the returned #GstCaps owns the structures."> +are not copied; the returned #GstCaps owns the structures. + the new #GstCaps + the first structure to add @@ -1856,131 +1993,140 @@ are not copied; the returned #GstCaps owns the structures."> - + + Creates a new #GstCaps and adds all the structures listed as +arguments. The list must be NULL-terminated. The structures +are not copied; the returned #GstCaps owns the structures. + the new #GstCaps + + + the first structure to add + + + + additional structures to add + + + + + + Creates a new #GstCaps that contains one #GstStructure. The +structure is defined by the arguments, which have the same format +as gst_structure_new(). +Caller is responsible for unreffing the returned caps. + + the new #GstCaps + + + + + the media type of the structure + + + + first field to set + + + + + + + + + + Appends the structures contained in @caps2 to @caps1. The structures in +freed. If either caps is ANY, the resulting caps will be ANY. + + + + + + the #GstCaps to append + + + - + Appends @structure to @caps. The structure is not copied; @caps +becomes the owner of @structure. + + + + + + the #GstStructure to append + + + + + + Tries intersecting @caps1 and @caps2 and reports whether the result would not +be empty + + %TRUE if intersection would be not empty + + + + + a #GstCaps to intersect + + + + + + Creates a new #GstCaps as a copy of the old @caps. The new caps will have a refcount of 1, owned by the caller. The structures are copied as well. Note that this function is the semantic equivalent of a gst_caps_ref() followed by a gst_caps_make_writable(). If you only want to hold on to a reference to the data, you should use gst_caps_ref(). -When you are finished with the caps, call gst_caps_unref() on it."> +When you are finished with the caps, call gst_caps_unref() on it. + the new #GstCaps - + + Creates a new #GstCaps and appends a copy of the nth structure +contained in @caps. + the new #GstCaps - - - - - - - - - - - - + + the nth structure to copy + - + + Modifies the given @caps inplace into a representation that represents the +same set of formats, but in a simpler form. Component structures that are +identical are merged. Component structures that have values that can be +merged are also merged. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + TRUE, if the caps could be simplified + - + Gets the number of structures contained in @caps. + + the number of structures that @caps contains + + + + + Finds the structure in @caps that has the index @index, and returns it. non-const GstStructure *. This is for programming convenience -- the caller should be aware that structures inside a constant @@ -1990,67 +2136,221 @@ them writable with gst_caps_make_writable(), you may modify the structure returned in the usual way, e.g. with functions like gst_structure_set(). You do not need to free or unref the structure returned, it -belongs to the #GstCaps."> - +belongs to the #GstCaps. +to @index + + a pointer to the #GstStructure corresponding - + the index of the structure + - + + Creates a new #GstCaps that contains all the formats that are common +to both @caps1 and @caps2. + the new #GstCaps - - + + a #GstCaps to intersect + - + + A given #GstCaps structure is always compatible with another if +every media format that is in the first is also contained in the +second. That is, @caps1 is a subset of @caps2. - + TRUE if @caps1 is a subset of @caps2. + + + + + the #GstCaps to test + + + + + + Determines if @caps represents any media format. + + TRUE if @caps represents any format. + - + + Determines if @caps represents no media formats. + + TRUE if @caps represents no formats. + + + + + Checks if the given caps represent the same set of caps. +<note>This function does not work reliably if optional properties for caps +are included on one caps and omitted on the other.</note> +This function deals correctly with passing NULL for any of the caps. + + TRUE if both caps are equal. + + + + + another #GstCaps + + + + + + Tests if two #GstCaps are equal. This function only works on fixed +#GstCaps. + + TRUE if the arguments represent the same format + + + + + the #GstCaps to test + + + + + + Fixed #GstCaps describe exactly one format, that is, they have exactly +one structure, and each field in the structure describes a fixed type. +Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST. + + TRUE if @caps is fixed + + + + + Checks if all caps represented by @subset are also represented by @superset. +<note>This function does not work reliably if optional properties for caps +are included on one caps and omitted on the other.</note> + + %TRUE if @subset is a subset of @superset + + + + + a potentially greater #GstCaps + + + + + + Returns a writable copy of @caps. +If there is only one reference count on @caps, the caller must be the owner, +and so this function will return the caps object unchanged. If on the other +hand there is more than one reference on the object, a new caps object will +be returned. The caller's reference on @caps will be removed, and instead the +caller will own a reference to the returned object. +In short, this function unrefs the caps in the argument and refs the caps +that it returns. Don't access the argument after calling this function. See + + the same #GstCaps object. + + + + + Appends the structures contained in @caps2 to @caps1 if they are not yet +expressed by @caps1. The structures in @caps2 are not copied -- they are +transferred to @caps1, and then @caps2 is freed. +If either caps is ANY, the resulting caps will be ANY. - - + + the #GstCaps to merge in + - - + + + + Appends @structure to @caps if its not already expressed by @caps. The +structure is not copied; @caps becomes the owner of @structure. + + + + + + the #GstStructure to merge + + + + + + Creates a new #GstCaps that represents the same set of formats as + + the new #GstCaps + + + + + Add a reference to a #GstCaps object. +From this point on, until the caller calls gst_caps_unref() or +gst_caps_make_writable(), it is guaranteed that the caps object will not +change. This means its structures won't change, etc. To use a #GstCaps +object, you must always have a refcount on it -- either the one made +implicitly by e.g. gst_caps_new_simple(), or via taking one explicitly with +this function. + + the same #GstCaps object. + + + + + removes the stucture with the given index from the list of structures +contained in @caps. + + + + + + Index of the structure to remove + + + + + + Serializes a #GstCaps to XML and adds it as a child node of @parent. + + a XML node pointer + + + + + a XML parent node + + Sets fields in a #GstCaps. The arguments must be passed in the same manner as gst_structure_set(), and be NULL-terminated. <note>Prior to GStreamer version 0.10.26, this function failed when of GStreamer, you may only call this function when GST_CAPS_IS_SIMPLE() -is %TRUE for @caps.</note>"> +is %TRUE for @caps.</note> + first field to set @@ -2059,294 +2359,233 @@ is %TRUE for @caps.</note>"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets fields in a #GstCaps. The arguments must be passed in the same +manner as gst_structure_set(), and be NULL-terminated. +<note>Prior to GStreamer version 0.10.26, this function failed when +of GStreamer, you may only call this function when GST_CAPS_IS_SIMPLE() +is %TRUE for @caps.</note> - + + first field to set + + + + additional parameters + + + + + + Sets the given @field on all structures of @caps to the given @value. +This is a convenience function for calling gst_structure_set_value() on +all structures of @caps. + + + + + + name of the field to set + + + + value to set the field to + + + + + + Retrieves the stucture with the given index from the list of structures +contained in @caps. The caller becomes the owner of the returned structure. +to @index. + + a pointer to the #GstStructure corresponding + + + + + Index of the structure to retrieve + + + + + + Subtracts the @subtrahend from the @minuend. +<note>This function does not work reliably if optional properties for caps +are included on one caps and omitted on the other.</note> + + the resulting caps + + + + + #GstCaps to substract - + Converts @caps to a string representation. This string representation can be converted back to a #GstCaps by gst_caps_from_string(). For debugging purposes its easier to do something like this: |[ -GST_LOG ("caps are %" GST_PTR_FORMAT, caps); +GST_LOG ("caps are %" GST_PTR_FORMAT, caps); ]| -This prints the caps in human readble form."> +This prints the caps in human readble form. + a newly allocated string representing @caps. + + Destructively discard all but the first structure from @caps. Useful when +fixating. @caps must be writable. + + + + + + Creates a new #GstCaps that contains all the formats that are in +either @caps1 and @caps2. + + the new #GstCaps + + + + + a #GstCaps to union + + + + + + Unref a #GstCaps and and free all its structures and the +structures' values when the refcount reaches 0. + + + + - + + Extra flags for a caps. + Opaque #GstChildProxy data structure. + Fetches a child by its number. +too high). Unref after usage. +MT safe. + the child object or %NULL if not found (index - + the childs position in the child list + + Gets the number of child objects this parent contains. +MT safe. - + the number of child objects + - - - - - - - - - - - + c:identifier="gst_child_proxy_get_child_by_index"> + Fetches a child by its number. +too high). Unref after usage. +MT safe. + + the child object or %NULL if not found (index - + the childs position in the child list + + + + + + Looks up a child element by the given name. +Implementors can use #GstObject together with gst_object_get_name() +after usage. +MT safe. + + the child object or %NULL if not found. Unref + + + + + the childs name + + c:identifier="gst_child_proxy_get_children_count"> + Gets the number of child objects this parent contains. +MT safe. - + the number of child objects + - - + + - + - - + + - + + glib:is-gtype-struct-for="ChildProxy"> + #GstChildProxy interface. - + + the child object or %NULL if not found (index @@ -2354,15 +2593,17 @@ MT safe."> - + the childs position in the child list + - + - + the number of child objects + @@ -2372,7 +2613,7 @@ MT safe."> - + @@ -2387,7 +2628,7 @@ MT safe."> - + @@ -2403,61 +2644,35 @@ MT safe."> - + - - - - - - - - - - - - - - - - - - - - + #GstClock base structure. The values of this structure are +protected for subclasses, use the methods to use the #GstClock. - + - + - + - + @@ -2466,8 +2681,52 @@ MT safe."> - + + Increase the refcount of given @id. +MT safe. + The same #GstClockID with increased refcount. + + + + + The #GstClockID to ref + + + + + + Unref given @id. When the refcount reaches 0 the +#GstClockID will be freed. +MT safe. + + + + + + The #GstClockID to unref + + + + + + Cancel an outstanding request with @id. This can either +be an outstanding async notification or a pending sync notification. +After this call, @id cannot be used anymore to receive sync or +async notifications, you need to create a new #GstClockID. +MT safe. + + + + + + The id to unschedule + + + + + + @@ -2481,50 +2740,76 @@ MT safe."> + Register a callback on the given #GstClockID @id with the given function and user_data. When passing a #GstClockID with an invalid time to this function, the callback will be called immediately with a time set to GST_CLOCK_TIME_NONE. The callback will be called when the time of @id has been reached. The callback @func can be invoked from any thread, either provided by the core or from a streaming thread. The application should be prepared for this. -MT safe."> - +MT safe. + + the result of the non blocking wait. + a #GstClockID to wait on + + + + The callback function + + + + User data passed in the callback + + + + + + Register a callback on the given #GstClockID @id with the given +function and user_data. When passing a #GstClockID with an invalid +time to this function, the callback will be called immediately +with a time set to GST_CLOCK_TIME_NONE. The callback will +be called when the time of @id has been reached. +The callback @func can be invoked from any thread, either provided by the +core or from a streaming thread. The application should be prepared for this. +MT safe. + + the result of the non blocking wait. + + + + + a #GstClockID to wait on + scope="notified" + closure="2" + destroy="3"> + The callback function - + User data passed in the callback + - - - - - - - - - + + #GDestroyNotify for user_data + - + @@ -2536,35 +2821,15 @@ MT safe."> - - - - - - + - - - + + + - - - - - - - - - - - - - - - @@ -2576,8 +2841,28 @@ MT safe."> + + + + + + + + + + + + + + + + + + + + - + @@ -2589,43 +2874,30 @@ MT safe."> - - - + + + - + + + + + + + - - - - - - - - - - - + - + - - - - - - - - - @@ -2647,9 +2919,94 @@ MT safe."> + + + + + + + Get the master clock that @clock is slaved to or %NULL when the clock is +not slaved to any master clock. +not slaved to a master clock. Unref after usage. +MT safe. + + a master #GstClock or %NULL when this clock is + + + + + + + + + + + + + + + Get an ID from @clock to trigger a periodic notification. +The periodic notifications will start at time @start_time and +will then be fired with the given @interval. @id should be unreffed +after usage. +time notification. +MT safe. + + a #GstClockID that can be used to request the + + + + + the requested start time + + + + the requested interval + + + + + + Get a #GstClockID from @clock to trigger a single shot +notification at the requested time. The single shot id should be +unreffed after usage. +time notification. +MT safe. + + a #GstClockID that can be used to request the + + + + + the requested time + + + + + + + + + + + + + + + + + + + + + + + - + @@ -2657,48 +3014,38 @@ MT safe."> - - - - - - + - + - + - - - - - - - - - - - - - - + + Reinitializes the provided single shot @id to the provided time. Does not +modify the reference count. + + %TRUE if the GstClockID could be reinitialized to the provided + - + + a #GstClockID + + + + The requested time. - + @@ -2707,41 +3054,17 @@ MT safe."> - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - - + + @@ -2765,7 +3088,9 @@ MT safe."> - + + + @@ -2774,22 +3099,22 @@ MT safe."> - + - + - + - + - + @@ -2806,48 +3131,47 @@ MT safe."> - + - + + The function prototype of the callback. - + %TRUE or %FALSE (currently unused) + + The clock that triggered the callback + The time it was triggered + The #GstClockID that expired - - + + user data passed in the gst_clock_id_wait_async() function + + glib:is-gtype-struct-for="Clock"> + GStreamer clock class. Override the vmethods to implement the clock +functionality. - - + + @@ -2864,8 +3188,8 @@ functionality."> - - + + @@ -2876,8 +3200,8 @@ functionality."> - - + + @@ -2888,8 +3212,8 @@ functionality."> - - + + @@ -2903,8 +3227,8 @@ functionality."> - - + + @@ -2918,7 +3242,7 @@ functionality."> - + @@ -2933,8 +3257,8 @@ functionality."> - - + + @@ -2952,16 +3276,17 @@ functionality."> - + - + + All pending timeouts or periodic notifies are converted into +an entry. +Note that GstClockEntry should be treated as an opaque structure. It must +not be extended or allocated using a custom allocator. - + @@ -2982,20 +3307,27 @@ an entry."> - + + + + + + + + + + - + + The type of the clock entry - + + The capabilities of this clock @@ -3016,11 +3348,10 @@ an entry."> c:identifier="GST_CLOCK_FLAG_CAN_SET_MASTER"/> - + - + + The return value of a clock operation. + - + + The different kind of clocks. @@ -3046,25 +3376,25 @@ The different kind of clocks." - - + version="0.10.25" + introspectable="0"> + A function to create a copy of some object or +increase its reference count. + + a copy of the object or the same object with increased reference count + - + The object to copy + + Core errors are errors inside the core GStreamer library. - + - + - + - - + + Opaque, immutable, refcounted struct that stores date, time and timezone +information. It currently supports ranges from 0001-01-01 to +9999-12-31 in the Gregorian proleptic calendar. +Use the acessor functions to get the stored values. + + Creates a new #GstDateTime using the date and times in the gregorian calendar +in the supplied timezone. +1 to 31, @hour from 0 to 23, @minutes and @seconds from 0 to 59. +Note that @tzoffset is a float and was chosen so for being able to handle +some fractional timezones, while it still keeps the readability of +represeting it in hours for most timezones. + + the newly created #GstDateTime + + + + + Offset from UTC in hours. + + + + the gregorian year + + + + the gregorian month + + + + the day of the gregorian month + + + + the hour of the day + + + + the minute of the hour + + + + the second of the minute + + + + + + Creates a new #GstDateTime using the time since Jan 1, 1970 specified by + + the newly created #GstDateTime + + + + + seconds from the Unix epoch + + + + + + Creates a new #GstDateTime using the time since Jan 1, 1970 specified by + + the newly created #GstDateTime + + + + + seconds from the Unix epoch + + + + + + Creates a new #GstDateTime using the date and times in the gregorian calendar +in the local timezone. +1 to 31, @hour from 0 to 23, @minutes and @seconds from 0 to 59. + + the newly created #GstDateTime + + + + + the gregorian year + + + + the gregorian month + + + + the day of the gregorian month + + + + the hour of the day + + + + the minute of the hour + + + + the second of the minute + + + + + + Creates a new #GstDateTime representing the current date and time. +be freed with gst_date_time_unref(). + + the newly created #GstDateTime which should + + + + + Creates a new #GstDateTime that represents the current instant at Universal +coordinated time. +be freed with gst_date_time_unref(). + + the newly created #GstDateTime which should + + + + + Returns the day of this #GstDateTime. + + The day of this #GstDateTime + + + + + Retrieves the hour of the day represented by @datetime in the gregorian +calendar. The return is in the range of 0 to 23. + + the hour of the day + + + + + Retrieves the fractional part of the seconds in microseconds represented by + + the microsecond of the second + + + + + Retrieves the minute of the hour represented by @datetime in the gregorian +calendar. + + the minute of the hour + + + + + Returns the month of this #GstDateTime. January is 1, February is 2, etc.. + + The month of this #GstDateTime + + + + + Retrieves the second of the minute represented by @datetime in the gregorian +calendar. + + the second represented by @datetime + + + + + Retrieves the offset from UTC in hours that the timezone specified +by @datetime represents. Timezones ahead (to the east) of UTC have positive +values, timezones before (to the west) of UTC have negative values. +If @datetime represents UTC time, then the offset is zero. + + the offset from UTC in hours + + + + + Returns the year of this #GstDateTime + + The year of this #GstDateTime + + + + + Atomically increments the reference count of @datetime by one. + + the reference @datetime + + + + + Atomically decrements the reference count of @datetime by one. When the +reference count reaches zero, the structure is freed. + + + + + + + This is the struct that describes the categories. Once initialized with +#GST_DEBUG_CATEGORY_INIT, its values can't be changed anymore. - + - + @@ -3125,77 +3690,78 @@ Core errors are errors inside the core GStreamer library." - + + Removes and frees the category and all associated resources. + + + + + + Returns the color of a debug category used when printing output in this +category. + + the color of the category. + + + + + Returns the description of a debug category. + + the description of the category. + + + + + Returns the name of a debug category. + + the name of the category. + + + + + Returns the threshold of a #GstDebugCategory. + + the #GstDebugLevel that is used as threshold. + + + + + Resets the threshold of the category to the default level. Debug information +will only be output if the threshold is lower or equal to the level of the +debugging message. +Use this function to set the threshold back to where it was after using +gst_debug_category_set_threshold(). + Sets the threshold of the category to the given level. Debug information will only be output if the threshold is lower or equal to the level of the debugging message. <note><para> Do not use this function in production code, because other functions may change the threshold of categories as side effect. It is however a nice function to use when debugging (even from gdb). -</para></note>"> +</para></note> + the #GstDebugLevel threshold to set. - - - - - - - - - - - - - - - - - - - - - - - - - - + + These are some terminal style flags you can use when creating your +debugging categories to make them stand out in debugging output. @@ -3223,10 +3789,10 @@ debugging categories to make them stand out in debugging output." + Available details for pipeline graphs produced by GST_DEBUG_BIN_TO_DOT_FILE() +and GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS(). @@ -3241,31 +3807,9 @@ and GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS()." c:identifier="GST_DEBUG_GRAPH_SHOW_STATES"/> - + + The level defines the importance of a debugging message. The more important a +message is, the greater the probability that the debugging system outputs it. @@ -3273,121 +3817,340 @@ message is, the greater the probability that the debugging system outputs it." + - - + + + Gets the string representation of a #GstDebugMessage. This function is used +in debug handlers to extract the message. + the string representation of a #GstDebugMessage. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + - + - - - - - - - - - - - - - - - - - - - - + GStreamer element abstract base class. + + Creates an element for handling the given URI. + a new element or NULL if none could be created + Whether to create a source or a sink + URI to create an element for - + + Name of created element, can be NULL. - + + Create a new elementfactory capable of instantiating objects of the - + TRUE, if the registering succeeded, FALSE on error + - - + + #GstPlugin to register the element with, or NULL for a static element (note that passing NULL only works in GStreamer 0.10.13 and later) + + + + name of elements of this type + + + + rank of element (higher rank means more importance when autoplugging) + + + + GType of element to register + + Gets a string representing the given state change result. +result. + a string with the name of the state + a #GstStateChangeReturn to get the name of. - - - + + Gets a string representing the given state. + + a string with the name of the state. + - - + + a #GstState to get the name of. + - - + + + + Perform @transition on @element. +This function must be called with STATE_LOCK held and is mainly used +internally. + + the #GstStateChangeReturn of the state transition. + + + + + the requested transition + + + + + + Gets the index from the element. +element. unref after usage. +MT safe. + + a #GstIndex or %NULL when no index was set on the + + + + + Get an array of query types from the element. +If the element doesn't implement a query types function, +the query will be forwarded to the peer of a random linked sink pad. +be freed or modified. +MT safe. + + An array of #GstQueryType elements that should not + + + + + Gets the state of the element. +For elements that performed an ASYNC state change, as reported by +gst_element_set_state(), this function will block up to the +specified timeout value for the state change to complete. +If the element completes the state change or goes into +an error, this function returns immediately with a return value of +%GST_STATE_CHANGE_SUCCESS or %GST_STATE_CHANGE_FAILURE respectively. +For elements that did not return %GST_STATE_CHANGE_ASYNC, this function +returns the current and pending state immediately. +This function returns %GST_STATE_CHANGE_NO_PREROLL if the element +successfully changed its state but is not able to provide data yet. +This mostly happens for live sources that only produce data in +%GST_STATE_PLAYING. While the state change return is equivalent to +%GST_STATE_CHANGE_SUCCESS, it is returned to the application to signal that +some sink elements might not be able to complete their state change because +an element is not producing data to complete the preroll. When setting the +element to playing, the preroll will complete and playback will start. +and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the +element is still performing a state change or +%GST_STATE_CHANGE_FAILURE if the last state change failed. +MT safe. + + %GST_STATE_CHANGE_SUCCESS if the element has no more pending state + + + + + a pointer to #GstState to hold the state. Can be %NULL. + + + + a pointer to #GstState to hold the pending state. Can be %NULL. + + + + a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout. + + + + + + Get the clock provided by the given element. +<note>An element is only required to provide a clock in the PAUSED +state. Some elements can provide a clock in other states.</note> +if no clock could be provided. Unref after usage. +MT safe. + + the GstClock provided by the element or %NULL + + + + + Performs a query on the given element. +For elements that don't implement a query handler, this function +forwards the query to a random srcpad or to the peer of a +random linked sinkpad of this element. +Please note that some queries might need a running pipeline to work. +MT safe. + + TRUE if the query could be performed. + + + + + the #GstQuery. + @@ -3401,278 +4164,133 @@ Create a new elementfactory capable of instantiating objects of the"> - - - + + + - - + + - - - - - + + - - - + + + - - + + - - - - - - - - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Sends an event to an element. If the element doesn't implement an +event handler, the event will be pushed on a random linked sink pad for +upstream events or a random linked source pad for downstream events. +This function takes owership of the provided event so you should +gst_event_ref() it if you want to reuse the event after this call. +MT safe. - + %TRUE if the event was handled. + - + + the #GstEvent to send to the element. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the bus of the element. Increases the refcount on the bus. +For internal use only, unless you're testing elements. +MT safe. + the #GstBus to set. - - - - + + + Sets the clock for the element. This function increases the +refcount on the clock. Any previously set clock on the object +is unreffed. +clock when it, for example, is not able to slave its internal clock to the +MT safe. + + %TRUE if the element accepted the clock. An element can refuse a + + + + + the #GstClock to set for the element. + + + + + + Set @index on the element. The refcount of the index +will be increased, any previously set index is unreffed. +MT safe. + + + + + + a #GstIndex. + + + + + + Sets the state of the element. This function will try to set the +requested state by going through all the intermediary states and calling +the class's state change function for each. +This function can return #GST_STATE_CHANGE_ASYNC, in which case the +element will perform the remainder of the state change asynchronously in +another thread. +An application can use gst_element_get_state() to wait for the completion +of the state change or it can wait for a state change message on the bus. +State changes to %GST_STATE_READY or %GST_STATE_NULL never return +#GST_STATE_CHANGE_ASYNC. +MT safe. + + Result of the state change using #GstStateChangeReturn. + + + + + the element's new #GstState. + + + + + + Abort the state change of the element. This function is used +by elements that do asynchronous state changes and find out +something is wrong. +This function should be called with the STATE_LOCK held. +MT safe. + + - + Adds a pad (link point) to @element. @pad's parent will be set to @element; see gst_object_set_parent() for refcounting information. Pads are not automatically activated so elements should perform the needed steps to activate the pad in case this pad is added in the PAUSED or PLAYING @@ -3681,314 +4299,251 @@ The pad and the element should be unlocked when calling this function. This function will emit the #GstElement::pad-added signal on the element. a pad with the same name already existed or the pad already had another parent. -MT safe."> +MT safe. - + %TRUE if the pad could be added. This function can fail when + - + + the #GstPad to add to the element. - + + Perform @transition on @element. +This function must be called with STATE_LOCK held and is mainly used +internally. - + the #GstStateChangeReturn of the state transition. + - - + + the requested transition + - + + Commit the state change of the element and proceed to the next +pending state if any. This function is used +by elements that do asynchronous state changes. +The core will normally call this method automatically when an +element returned %GST_STATE_CHANGE_SUCCESS from the state change function. +If after calling this method the element still has not reached +the pending state, the next state change is performed. +This method is used internally and should normally not be called by plugins +or applications. +MT safe. + + The result of the commit state change. + + + + + The previous state return value + + + + + + Creates a pad for each pad template that is always available. +This function is only useful during object intialization of +subclasses of #GstElement. + + Posts a message to the bus that new tags were found, and pushes an event +to all sourcepads. Takes ownership of the @list. +This is a utility method for elements. Applications should use the +#GstTagSetter interface. + + + + + + list of tags. + + + + + + Posts a message to the bus that new tags were found and pushes the +tags as event. Takes ownership of the @list. +This is a utility method for elements. Applications should use the +#GstTagSetter interface. + + + + + + pad on which to push tag-event + + + + the taglist to post on the bus and create event from + + + + + + Returns the base time of the element. The base time is the +absolute time of the clock when this element was last put to +PLAYING. Subtracting the base time from the clock time gives +the running time of the element. +MT safe. + + the base time of the element. + + + + + Returns the bus of the element. Note that only a #GstPipeline will provide a +bus for the application. +MT safe. + + the element's #GstBus. unref after usage. + + + + + Gets the currently configured clock of the element. This is the clock as was +last set with gst_element_set_clock(). +MT safe. + + the #GstClock of the element. unref after usage. + + + + + Looks for an unlinked pad to which the given pad can link. It is not +guaranteed that linking the pads will work, though it should work in most +cases. +This function will first attempt to find a compatible unlinked ALWAYS pad, +and if none can be found, it will request a compatible REQUEST pad by looking +at the templates of @element. +if one cannot be found. gst_object_unref() after usage. + + the #GstPad to which a link can be made, or %NULL + + + + + the #GstPad to find a compatible one for. + + + + the #GstCaps to use as a filter. + + + + + + Retrieves a pad template from @element that is compatible with @compattempl. +Pads from compatible templates can be linked together. +was found. No unreferencing is necessary. + + a compatible #GstPadTemplate, or NULL if none + + + + + the #GstPadTemplate to find a compatible template for + + + + + + Retrieves the factory that was used to create this element. +element. no refcounting is needed. + + the #GstElementFactory used for creating this + + + + + Gets the index from the element. +element. unref after usage. +MT safe. + + a #GstIndex or %NULL when no index was set on the + + + + Retrieves a pad from @element by name. Tries gst_element_get_static_pad() first, then gst_element_get_request_pad(). to the result pad should be released with gst_object_unref() in case of a static pad or gst_element_release_request_pad() in case of a request pad. Use gst_element_get_static_pad() or gst_element_get_request_pad() instead. -depending on the type of the pad." - deprecated="This function is deprecated as it's unclear if the reference"> +depending on the type of the pad. + the #GstPad if found, otherwise %NULL. Unref or Release after usage, + the name of the pad to retrieve. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Get an array of query types from the element. +If the element doesn't implement a query types function, the query will be forwarded to the peer of a random linked sink pad. be freed or modified. -MT safe."> +MT safe. + An array of #GstQueryType elements that should not - - - + + Retrieves a pad from the element by name. This version only retrieves +request pads. The pad should be released with +gst_element_release_request_pad(). +This method is slow and will be deprecated in the future. New code should +use gst_element_request_pad() with the requested template. +Release after usage. + + requested #GstPad if found, otherwise %NULL. + - - + + the name of the request #GstPad to retrieve. + - + + Returns the start time of the element. The start time is the +running time of the clock when this element was last put to PAUSED. +Usually the start_time is managed by a toplevel element such as +#GstPipeline. +MT safe. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the start time of the element. + - - - - - - - - - - - - - - - - + Gets the state of the element. For elements that performed an ASYNC state change, as reported by gst_element_set_state(), this function will block up to the specified timeout value for the state change to complete. @@ -3999,7 +4554,7 @@ For elements that did not return %GST_STATE_CHANGE_ASYNC, this function returns the current and pending state immediately. This function returns %GST_STATE_CHANGE_NO_PREROLL if the element successfully changed its state but is not able to provide data yet. -This mostly happens for live sources that only produce data in +This mostly happens for live sources that only produce data in %GST_STATE_PLAYING. While the state change return is equivalent to %GST_STATE_CHANGE_SUCCESS, it is returned to the application to signal that some sink elements might not be able to complete their state change because @@ -4008,110 +4563,295 @@ element to playing, the preroll will complete and playback will start. and the last state change succeeded, %GST_STATE_CHANGE_ASYNC if the element is still performing a state change or %GST_STATE_CHANGE_FAILURE if the last state change failed. -MT safe."> - +MT safe. + + %GST_STATE_CHANGE_SUCCESS if the element has no more pending state + caller-allocates="1" + transfer-ownership="none" + allow-none="1"> + a pointer to #GstState to hold the state. Can be %NULL. + caller-allocates="1" + transfer-ownership="none" + allow-none="1"> + a pointer to #GstState to hold the pending state. Can be %NULL. + a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout. - + + Retrieves a pad from @element by name. This version only retrieves +already-existing (i.e. 'static') pads. +unref after usage. +MT safe. - + the requested #GstPad if found, otherwise %NULL. + - - + + the name of the static #GstPad to retrieve. + - + + Test whether the given element implements a certain interface of type +iface_type, and test whether it is supported for this specific instance. - - - - - - + whether or not the element implements the interface. + - - + + (final) type of the interface which we want to be implemented + - + + Queries if the element can be indexed. +MT safe. + + TRUE if the element can be indexed. + + + + + Checks if the state of an element is locked. +If the state of an element is locked, state changes of the parent don't +affect the element. +This way you can leave currently unused elements inside bins. Just lock their +state before changing the state from #GST_STATE_NULL. +MT safe. + + TRUE, if the element's state is locked. + + + + + Retrieves an iterattor of @element's pads. The iterator should +be freed after usage. +after use. +MT safe. - + the #GstIterator of #GstPad. Unref each pad + + + + + Retrieves an iterator of @element's sink pads. +after use. +MT safe. + + the #GstIterator of #GstPad. Unref each pad + + + + + Retrieves an iterator of @element's source pads. +after use. +MT safe. + + the #GstIterator of #GstPad. Unref each pad + + + + + Links @src to @dest. The link must be from source to +destination; the other direction will not be tried. The function looks for +existing pads that aren't linked yet. It will request new pads if necessary. +Such pads need to be released manualy when unlinking. +If multiple links are possible, only one is established. +Make sure you have added your elements to a bin or pipeline with +gst_bin_add() before trying to link them. + + TRUE if the elements could be linked, FALSE otherwise. + - - + + the #GstElement containing the destination pad. + - + Links @src to @dest using the given caps as filtercaps. +The link must be from source to +destination; the other direction will not be tried. The function looks for +existing pads that aren't linked yet. It will request new pads if necessary. +If multiple links are possible, only one is established. +Make sure you have added your elements to a bin or pipeline with +gst_bin_add() before trying to link them. + + TRUE if the pads could be linked, FALSE otherwise. + + + + + the #GstElement containing the destination pad. + + + + the #GstCaps to filter the link, or #NULL for no filter. + + + + + + Chain together a series of elements. Uses gst_element_link(). +Make sure you have added your elements to a bin or pipeline with +gst_bin_add() before trying to link them. + + TRUE on success, FALSE otherwise. + + + + + the second #GstElement in the link chain. + + + + + + + + + + Links the two named pads of the source and destination elements. +Side effect is that if one of the pads has no parent, it becomes a +child of the parent of the other element. If they have different +parents, the link fails. + + TRUE if the pads could be linked, FALSE otherwise. + + + + + the name of the #GstPad in source element or NULL for any pad. + + + + the #GstElement containing the destination pad. + + + + the name of the #GstPad in destination element, or NULL for any pad. + + + + + + Links the two named pads of the source and destination elements. Side effect +is that if one of the pads has no parent, it becomes a child of the parent of +the other element. If they have different parents, the link fails. If @caps +is not #NULL, makes sure that the caps of the link is a subset of @caps. + + TRUE if the pads could be linked, FALSE otherwise. + + + + + the name of the #GstPad in source element or NULL for any pad. + + + + the #GstElement containing the destination pad. + + + + the name of the #GstPad in destination element or NULL for any pad. + + + + the #GstCaps to filter the link, or #NULL for no filter. + + + + + + Links the two named pads of the source and destination elements. +Side effect is that if one of the pads has no parent, it becomes a +child of the parent of the other element. If they have different +parents, the link fails. +Calling gst_element_link_pads_full() with @flags == %GST_PAD_LINK_CHECK_DEFAULT +is the same as calling gst_element_link_pads() and the recommended way of +linking pads with safety checks applied. + + TRUE if the pads could be linked, FALSE otherwise. + + + + + the name of the #GstPad in source element or NULL for any pad. + + + + the #GstElement containing the destination pad. + + + + the name of the #GstPad in destination element, or NULL for any pad. + + + + the #GstPadLinkCheck to be performed when linking pads. + + + + + + Brings the element to the lost state. This function calls gst_element_lost_state_full() with the new_base_time set to %TRUE. This function is used internally and should normally not be called from plugins or applications. -MT safe."> +MT safe. + Brings the element to the lost state. The current state of the element is copied to the pending state so that any call to gst_element_get_state() will return %GST_STATE_CHANGE_ASYNC. An ASYNC_START message is posted with indication to distribute a new @@ -4126,236 +4866,333 @@ queued. This function can only be called when the element is currently not in error or an async state change. This function is used internally and should normally not be called from plugins or applications. -MT safe." - version="0.10.24"> +MT safe. - + if a new base time should be distributed + - - - - - - + + Post an error, warning or info message on the bus from inside an element. +#GST_MESSAGE_INFO. +MT safe. - + - - + + the #GstMessageType + + + + the GStreamer GError domain this message belongs to + + + + the GError code belonging to the domain + + + + an allocated text string to be used as a replacement for the default message connected to code, or %NULL + + + + an allocated debug message to be used as a replacement for the default debugging information, or %NULL + + + + the source code file where the error was generated + + + + the source code function where the error was generated + + + + the source code line where the error was generated + - + + Use this function to signal that the element does not expect any more pads +to show up in the current pipeline. This function should be called whenever +pads have been added by the element itself. Elements with #GST_PAD_SOMETIMES +pad templates use this in combination with autopluggers to figure out that +the element is done initializing its pads. +This function emits the #GstElement::no-more-pads signal. +MT safe. - + + Post a message on the element's #GstBus. This function takes ownership of the +message; if you want to access the message after this call, you should add an +additional reference before calling. +%FALSE if the element did not have a bus. +MT safe. + + %TRUE if the message was successfully posted. The function returns + + + + + a #GstMessage to post + + + + + + Get the clock provided by the given element. +<note>An element is only required to provide a clock in the PAUSED +state. Some elements can provide a clock in other states.</note> +if no clock could be provided. Unref after usage. +MT safe. - + the GstClock provided by the element or %NULL + + + + + Query if the element provides a clock. A #GstClock provided by an +element can be used as the global #GstClock for the pipeline. +An element that can provide a clock is only required to do so in the PAUSED +state, this means when it is fully negotiated and has allocated the resources +to operate the clock. +MT safe. + + %TRUE if the element provides a clock + + + + + Performs a query on the given element. +For elements that don't implement a query handler, this function +forwards the query to a random srcpad or to the peer of a +random linked sinkpad of this element. +Please note that some queries might need a running pipeline to work. +MT safe. + + TRUE if the query could be performed. + + + + + the #GstQuery. + + + + + + Queries an element to convert @src_val in @src_format to @dest_format. + + TRUE if the query could be performed. + + + + + a #GstFormat to convert from. + + + + a value to convert. + + + + a pointer to the #GstFormat to convert to. + + + + a pointer to the result. + + + + + + Queries an element for the total stream duration. + + TRUE if the query could be performed. + + + + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + + + + A location in which to store the total duration, or NULL. + + + + + + Queries an element for the stream position. + + TRUE if the query could be performed. + + + + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + + + + a location in which to store the current position, or NULL. + + + + + + Makes the element free the previously requested pad as obtained +with gst_element_get_request_pad(). +This does not unref the pad. If the pad was created by using +gst_element_get_request_pad(), gst_element_release_request_pad() needs to be +followed by gst_object_unref() to free the @pad. +MT safe. + + + the #GstPad to release. - - + + + + Removes @pad from @element. @pad will be destroyed if it has not been +referenced elsewhere using gst_object_unparent(). +This function is used by plugin developers and should not be used +by applications. Pads that were dynamically requested from elements +with gst_element_get_request_pad() should be released with the +gst_element_release_request_pad() function instead. +Pads are not automatically deactivated so elements should perform the needed +steps to deactivate the pad in case this pad is removed in the PAUSED or +PLAYING state. See gst_pad_set_active() for more information about +deactivating pads. +The pad and the element should be unlocked when calling this function. +This function will emit the #GstElement::pad-removed signal on the element. +pad does not belong to the provided element. +MT safe. + + %TRUE if the pad could be removed. Can return %FALSE if the + + + + + the #GstPad to remove from the element. + - + + Retrieves a request pad from the element according to the provided template. +If the @caps are specified and the element implements thew new +request_new_pad_full virtual method, the element will use them to select +which pad to create. +The pad should be released with gst_element_release_request_pad(). +Release after usage. - + requested #GstPad if found, otherwise %NULL. + - + + a #GstPadTemplate of which we want a pad of. - - - - - - - - - + + the name of the request #GstPad to retrieve. Can be %NULL. + - - - - - - - - - - - - - - - - - - - - - - - - - + + the caps of the pad we want to request. Can be %NULL. - + + Query if the element requires a clock. +MT safe. - + %TRUE if the element requires a clock + - - - - - - + + Sends a seek event to an element. See gst_event_new_seek() for the details of +the parameters. The seek event is sent to the element using +gst_element_send_event(). +MT safe. - + %TRUE if the event was handled. + - - + + The new playback rate + - - - + + The format of the seek values + - - - - - - - - - + + The optional seek flags. + - - + + The type and flags for the new current position + - - + + The value of the new current position + - - - - - - - - - + + The type and flags for the new stop position + - - - - - - - - - - - - - - - - - - - - - - - - + + The value of the new stop position + - + @@ -4365,99 +5202,209 @@ is not #NULL, makes sure that the caps of the link is a subset of @caps."> - + - + + Sends an event to an element. If the element doesn't implement an +event handler, the event will be pushed on a random linked sink pad for +upstream events or a random linked source pad for downstream events. +This function takes owership of the provided event so you should +gst_event_ref() it if you want to reuse the event after this call. +MT safe. - + %TRUE if the event was handled. + - - - - - + + the #GstEvent to send to the element. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Set the base time of an element. See gst_element_get_base_time(). +MT safe. - - - - - + + the base time to set. + - + + Sets the bus of the element. Increases the refcount on the bus. +For internal use only, unless you're testing elements. +MT safe. - - + + the #GstBus to set. + + + + + + Sets the clock for the element. This function increases the +refcount on the clock. Any previously set clock on the object +is unreffed. +clock when it, for example, is not able to slave its internal clock to the +MT safe. + + %TRUE if the element accepted the clock. An element can refuse a + + + + + the #GstClock to set for the element. + + + + + + Set @index on the element. The refcount of the index +will be increased, any previously set index is unreffed. +MT safe. + + + + + + a #GstIndex. + + + + + + Locks the state of an element, so state changes of the parent don't affect +this element anymore. +MT safe. +or the elements state-locking needed no change. + + TRUE if the state was changed, FALSE if bad parameters were given + + + + + TRUE to lock the element's state + + + + + + Set the start time of an element. The start time of the element is the +running time of the element when it last went to the PAUSED state. In READY +or after a flushing seek, it is set to 0. +Toplevel elements like #GstPipeline will manage the start_time and +base_time on its children. Setting the start_time to #GST_CLOCK_TIME_NONE +on such a toplevel element will disable the distribution of the base_time to +the children and can be useful if the application manages the base_time +itself, for example if you want to synchronize capture from multiple +pipelines, and you can also ensure that the pipelines have the same clock. +MT safe. + + + + + + the base time to set. + + + + + + Sets the state of the element. This function will try to set the +requested state by going through all the intermediary states and calling +the class's state change function for each. +This function can return #GST_STATE_CHANGE_ASYNC, in which case the +element will perform the remainder of the state change asynchronously in +another thread. +An application can use gst_element_get_state() to wait for the completion +of the state change or it can wait for a state change message on the bus. +State changes to %GST_STATE_READY or %GST_STATE_NULL never return +#GST_STATE_CHANGE_ASYNC. +MT safe. + + Result of the state change using #GstStateChangeReturn. + + + + + the element's new #GstState. + + + + + + Tries to change the state of the element to the same as its parent. +If this function returns FALSE, the state of element is undefined. +MT safe. + + TRUE, if the element's state could be synced to the parent's state. + + + + + Unlinks all source pads of the source element with all sink pads +of the sink element to which they are linked. +If the link has been made using gst_element_link(), it could have created an +requestpad, which has to be released using gst_element_release_request_pad(). + + + + + + the sink #GstElement to unlink. + + + + + + Unlinks a series of elements. Uses gst_element_unlink(). + + + + + + the second #GstElement in the link chain. + + + + + + + + + + Unlinks the two named pads of the source and destination elements. + + + + + + the name of the #GstPad in source element. + + + + a #GstElement containing the destination pad. + + + + the name of the #GstPad in destination element. + @@ -4471,7 +5418,7 @@ This is a utility method for elements. Applications should use the - + @@ -4495,25 +5442,31 @@ This is a utility method for elements. Applications should use the - + - + + + - + - + + + - + - + + + - + @@ -4526,44 +5479,46 @@ This is a utility method for elements. Applications should use the - + - - - + + This signals that the element will not generate more dynamic pads. + + - - - + + a new #GstPad has been added to the element. + + - - + + the pad that has been added + - - - + + a #GstPad has been removed from the element + + - - + + the pad that has been removed + + glib:is-gtype-struct-for="Element"> + GStreamer element class. Override the vmethods to implement the element +functionality. @@ -4574,16 +5529,18 @@ functionality."> - + + + - + - + - + @@ -4598,7 +5555,7 @@ functionality."> - + @@ -4613,7 +5570,7 @@ functionality."> - + @@ -4624,9 +5581,9 @@ functionality."> - - - + + + @@ -4643,7 +5600,7 @@ functionality."> - + @@ -4658,29 +5615,42 @@ functionality."> - - + + + %GST_STATE_CHANGE_SUCCESS if the element has no more pending state - + + a pointer to #GstState to hold the state. Can be %NULL. - + + a pointer to #GstState to hold the pending state. Can be %NULL. + a #GstClockTime to specify the timeout for an async state change or %GST_CLOCK_TIME_NONE for infinite timeout. - - + + + Result of the state change using #GstStateChangeReturn. @@ -4688,14 +5658,16 @@ functionality."> + the element's new #GstState. - - + + + the #GstStateChangeReturn of the state transition. @@ -4703,13 +5675,14 @@ functionality."> + the requested transition - + @@ -4718,14 +5691,16 @@ functionality."> + the #GstBus to set. - + + the GstClock provided by the element or %NULL @@ -4736,23 +5711,26 @@ functionality."> - + - + %TRUE if the element accepted the clock. An element can refuse a + + the #GstClock to set for the element. - + + a #GstIndex or %NULL when no index was set on the @@ -4763,7 +5741,7 @@ functionality."> - + @@ -4772,29 +5750,33 @@ functionality."> + a #GstIndex. - + - + %TRUE if the event was handled. + - + + the #GstEvent to send to the element. - + + An array of #GstQueryType elements that should not @@ -4805,121 +5787,110 @@ functionality."> - + - + TRUE if the query could be performed. + + the #GstQuery. + + + + + + + + + + + + + + + + + + + + + + + + - - + + + c:identifier="gst_element_class_add_pad_template"> + Adds a padtemplate to an element class. This is mainly used in the _base_init +functions of classes. + a #GstPadTemplate to add to the element class. + Retrieves a padtemplate from @element_class with the given name. <note>If you use this function in the #GInstanceInitFunc of an object class that has subclasses, make sure to pass the g_class parameter of the #GInstanceInitFunc here.</note> -No unreferencing is necessary."> - +if none was found. No unreferencing is necessary. + + the #GstPadTemplate with the given name, or %NULL + the name of the #GstPadTemplate to get. + Retrieves a list of the pad templates associated with @element_class. The list must not be modified by the calling code. <note>If you use this function in the #GInstanceInitFunc of an object class that has subclasses, make sure to pass the g_class parameter of the -#GInstanceInitFunc here.</note>"> - - - - - +#GInstanceInitFunc here.</note> +pad templates. - + the #GList of + + + - - - - - - - - - - - - - - - - - - - - - - - - + Adds a list of standardized properties with types to the @klass. the id is for the property switch in your get_prop method, and -the flags determine readability / writeability."> +the flags determine readability / writeability. + the name of the first property. in a NULL terminated @@ -4928,15 +5899,89 @@ the flags determine readability / writeability."> + + Sets the detailed information for a #GstElementClass. +<note>This function is for use in _base_init functions only.</note> +The @details are copied. + + + + + + details to set + + + + + + Sets the detailed information for a #GstElementClass. Simpler version of +gst_element_class_set_details() that generates less linker overhead. +<note>This function is for use in _base_init functions only.</note> +The detail parameter strings are copied into the #GstElementDetails for +the element class. + + + + + + The long English name of the element. E.g. "File Sink" + + + + String describing the type of element, as an unordered list separated with slashes ('/'). See draft-klass.txt of the design docs for more details and common types. E.g: "Sink/File" + + + + Sentence describing the purpose of the element. E.g: "Write stream to a file" + + + + Name and contact details of the author(s). Use \n to separate multiple author details. E.g: "Joe Bloggs &lt;joe.blogs at foo.com&gt;" + + + + + + Set uri pointing to user documentation. Applications can use this to show +help for e.g. effects to users. + + + + + + uri of element documentation + + + + + + Elements that bridge to certain other products can include an icon of that +used product. Application can show the icon in menus/selectors to help +identifying specific elements. + + + + + + name of an icon + + + + - + This struct defines the public information about a #GstElement. It contains meta-data about the element that is mostly for the benefit of editors. The @klass member can be used by applications to filter elements based -on functionality."> +on functionality. @@ -4951,167 +5996,284 @@ on functionality."> - + - + The opaque #GstElementFactory data structure. + + Search for an element factory of the given name. Refs the returned +element factory; caller is responsible for unreffing. + #GstElementFactory if found, NULL otherwise + name of factory to find - + Filter out all the elementfactories in @list that can handle @caps in +the given direction. +If @subsetonly is %TRUE, then only the elements whose pads templates +are a complete superset of @caps will be returned. Else any element +whose pad templates caps can intersect with @caps will be returned. +#GstElementFactory elements that match the given requisits. +Use #gst_plugin_feature_list_free after usage. + + a #GList of + + + + + + + a #GList of #GstElementFactory to filter + + + + + + a #GstCaps + + + + a #GstPadDirection to filter on + + + + whether to filter on caps subsets or not. + + + + + + Get a list of factories that match the given @type. Only elements +with a rank greater or equal to @minrank will be returned. +The list of factories is returned by decreasing rank. +#GstElementFactory elements. Use gst_plugin_feature_list_free() after +usage. + + a #GList of + + + + + + + a #GstElementFactoryListType + + + + Minimum rank + + + + + + Create a new element of the type defined by the given element factory. If name is NULL, then the element will receive a guaranteed unique name, consisting of the element factory name and a number. -If name is given, it will be given the name supplied."> +If name is given, it will be given the name supplied. + new #GstElement or NULL if unable to create element + a named factory to instantiate - + + name of new element - + + Checks if the factory can sink the given capability. - + true if it can sink the capabilities + + + + the caps to check + + + - + + Checks if the factory can source the given capability. - + true if it can src the capabilities + + + + the caps to check + + + - + + Create a new element of the type defined by the given elementfactory. +It will be given the name supplied, since all elements require a name as +their first argument. +be created + + new #GstElement or NULL if the element couldn't + + + + + name of new element + + + + + + Gets the author for this factory. + the author + c:identifier="gst_element_factory_get_description"> + Gets the description for this factory. + + the description + + + + + Gets icon name for this factory if set. + + the icon name + + + + + Get the #GType for elements managed by this factory. The type can +only be retrieved if the element factory is loaded, which can be +assured with gst_plugin_feature_load(). +the factory is not loaded. + + the #GType for elements managed by this factory or 0 if + + + + - + + Gets the class for this factory. + the class + + + + + Gets the longname for this factory + + the longname + c:identifier="gst_element_factory_get_num_pad_templates"> + Gets the number of pad_templates in this factory. - + the number of pad_templates + + c:identifier="gst_element_factory_get_static_pad_templates"> + Gets the #GList of #GstStaticPadTemplate for this factory. +static pad templates - - - - - - + the + + + + Gets a NULL-terminated array of protocols this element supports or NULL if no protocols are supported. You may not change the contents of the returned array, as it is still owned by the element factory. Use g_strdupv() to -make a copy of the protocol string array if you need to."> - +make a copy of the protocol string array if you need to. +or NULL + + the supported protocols + + Gets the type of URIs the element supports or #GST_URI_UNKNOWN if none. + + type of URIs this element supports + + + + Check if @factory implements the interface with name @interfacename. - + #TRUE when @factory implement the interface. + + an interface name - - - - - - - - - - - + + Check if @factory if of the given types. - + %TRUE if @factory is of @type. + - - - - - - - - - - - - + + a #GstElementFactoryListType + @@ -5125,23 +6287,30 @@ their first argument."> - + + + - + - + - + + + + + + - - + + @@ -5153,14 +6322,12 @@ their first argument."> - + - + + The standard flags that an element may have. @@ -5168,60 +6335,93 @@ The standard flags that an element may have." + - - - - - - - - - - - - - - - - - - - - - - - - - + A #GstEvent. + + Create a new buffersize event. The event is sent downstream and notifies +elements that they should provide a buffer of the specified dimensions. +When the @async flag is set, a thread boundary is prefered. + + a new #GstEvent + + + + + buffer format + + + + minimum buffer size + + + + maximum buffer size + + + + thread behavior + + + + + + Create a new custom-typed event. This can be used for anything not handled by other event-specific functions to pass an event to another element. Make sure to allocate an event type with the #GST_EVENT_MAKE_TYPE macro, assigning a free number and filling in the correct direction and serialization flags. New custom events can also be created by subclassing the event type if -needed."> +needed. + the new custom event. + The type of the new event - + + the structure for the event. The event will take ownership of the structure. + + Create a new EOS event. The eos event can only travel downstream +synchronized with the buffer flow. Elements that receive the EOS +event on a pad can return #GST_FLOW_UNEXPECTED as a #GstFlowReturn +when data after the EOS event arrives. +The EOS event will travel down to the sink elements in the pipeline +which will then post the #GST_MESSAGE_EOS on the bus after they have +finished playing any buffered data. +When all sinks have posted an EOS message, an EOS message is +forwarded to the application. +The EOS event itself will not cause any state transitions of the pipeline. + + the new EOS event. + + + + Allocate a new flush start event. The flush start event can be sent upstream and downstream and travels out-of-bounds with the dataflow. It marks pads as being flushing and will make them return #GST_FLOW_WRONG_STATE when used for data flow with gst_pad_push(), @@ -5231,158 +6431,156 @@ on a flushing pad will return %FALSE immediately. Elements should unlock any blocking functions and exit their streaming functions as fast as possible when this event is received. This event is typically generated after a seek to flush out all queued data -in the pipeline so that the new media is played as soon as possible."> +in the pipeline so that the new media is played as soon as possible. + a new flush start event. + Allocate a new flush stop event. The flush stop event can be sent upstream and downstream and travels serialized with the dataflow. It is typically sent after sending a FLUSH_START event to make the pads accept data again. Elements can process this event synchronized with the dataflow since the preceeding FLUSH_START event stopped the dataflow. This event is typically generated to complete a seek and to resume -dataflow."> +dataflow. + a new flush stop event. - + + Create a new latency event. The event is sent upstream from the sinks and +notifies elements that they should add an additional @latency to the +running time before synchronising against the clock. +The latency is mostly used in live sinks and is always expressed in +the time format. + a new #GstEvent + + + the new latency value + + + + + + Create a new navigation event from the given description. + + a new #GstEvent + + + + + description of the event. The event will take ownership of the structure. + + + + Allocate a new newsegment event with the given format/values tripplets This method calls gst_event_new_new_segment_full() passing a default -value of 1.0 for applied_rate"> +value of 1.0 for applied_rate + a new newsegment event. - + is this segment an update to a previous one + - + a new rate for playback + + The format of the segment values - + the start value of the segment + - + the stop value of the segment + - + stream position + + Allocate a new newsegment event with the given format/values triplets. The newsegment event marks the range of buffers to be processed. All data not within the segment range is not to be processed. This can be used intelligently by plugins to apply more efficient methods of skipping unneeded data. The valid range is expressed with the @start and @stop values. The position value of the segment is used in conjunction with the start -value to convert the buffer timestamps into the stream time. This is -usually done in sinks to report the current stream_time. -is a valid @stop given, it must be greater or equal the @start, including +value to convert the buffer timestamps into the stream time. This is +usually done in sinks to report the current stream_time. +is a valid @stop given, it must be greater or equal the @start, including when the indicated playback @rate is < 0. The @applied_rate value provides information about any rate adjustment that -has already been made to the timestamps and content on the buffers of the -stream. (@rate * @applied_rate) should always equal the rate that has been -requested for playback. For example, if an element has an input segment -with intended playback @rate of 2.0 and applied_rate of 1.0, it can adjust -incoming timestamps and buffer content by half and output a newsegment event +has already been made to the timestamps and content on the buffers of the +stream. (@rate * @applied_rate) should always equal the rate that has been +requested for playback. For example, if an element has an input segment +with intended playback @rate of 2.0 and applied_rate of 1.0, it can adjust +incoming timestamps and buffer content by half and output a newsegment event with @rate of 1.0 and @applied_rate of 2.0 After a newsegment event, the buffer stream time is calculated with: -position + (TIMESTAMP(buf) - start) * ABS (rate * applied_rate)" - version="0.10.6"> +position + (TIMESTAMP(buf) - start) * ABS (rate * applied_rate) + a new newsegment event. - + Whether this segment is an update to a previous one + - + A new rate for playback + - + The rate factor which has already been applied + + The format of the segment values - + The start value of the segment + - + The stop value of the segment + - + stream position + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Allocate a new qos event with the given values. The QOS event is generated in an element that wants an upstream element to either reduce or increase its rate because of high/low CPU load or other resource usage such as network performance. @@ -5406,25 +6604,28 @@ timestamp <= @timestamp + @diff will certainly arrive late in the sink as well. A (negative) @diff value so that @timestamp + @diff would yield a result smaller than 0 is not allowed. The application can use general event probes to intercept the QoS -event and implement custom application specific QoS handling."> +event and implement custom application specific QoS handling. + a new QOS event. - + the proportion of the qos message + + The time difference of the last Clock sync + The timestamp of the buffer - + Allocate a new seek event with the given parameters. The seek event configures playback of the pipeline between @start to @stop at the speed given in @rate, also called a playback segment. The @start and @stop values are expressed in @format. @@ -5434,79 +6635,75 @@ rate is not allowed and should be accomplished instead by PAUSING the pipeline. A pipeline has a default playback segment configured with a start position of 0, a stop position of -1 and a rate of 1.0. The currently -configured playback segment can be queried with #GST_QUERY_SEGMENT. +configured playback segment can be queried with #GST_QUERY_SEGMENT. start and stop fields in playback segment. Adjustments can be made relative or absolute to the last configured values. A type of #GST_SEEK_TYPE_NONE means that the position should not be updated. When the rate is positive and @start has been updated, playback will start -from the newly configured start position. +from the newly configured start position. For negative rates, playback will start from the newly configured stop position (if any). If the stop position if updated, it must be different from -1 for negative rates. It is not possible to seek relative to the current playback position, to do this, PAUSE the pipeline, query the current playback position with #GST_QUERY_POSITION and update the playback segment current position with a -#GST_SEEK_TYPE_SET to the desired position."> +#GST_SEEK_TYPE_SET to the desired position. + a new seek event. - + The new playback rate + + The format of the seek values + The optional seek flags + The type and flags for the new start position - + The value of the new start position + + The type and flags for the new stop position - + The value of the new stop position + - + + Create a new sink-message event. The purpose of the sink-message event is +to instruct a sink to post the message contained in the event synchronized +with the stream. + a new #GstEvent - - - - - - - - - - - - + + the #GstMessage to be posted + + Create a new step event. The purpose of the step event is to instruct a sink to skip @amount (expressed in @format) of media. It can be used to implement stepping through the video frame by frame or for doing fast trick modes. A rate of <= 0.0 is not allowed, pause the pipeline or reverse the playback @@ -5514,71 +6711,90 @@ direction of the pipeline to get the same effect. The @flush flag will clear any pending data in the pipeline before starting the step operation. The @intermediate flag instructs the pipeline that this step operation is -part of a larger step operation." - version="0.10.24"> +part of a larger step operation. + a new #GstEvent + the format of @amount - + the amount of data to step + - + the step rate + - + flushing steps + - + intermediate steps + - + + Generates a metadata tag event from the given @taglist. + a new #GstEvent - - + + metadata list. The event will take ownership of @taglist. + - + + Gets the #GstEventTypeFlags associated with @type. - - - - - - + a #GstEventTypeFlags. + - - + + a #GstEventType + - + + + Get a printable name for the given event type. Do not modify or free. + + a reference to the static name of the event. + + + + + the event type + + + + + + Get the unique quark for the given event type. + + the quark associated with the event type + + + + + the event type + + + + + Retrieve the sequence number of a event. Events have ever-incrementing sequence numbers, which may also be set explicitly via gst_event_set_seqnum(). Sequence numbers are typically used to indicate that a event corresponds to some other set of events or messages, @@ -5588,260 +6804,438 @@ required. Note that events and messages share the same sequence number incrementor; two events or messages will never not have the same sequence number unless that correspondence was made explicitly. -MT safe." - version="0.10.22"> +MT safe. - + The event's sequence number. + - + + Access the structure of the event. +owned by the event, which means that you should not free it and +that the pointer becomes invalid when you free the event. +MT safe. + + The structure of the event. The structure is still + + + + + Checks if @event has the given @name. This function is usually used to +check the name of a custom event. + + %TRUE if @name matches the name of the event structure. + + + + + name to check + + + + + + Get the format, minsize, maxsize and async-flag in the buffersize event. - - + + A pointer to store the format in + + + + A pointer to store the minsize in + + + + A pointer to store the maxsize in + + + + A pointer to store the async-flag in + + + + + + Get the latency in the latency event. + + + + + + A pointer to store the latency in. + + Get the update flag, rate, format, start, stop and position in the newsegment event. In general, gst_event_parse_new_segment_full() should be used instead of this, to also retrieve the applied_rate value of the -segment. See gst_event_new_new_segment_full() for a full description -of the newsegment event."> +segment. See gst_event_new_new_segment_full() for a full description +of the newsegment event. - - + + A pointer to the update flag of the segment + - - + + A pointer to the rate of the segment + - + + A pointer to the format of the newsegment values - - + + A pointer to store the start value in + - - + + A pointer to store the stop value in + - - + + A pointer to store the stream time in + + Get the update, rate, applied_rate, format, start, stop and +position in the newsegment event. See gst_event_new_new_segment_full() +for a full description of the newsegment event. - - + + A pointer to the update flag of the segment + - - + + A pointer to the rate of the segment + - + A pointer to the applied_rate of the segment + - + + A pointer to the format of the newsegment values - - + + A pointer to store the start value in + - - + + A pointer to store the stop value in + - - + + A pointer to store the stream time in + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Get the proportion, diff and timestamp in the qos event. See +gst_event_new_qos() for more information about the different QoS values. - + A pointer to store the proportion in + - + + A pointer to store the diff in - + + A pointer to store the timestamp in - + + Parses a seek @event and stores the results in the given result locations. - - + + result location for the rate + - + + result location for the stream format - + + result location for the #GstSeekFlags - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + result location for the #GstSeekType of the start position + + + - + result location for the start postion expressed in @format + + + + result location for the #GstSeekType of the stop position + + + + result location for the stop postion expressed in @format + + Parse the sink-message event. Unref @msg after usage. - + + a pointer to store the #GstMessage in. - - - + + Parse the step event. + + + + + + a pointer to store the format in + + + + a pointer to store the amount in + + + + a pointer to store the rate in + + + + a pointer to store the flush boolean in + + + + a pointer to store the intermediate boolean in + + + + + + Parses a tag @event and stores the results in the given @taglist location. + + + + + + pointer to metadata list + + + + + + Set the sequence number of a event. +This function might be called by the creator of a event to indicate that the +event relates to other events or messages. See gst_event_get_seqnum() for +more information. +MT safe. + + + + + + A sequence number. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + #GstEventType lists the standard event types that can be sent in a pipeline. The custom event types can be used for private messages between elements -that can't be expressed using normal +that can't be expressed using normal GStreamer buffer passing semantics. Custom events carry an arbitrary #GstStructure. -Specific custom events are distinguished by the name of the structure." - c:type="GstEventType"> +Specific custom events are distinguished by the name of the structure. - + #GstEventTypeFlags indicate the aspects of the different #GstEventType values. You can get the type flags of a #GstEventType with the -gst_event_type_get_flags() function." - c:type="GstEventTypeFlags"> +gst_event_type_get_flags() function. @@ -5900,27 +7292,29 @@ gst_event_type_get_flags() function." c:identifier="GST_EVENT_TYPE_SERIALIZED"/> - + - + Function prototype for a filter callback that can be use in gst_filter_run(). The function should apply its filtering to @obj. Additional data passed to -gst_filter_run() are in @data."> +gst_filter_run() are in @data. - + %TRUE for success. + - + the object + - + filter data + - + sent yet) (unused/unimplemented). this error should post an error message with more details. this (and higher) to define custom success @@ -5933,8 +7327,7 @@ custom error code to this to avoid compiler warnings). Since 0.10.29. The result of passing data to a pad. Note that the custom return values should not be exposed outside of the -element scope and are available since 0.10.7." - c:type="GstFlowReturn"> +element scope and are available since 0.10.7. @@ -5968,14 +7361,8 @@ element scope and are available since 0.10.7." value="-102" c:identifier="GST_FLOW_CUSTOM_ERROR_2"/> - + + Standard predefined formats @@ -5983,9 +7370,8 @@ Standard predefined formats" - + + A format definition @@ -5999,126 +7385,136 @@ Standard predefined formats" - - - Opaque #GstGhostPad structure. + + Create a new ghostpad with @target as the target. The direction will be taken from the target pad. @target must be unlinked. -Will ref the target."> +Will ref the target. - + a new #GstPad, or NULL in case of an error. + - + + the name of the new pad, or NULL to assign a default name + the pad to ghost. - - - - - - - - - - - - - + Create a new ghostpad with @target as the target. The direction will be taken +from the target pad. The template used on the ghostpad will be @template. +Will ref the target. - + a new #GstPad, or NULL in case of an error. + - + + the name of the new pad, or NULL to assign a default name. + the pad to ghost. + the #GstPadTemplate to use on the ghostpad. + + Create a new ghostpad without a target with the given direction. +A target can be set on the ghostpad later with the +gst_ghost_pad_set_target() function. +The created ghostpad will not have a padtemplate. + + a new #GstPad, or NULL in case of an error. + + + + + the name of the new pad, or NULL to assign a default name. + + + + the direction of the ghostpad + + + + + Create a new ghostpad based on @templ, without setting a target. The +direction will be taken from the @templ. - + a new #GstPad, or NULL in case of an error. + - + + the name of the new pad, or NULL to assign a default name + the #GstPadTemplate to create the ghostpad from. - - - - - - - - - - - - - - - + Finish initialization of a newly allocated ghost pad. This function is most useful in language bindings and when subclassing #GstGhostPad; plugin and application developers normally will not call this function. Call this function directly after a call to g_object_new -(GST_TYPE_GHOST_PAD, "direction", @dir, ..., NULL)." - version="0.10.22"> +(GST_TYPE_GHOST_PAD, "direction", @dir, ..., NULL). - + %TRUE if the construction succeeds, %FALSE otherwise. + + + Get the target pad of @gpad. Unref target pad after usage. +has no target set. Unref target pad after usage. + + the target #GstPad, can be NULL if the ghostpad + + + + + Set the new target of the ghostpad @gpad. Any existing target +is unlinked and links to the new target are established. if @newtarget is +NULL the target will be cleared. +can return FALSE when the internal pads could not be linked. + + TRUE if the new target could be set. This function + + + + + the new pad target + + + + @@ -6134,43 +7530,32 @@ function. Call this function directly after a call to g_object_new - + - + - + + glib:get-type="gst_implements_interface_get_type"> + Opaque #GstImplementsInterface structure. - - - - - - - - - - - + c:type="GstImplementsInterfaceClass"> + - + - + @@ -6183,51 +7568,27 @@ function. Call this function directly after a call to g_object_new - + - + - + Opaque #GstIndex structure. + + Create a new tileindex object + a new index object - - - - - - - - - - - - - - - - - - - - - - - @@ -6238,13 +7599,27 @@ function. Call this function directly after a call to g_object_new - + + Tell the index that the writer with the given id is done +with this index and is not going to write any more entries +to it. + + + + + + the writer that commited the index + + + + + - + @@ -6256,244 +7631,62 @@ function. Call this function directly after a call to g_object_new - + - + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Before entries can be added to the index, a writer should obtain a unique id. The methods to add new entries to the index require this id as an argument. The application can implement a custom function to map the writer object to a string. That string will be used to register or look up an id -in the index."> +in the index. - + TRUE if the writer would be mapped to an id. + - - + + - - + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Associate given format/value pairs with each other. Be sure to pass gint64 values to this functions varargs, -you might want to use a gint64 cast to be sure."> +you might want to use a gint64 cast to be sure. + a pointer to the newly added entry in the index. - + the id of the index writer + + optinal flags for this entry + the format of the value - + the value + @@ -6501,117 +7694,362 @@ you might want to use a gint64 cast to be sure."> - + + Associate given format/value pairs with each other. + a pointer to the newly added entry in the index. - + the id of the index writer + - + + optinal flags for this entry + + + + number of associations + + + + list of associations + + + + + + Adds a format entry into the index. This function is +used to map dynamic GstFormat ids to their original +format key. + + a pointer to the newly added entry in the index. + + + + + the id of the index writer + + + + the format to add to the index + + + + + + Add an id entry into the index. + + a pointer to the newly added entry in the index. + + + + + the id of the index writer + + + + the description of the index writer + + + + + + Add the given object to the index with the given key. +This function is not yet implemented. + + a pointer to the newly added entry in the index. + + + + + the id of the index writer + + + + a key for the object + the GType of the object - + a pointer to the object to add + - + + Tell the index that the writer with the given id is done +with this index and is not going to write any more entries +to it. + + + + + + the writer that commited the index + + + + + + Finds the given format/value in the index +value was not found. + the entry associated with the value or NULL if the - - - - - - - - - - - - - - + the id of the index writer + + The lookup method to use + Flags for the entry + the format of the value - + the value to find + + Finds the given format/value in the index with the given compare function and user_data. -value was not found."> +value was not found. + the entry associated with the value or NULL if the - + the id of the index writer + + The lookup method to use + Flags for the entry + the format of the value - + the value to find + - + + the function used to compare entries - + user data passed to the compare function + - - + + Get the certainty of the given index. + + the certainty of the index. + + + + + Get the id of the current group. + + the id of the current group. + + + + + Before entries can be added to the index, a writer +should obtain a unique id. The methods to add new entries +to the index require this id as an argument. +The application can implement a custom function to map the writer object +to a string. That string will be used to register or look up an id +in the index. + + TRUE if the writer would be mapped to an id. + + + + + the GstObject to allocate an id for + + + + a pointer to a gint to hold the id + + + + + + Create a new group for the given index. It will be +set as the current group. + + the id of the newly created group. + + + + + Set the certainty of the given index. + + + + + + the certainty to set + + + + + + Lets the app register a custom filter function so that +it can select what entries should be stored in the index. + + + + + + the filter to register + + + + data passed to the filter function + + + + + + Lets the app register a custom filter function so that +it can select what entries should be stored in the index. + + + + + + the filter to register + + + + data passed to the filter function + + + + function to call when @user_data is unset + + + + + + Set the current groupnumber to the given argument. +did not exist. + + TRUE if the operation succeeded, FALSE if the group + + + + + the groupnumber to set + + + + + + Lets the app register a custom function to map index +ids to writer descriptions. + + + + + + the resolver to register + + + + data passed to the resolver function + + + + + + Lets the app register a custom function to map index +ids to writer descriptions. + + + + + + the resolver to register + + + + data passed to the resolver function + + + + destroy function for @user_data + + + + + + - + + + - + @@ -6620,55 +8058,56 @@ value was not found."> - + - + - + + + + - + - + - - + + - + - + + An association in an entry. - + - + + The certainty of a group in the index. @@ -6680,27 +8119,26 @@ value was not found."> - + - + TRUE if the writer would be mapped to an id. + - - + + - + - + @@ -6709,13 +8147,14 @@ value was not found."> - + the writer that commited the index + - + @@ -6729,8 +8168,8 @@ value was not found."> - - + + @@ -6739,7 +8178,7 @@ value was not found."> - + @@ -6751,19 +8190,19 @@ value was not found."> - + - + - + - + @@ -6779,20 +8218,21 @@ value was not found."> - + + glib:get-type="gst_index_entry_get_type" + c:symbol-prefix="index_entry"> + The basic element of an index. - + @@ -6802,7 +8242,7 @@ value was not found."> - + @@ -6819,7 +8259,7 @@ value was not found."> - + @@ -6831,40 +8271,40 @@ value was not found."> - + + Gets alternative formats associated with the indexentry. +format. + + TRUE if there was a value associated with the given + + + + + the format of the value the find + + + + a pointer to store the value + + + + + + Copies an entry and returns the result. + a newly allocated #GstIndexEntry. - + + Free the memory used by the given entry. - - - - - - - - - - - - - - + + The different types of entries in the index. - + The GstIndexFactory object + + Create a new indexfactory with the given parameters + a new #GstIndexFactory. + name of indexfactory to create + long description of indexfactory to create + the GType of the GstIndex element of this factory - + + Search for an indexfactory of the given name. + #GstIndexFactory if found, NULL otherwise + name of indexfactory to find - + + Create a new #GstIndex instance from the +indexfactory with the given name. + a new #GstIndex instance. + the name of the factory used to create the instance - - - + + Create a new #GstIndex instance from the +given indexfactory. + + a new #GstIndex instance. + - - - + + Removes the index from the global list. + + @@ -6948,7 +8393,7 @@ given indexfactory."> - + @@ -6960,98 +8405,99 @@ given indexfactory."> - + - + + Function to filter out entries in the index. +to the index, %FALSE otherwise. - + This function should return %TRUE if the entry is to be added + + The index being queried + The entry to be added. - + User data passed to the function. + - + + Flags for this index - + + A group of related entries in an index. - + - + + + - + - + + Specify the method to find an index entry in the index. - + + Function to resolve ids to writer descriptions. - + %TRUE if an id could be assigned to the writer. + + the index being queried. + The object that wants to write - - - + A description of the writer. + - + user_data as registered + - + + The method used to resolve index writers - + + #GstIterator base structure. The values of this structure are +protected for subclasses, use the methods to use the #GstIterator. @@ -7075,219 +8521,67 @@ protected for subclasses, use the methods to use the #GstIterator."> - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Create a new iterator from an existing iterator. The new iterator will only return those elements that match the given compare function @func. in the iterator. When this iterator is freed, @it will also be freed. -MT safe."> - +MT safe. + + a new #GstIterator. - + + the compare function to select elements - + user data passed to the compare function + - + Find the first element in @it that matches the compare function @func. +the refcount of a refcounted object will be increased before @func is +called, and should be unrefed after use in @func unless it is the matching +element. +The iterator will not be freed. +This function will return NULL if an error happened to the iterator. +function or NULL when no element matched. +MT safe. + + The element in the iterator that matches the compare + + + + + the compare function to use + + + + user data passed to the compare function + + + + + + Folds @func over the elements of @iter. That is to say, @func will be called as @func (object, @ret, @user_data) for each object in @it. The normal use of this procedure is to accumulate the results of operating on the objects in before @func is called, and it should be unrefed after use in @func. @@ -7299,200 +8593,245 @@ the fold will stop, and %GST_ITERATOR_OK will be returned. Errors or resyncs will cause fold to return %GST_ITERATOR_ERROR or %GST_ITERATOR_RESYNC as appropriate. The iterator will not be freed. -MT safe."> - +MT safe. + + A #GstIteratorResult, as described above. - + + the fold function + the seed value passed to the fold function - + user data passed to the fold function + + Iterate over all element of @it and call the given function @func for +each element. As in gst_iterator_fold(), the refcount of a refcounted object will be increased before @func is called, and should be unrefed after use. freed. -MT safe."> - +MT safe. + + the result call to gst_iterator_fold(). The iterator will not be - + + the function to call for each element. - + user data passed to the function + - + + Free the iterator. +MT safe. - + + + + + Get the next item from the iterator in @elem. +Only when this function returns %GST_ITERATOR_OK, @elem will contain a valid +value. For iterators that return refcounted objects, the returned object +will have its refcount increased and should therefore be unreffed after +usage. +When this function returns %GST_ITERATOR_DONE, no more elements can be +retrieved from @it. +A return value of %GST_ITERATOR_RESYNC indicates that the element list was +concurrently updated. The user of @it should call gst_iterator_resync() to +get the newly updated list. +A return value of %GST_ITERATOR_ERROR indicates an unrecoverable fatal error. +is a refcounted object. +MT safe. + + The result of the iteration. Unref @elem after usage if this + - - - - - + + pointer to hold next element + + + Pushes @other iterator onto @it. All calls performed on @it are +forwarded to @other. If @other returns %GST_ITERATOR_DONE, it is +popped again and calls are handled by @it again. +This function is mainly used by objects implementing the iterator +next function to recurse into substructures. +When gst_iterator_resync() is called on @it, @other will automatically be +popped. +MT safe. + + + + + + The #GstIterator to push + + + + + + Resync the iterator. this function is mostly called +after gst_iterator_next() returned %GST_ITERATOR_RESYNC. +When an iterator was pushed on @it, it will automatically be popped again +with this function. +MT safe. + + + + + c:type="GstIteratorDisposeFunction"> + The function that will be called when a #GList iterator is freed. The +owner of the #GList iterator can then clean up its resources. - + the owner of the iterator + - + + A function to be passed to gst_iterator_fold(). - + TRUE if the fold should continue, FALSE if it should stop. + - + the item to fold + + a #GValue collecting the result - + data passed to gst_iterator_fold() + - + This function will be called when the iterator is freed. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. -The function will be called with the iterator lock held."> +The function will be called with the iterator lock held. + the iterator - + + The result of a #GstIteratorItemFunction. - + The function that will be called after the next item of the iterator has been retrieved. This function will typically increase the refcount of the item or make a copy. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. -The function will be called with the iterator lock held."> - +The function will be called with the iterator lock held. + + the result of the operation. + the iterator - + the item being retrieved. + - + The function that will be called when the next element of the iterator +should be retrieved. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. -The function will be called with the iterator lock held."> - +The function will be called with the iterator lock held. + + the result of the operation. + the iterator - + a pointer to hold the next item + - + + The result of gst_iterator_next(). - + This function will be called whenever a concurrent update happened to the iterated datastructure. The implementor of the iterator should restart the iterator from the beginning and clean up any state it might have. Implementors of a #GstIterator should implement this function and pass it to the constructor of the custom iterator. -The function will be called with the iterator lock held."> +The function will be called with the iterator lock held. + the iterator - + + Library errors are for errors from the library being used by elements +(initializing, finalizing, settings, ...) - + Function prototype for a logging function that can be registered with gst_debug_add_log_function(). -Use G_GNUC_NO_INSTRUMENT on that function."> +Use G_GNUC_NO_INSTRUMENT on that function. + a #GstDebugCategory + a #GstDebugLevel + file name + function name - + line number + + a #GObject + the message - + user data for the log function + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + A #GstMessage. + Create a new application-typed message. GStreamer will never create these messages; they are a gift from us to you. Enjoy. -MT safe."> +MT safe. + The new application message. + the object originating the message. - + + the structure for the message. The message will take ownership of the structure. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + The message is posted when elements completed an ASYNC state change. +MT safe. + The new async_done message. + The object originating the message. + This message is posted by elements when they start an ASYNC state change. +PLAYING. +MT safe. + The new async_start message. + The object originating the message. - + if a new base_time should be set on the element + - + + Create a new buffering message. This message can be posted by an element that +needs to buffer data before it can continue processing. @percent should be a +value between 0 and 100. A value of 100 means that the buffering completed. +When @percent is < 100 the application should PAUSE a PLAYING pipeline. When +The application must be prepared to receive BUFFERING messages in the +PREROLLING state and may only set the pipeline to PLAYING after receiving a +message with @percent set to 100, which can happen after the pipeline +completed prerolling. +MT safe. + The new buffering message. + The object originating the message. + + The buffering percent + + - + + Create a clock lost message. This message is posted whenever the +clock is not valid anymore. +If this message is posted by the pipeline, the pipeline will +select a new clock again when it goes to PLAYING. It might therefore +be needed to set the pipeline to PAUSED and PLAYING again. +MT safe. + The new clock lost message. + the object originating the message. + + the clock that was lost + + + + + + Create a clock provide message. This message is posted whenever an +element is ready to provide a clock or lost its ability to provide +a clock (maybe because it paused or became EOS). +This message is mainly used internally to manage the clock +selection. +MT safe. + + the new provide clock message. + + + + + the object originating the message. + + + + the clock it provides + + + + TRUE if the sender can provide a clock + + + + + + Create a new custom-typed message. This can be used for anything not +handled by other message-specific functions to pass a message to the +app. The structure field can be NULL. +MT safe. + + The new message. + + + - + The #GstMessageType to distinguish messages + - - + + The object originating the message. + - - + + the structure for the message. The message will take ownership of the structure. + - + + Create a new duration message. This message is posted by elements that +know the duration of a stream in a specific format. This message +is received by bins and is used to calculate the total duration of a +pipeline. Elements may post a duration message with a duration of +GST_CLOCK_TIME_NONE to indicate that the duration has changed and the +cached duration should be discarded. The new duration can then be +retrieved via a query. +MT safe. + The new duration message. + The object originating the message. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The format of the duration - - + + The new duration + - - + + + + Create a new element-specific message. This is meant as a generic way of +allowing one-way communication from an element to an application, for example +"the firewire cable was unplugged". The format of the message should be +documented in the element's documentation. The structure field can be NULL. +MT safe. + + The new element message. + + + + + The object originating the message. + - - + + The structure for the message. The message will take ownership of the structure. + - - + + + + Create a new eos message. This message is generated and posted in +the sink elements of a GstBin. The bin will only forward the EOS +message to the application if all sinks have posted an EOS message. +MT safe. + + The new eos message. + + + + + The object originating the message. + + + + + + Create a new error message. The message will copy @error and +occured. The pipeline will probably (partially) stop. The application +receiving this message should stop the pipeline. +MT safe. + + the new error message. + + + + + The object originating the message. + + + + The GError for this message. + + + + A debugging string. + + + + + + Create a new info message. The message will make copies of @error and +MT safe. + + the new info message. + + + + + The object originating the message. + + + + The GError for this message. + + + + A debugging string. + + + + + + This message can be posted by elements when their latency requirements have +changed. +MT safe. + + The new latency message. + + + + + The object originating the message. + + + + + + Create a new clock message. This message is posted whenever the +pipeline selectes a new clock for the pipeline. +MT safe. + + The new new clock message. + + + + + The object originating the message. + + + + the new selected clock + + A QOS message is posted on the bus whenever an element decides to drop a buffer because of QoS reasons or whenever it changes its processing strategy because of QoS reasons (quality adjustments such as processing at lower accuracy). @@ -8126,57 +9226,398 @@ events received from a downstream element (!live). respective running-time, stream-time, timestamp and duration of the (dropped) buffer that generated the QoS event. Values can be left to GST_CLOCK_TIME_NONE when unknown. -MT safe." - version="0.10.29"> +MT safe. + The new qos message. + The object originating the message. - + if the message was generated by a live element + - + the running time of the buffer that generated the message + - + the stream time of the buffer that generated the message + - + the timestamps of the buffer that generated the message + - + the duration of the buffer that generated the message + - + + This message can be posted by elements when they want to have their state +changed. A typical use case would be an audio server that wants to pause the +pipeline because a higher priority stream is being played. +MT safe. + the new requst state message. - - - + the object originating the message. - - + + The new requested state + + + Create a new segment done message. This message is posted by elements that +finish playback of a segment as a result of a segment seek. This message +is received by the application after all elements that posted a segment_start +have posted the segment_done. +MT safe. + + the new segment done message. + + + + + the object originating the message. + + + + The format of the position being done + + + + The position of the segment being done + + + + + + Create a new segment message. This message is posted by elements that +start playback of a segment as a result of a segment seek. This message +is not received by the application but is used for maintenance reasons in +container elements. +MT safe. + + the new segment start message. + + + + + The object originating the message. + + + + The format of the position being played + + + + The position of the segment being played + + + + + + Create a state change message. This message is posted whenever an element +changed its state. +MT safe. + + the new state change message. + + + + + the object originating the message + + + + the previous state + + + + the new (current) state + + + + the pending (target) state + + + + + + Create a state dirty message. This message is posted whenever an element +changed its state asynchronously and is used internally to update the +states of container objects. +MT safe. + + the new state dirty message. + + + + + the object originating the message + + + + + + This message is posted by elements when they complete a part, when @intermediate set +to TRUE, or a complete step operation. +MT safe. + + the new step_done message. + + + + + The object originating the message. + + + + the format of @amount + + + + the amount of stepped data + + + + the rate of the stepped amount + + + + is this an flushing step + + + + is this an intermediate step + + + + the duration of the data + + + + the step caused EOS + + + + + + This message is posted by elements when they accept or activate a new step +event for @amount in @format. +queued it for execution in the streaming threads. +is now ready to start executing the step in the streaming thread. After this +message is emited, the application can queue a new step operation in the +element. +MT safe. + + The new step_start message. + + + + + The object originating the message. + + + + if the step is active or queued + + + + the format of @amount + + + + the amount of stepped data + + + + the rate of the stepped amount + + + + is this an flushing step + + + + is this an intermediate step + + + + + + Create a new stream status message. This message is posted when a streaming +thread is created/destroyed or when the state changed. +MT safe. + + the new stream status message. + + + + + The object originating the message. + + + + The stream status type. + + + + the owner element of @src. + + + + + + Create a new structure change message. This message is posted when the +structure of a pipeline is in the process of being changed, for example +when pads are linked or unlinked. +MT safe. + + the new structure change message. + + + + + The object originating the message. + + + + The change type. + + + + The owner element of @src. + + + + Whether the structure change is busy. + + + + + + Create a new tag message. The message will take ownership of the tag list. +The message is posted by elements that discovered a new taglist. +MT safe. + + the new tag message. + + + + + The object originating the message. + + + + the tag list for the message. + + + + + + Create a new tag message. The message will take ownership of the tag list. +The message is posted by elements that discovered a new taglist. +MT safe. + + the new tag message. + + + + + the object originating the message. + + + + the originating pad for the tag. + + + + the tag list for the message. + + + + + + Create a new warning message. The message will make copies of @error and +MT safe. + + The new warning message. + + + + + The object originating the message. + + + + The GError for this message. + + + + A debugging string. + + + + + + Get a printable name for the given message type. Do not modify or free. + + a reference to the static name of the message. + + + + + the message type + + + + + + Get the unique quark for the given message type. + + the quark associated with the message type + + + + + the message type + + + + + Retrieve the sequence number of a message. Messages have ever-incrementing sequence numbers, which may also be set explicitly via gst_message_set_seqnum(). Sequence numbers are typically used to indicate that a message corresponds to some other set of messages or @@ -8186,32 +9627,187 @@ it is not required. Note that events and messages share the same sequence number incrementor; two events or messages will never not have the same sequence number unless that correspondence was made explicitly. -MT safe." - version="0.10.22"> +MT safe. - + The message's sequence number. + - + + Extracts the object managing the streaming thread from @message. +This object is usually of type GstTask but other types can be added in the +future. The object remains valid as long as @message is valid. + + a GValue containing the object that manages the streaming thread. + + + + + Access the structure of the message. +still owned by the message, which means that you should not free it and +that the pointer becomes invalid when you free the message. +MT safe. + + The structure of the message. The structure is + + + + + Extract the new_base_time from the async_start message. +MT safe. - - + + Result location for the new_base_time or NULL + - + Extracts the buffering percent from the GstMessage. see also +gst_message_new_buffering(). +MT safe. + + + + + + Return location for the percent. + + + + + + Extracts the buffering stats values from @message. + + + + + + a buffering mode, or NULL + + + + the average input rate, or NULL + + + + the average output rate, or NULL + + + + amount of buffering time left in milliseconds, or NULL + + + + + + Extracts the lost clock from the GstMessage. +The clock object returned remains valid until the message is freed. +MT safe. + + + + + + a pointer to hold the lost clock + + + + + + Extracts the clock and ready flag from the GstMessage. +The clock object returned remains valid until the message is freed. +MT safe. + + + + + + a pointer to hold a clock object, or NULL + + + + a pointer to hold the ready flag, or NULL + + + + + + Extracts the duration and format from the duration message. The duration +might be GST_CLOCK_TIME_NONE, which indicates that the duration has +changed. Applications should always use a query to retrieve the duration +of a pipeline. +MT safe. + + + + + + Result location for the format, or NULL + + + + Result location for the duration, or NULL + + + + + + Extracts the GError and debug string from the GstMessage. The values returned in the output arguments are copies; the caller must free them when done. Typical usage of this function might be: |[ @@ -8229,178 +9825,279 @@ break; } ... ]| -MT safe."> +MT safe. - + + location for the GError - - - - - - - - - - - - - - - - - - - + + location for the debug message, or NULL + + Extracts the GError and debug string from the GstMessage. The values returned +in the output arguments are copies; the caller must free them when done. +MT safe. - + + location for the GError - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + location for the debug message, or NULL + + + + + + Extracts the new clock from the GstMessage. +The clock object returned remains valid until the message is freed. +MT safe. + + + + + + a pointer to hold the selected new clock + + + + + + Extract the timestamps and live status from the QoS message. +The returned values give the running_time, stream_time, timestamp and +duration of the dropped buffer. Values of GST_CLOCK_TIME_NONE mean unknown +values. +MT safe. + + + + + + if the message was generated by a live element + + + + the running time of the buffer that generated the message + + + + the stream time of the buffer that generated the message + + + + the timestamps of the buffer that generated the message + + + + the duration of the buffer that generated the message + + + + + + Extract the QoS stats representing the history of the current continuous +pipeline playback period. +When @format is @GST_FORMAT_UNDEFINED both @dropped and @processed are +invalid. Values of -1 for either @processed or @dropped mean unknown values. +MT safe. + + + + + + Units of the 'processed' and 'dropped' fields. Video sinks and video filters will use GST_FORMAT_BUFFERS (frames). Audio sinks and audio filters will likely use GST_FORMAT_DEFAULT (samples). + + + + Total number of units correctly processed since the last state change to READY or a flushing operation. + + + + Total number of units dropped since the last state change to READY or a flushing operation. + + + + + + Extract the QoS values that have been calculated/analysed from the QoS data +MT safe. + + + + + + The difference of the running-time against the deadline. + + + + Long term prediction of the ideal rate relative to normal rate to get optimal quality. + + + + An element dependent integer value that specifies the current quality level of the element. The default maximum quality is 1000000. + + + + + + Extract the requested state from the request_state message. +MT safe. + + + + + + Result location for the requested state or NULL + + + + + + Extracts the position and format from the segment start message. +MT safe. + + + + + + Result location for the format, or NULL + + + - + Result location for the position, or NULL + + + + + + Extracts the position and format from the segment start message. +MT safe. + + + + + + Result location for the format, or NULL + + + + Result location for the position, or NULL + + Extracts the old and new states from the GstMessage. Typical usage of this function might be: |[ ... switch (GST_MESSAGE_TYPE (msg)) { GstState old_state, new_state; gst_message_parse_state_changed (msg, &amp;old_state, &amp;new_state, NULL); -g_print ("Element %s changed state from %s to %s.\n", +g_print ("Element %s changed state from %s to %s.\n", GST_OBJECT_NAME (msg->src), gst_element_state_get_name (old_state), gst_element_state_get_name (new_state)); @@ -8410,469 +10107,464 @@ break; } ... ]| -MT safe."> +MT safe. - + + the previous state, or NULL + allow-none="1"> + the new (current) state, or NULL + allow-none="1"> + the pending (target) state, or NULL + Extract the values the step_done message. +MT safe. - + + result location for the format - - + + result location for the amount + - - + + result location for the rate + - - + + result location for the flush flag + - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + result location for the intermediate flag + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + result location for the duration + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + result location for the EOS flag + + Extract the values from step_start message. +MT safe. - - + + result location for the active flag + - + + result location for the format - - + + result location for the amount + - - + + result location for the rate + - - + + result location for the flush flag + - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + result location for the intermediate flag + - + + Extracts the stream status type and owner the GstMessage. The returned +owner remains valid for as long as the reference to @message is valid and +should thus not be unreffed. +MT safe. - - + + A pointer to hold the status type + - - + + The owner element of the message source + - - + + + + Extracts the change type and completion status from the GstMessage. +MT safe. + + + + + + A pointer to hold the change type + + + + The owner element of the message source + + + + a pointer to hold whether the change is in progress or has been completed + + + + + + Extracts the tag list from the GstMessage. The tag list returned in the +output argument is a copy; the caller must free it when done. +Typical usage of this function might be: +|[ +... +switch (GST_MESSAGE_TYPE (msg)) { +GstTagList *tags = NULL; +gst_message_parse_tag (msg, &amp;tags); +g_print ("Got tags from element %s\n", GST_OBJECT_NAME (msg->src)); +handle_tags (tags); +gst_tag_list_free (tags); +break; +} +... +} +... +]| +MT safe. + + + + + + return location for the tag-list. + + + + + + Extracts the tag list from the GstMessage. The tag list returned in the +output argument is a copy; the caller must free it when done. +MT safe. + + + + + + location where the originating pad is stored, unref after usage + + + + return location for the tag-list. + + + + + + Extracts the GError and debug string from the GstMessage. The values returned +in the output arguments are copies; the caller must free them when done. +MT safe. + + + + + + location for the GError + + + + location for the debug message, or NULL + + + + + + Configures the buffering stats values in @message. + + + + + + a buffering mode + + + + the average input rate + + + + the average output rate + + + + amount of buffering time left in milliseconds + + Set the QoS stats representing the history of the current continuous pipeline playback period. When @format is @GST_FORMAT_UNDEFINED both @dropped and @processed are invalid. Values of -1 for either @processed or @dropped mean unknown values. -MT safe." - version="0.10.29"> +MT safe. + Units of the 'processed' and 'dropped' fields. Video sinks and video filters will use GST_FORMAT_BUFFERS (frames). Audio sinks and audio filters will likely use GST_FORMAT_DEFAULT (samples). - + Total number of units correctly processed since the last state change to READY or a flushing operation. + - + Total number of units dropped since the last state change to READY or a flushing operation. + - + Set the QoS values that have been calculated/analysed from the QoS data +MT safe. - - + + The difference of the running-time against the deadline. + - - + + Long term prediction of the ideal rate relative to normal rate to get optimal quality. + - - - - - - - - + + An element dependent integer value that specifies the current quality level of the element. The default maximum quality is 1000000. + - + + Set the sequence number of a message. +This function might be called by the creator of a message to indicate that +the message relates to other messages or events. See gst_message_get_seqnum() +for more information. +MT safe. - - - - - - - - + + A sequence number. + - + + Configures the object handling the streaming thread. This is usually a +GstTask object but other objects might be added in the future. - - - - - - - - + + the object controlling the streaming + - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + - + - + + The different message types that are available. @@ -8937,488 +10629,550 @@ The different message types that are available." - - - - - - - - - - - - - - + + Base class for refcounted lightweight objects. + + Creates a new mini-object of the desired type. +MT safe + the new mini-object. + the #GType of the mini-object to create - + + Modifies a pointer to point to a new mini-object. The modification +is done atomically, and the reference counts are updated correctly. +Either @newdata and the value pointed to by @olddata may be NULL. + + + + + + pointer to a pointer to a mini-object to be replaced + + + + pointer to new mini-object + + + + + + Creates a copy of the mini-object. +MT safe + the new mini-object. - + Checks if a mini-object is writable. A mini-object is writable if the reference count is one and the #GST_MINI_OBJECT_FLAG_READONLY flag is not set. Modification of a mini-object should only be done after verifying that it is writable. -MT safe"> +MT safe - + TRUE if the object is writable. + + Checks if a mini-object is writable. If not, a writable copy is made and returned. This gives away the reference to the original mini object, and returns a reference to the new object. -MT safe"> - +MT safe +is writable. + + a mini-object (possibly the same pointer) that - + Increase the reference count of the mini-object. Note that the refcount affects the writeability of @mini-object, see gst_mini_object_is_writable(). It is important to note that keeping additional references to GstMiniObject instances can potentially increase the number of memcpy operations in a pipeline, especially if the miniobject -is a #GstBuffer."> - +is a #GstBuffer. + + the mini-object. - + + Decreases the reference count of the mini-object, possibly freeing +the mini-object. - - - - - - - - - - - - - + + + + + + + + + + + + + + + - + - + - - + + - + introspectable="0"> + Virtual function prototype for methods to create copies of instances. + + reference to cloned instance. + MiniObject to copy + Virtual function prototype for methods to free ressources used by mini-objects. Subclasses of the mini object are allowed to revive the passed object by doing a gst_mini_object_ref(). If the object is not revived after the finalize function, the memory associated with the -object is freed."> +object is freed. + MiniObject to finalize - + + Flags for the padtemplate - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + GStreamer base object class. + Checks to see if there is any object named @name in @list. This function does not do any locking of any kind. You might want to protect the provided list with the lock of the owner of the list. This function will lock each #GstObject in the list to compare the name, so be carefull when passing a list with a locked object. FALSE if it does. -MT safe. Grabs and releases the LOCK of each object in the list."> +MT safe. Grabs and releases the LOCK of each object in the list. - + TRUE if a #GstObject named @name does not appear in @list, + - + a list of #GstObject to check through + + + + the name to search for - - - - - - - - - - - + + A default deep_notify signal callback for an object. The user data +should contain a pointer to an array of strings that should be excluded +from the notify. The default handler will print the new value of the property +using g_print. +MT safe. This function grabs and releases @object's LOCK for getting its +path string. - - + + the #GObject that signalled the notify. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GstObject that initiated the notify. + + a #GParamSpec of the property. + + + + (array zero-terminated=1) (element-type gchar*) (allow-none):a set of user-specified properties to exclude or NULL to show all changes. + + - - + + + Increments the reference count on @object. This function +does not take the lock on @object because it relies on +atomic refcounting. +This object returns the input parameter to ease writing +constructs like : +result = gst_object_ref (object->parent); - + A pointer to @object + - - + + + a #GstObject to reference + + + + + + Increase the reference count of @object, and possibly remove the floating +reference, if @object has a floating reference. +In other words, if the object is floating, then this call "assumes ownership" +of the floating reference, converting it to a normal reference by clearing +the floating flag while leaving the reference count unchanged. If the object +is not floating, then this call adds a new normal reference increasing the +reference count by one. +MT safe. This function grabs and releases @object lock. - - - - - - - + + a #GstObject to sink + - - + Unrefs the #GstObject pointed to by @oldobj, refs @newobj and puts @newobj in *@oldobj. Be carefull when calling this function, it does not take any locks. You might want to lock the object owning @oldobj pointer before calling this function. Make sure not to LOCK @oldobj because it might be unreffed -which could cause a deadlock when it is disposed."> +which could cause a deadlock when it is disposed. + + pointer to a place of a #GstObject to replace + + + a new #GstObject - - - - - - - - - + + + If @object was floating, the #GST_OBJECT_FLOATING flag is removed +and @object is unreffed. When @object was not floating, +this function does nothing. +Any newly created object has a refcount of 1 and is floating. +This function should be used when creating a new object to +symbolically 'take ownership' of @object. This done by first doing a +gst_object_ref() to keep a reference to @object and then gst_object_sink() +to remove and unref any floating references to @object. +Use gst_object_set_parent() to have this done for you. +MT safe. This function grabs and releases @object lock. + + - - + + a #GstObject to sink + - - + + + Decrements the reference count on @object. If reference count hits +zero, destroy @object. This function does not take the lock +on @object as it relies on atomic refcounting. +The unref method should never be called with the LOCK held since +this might deadlock the dispose function. + + + + + + a #GstObject to unreference + + + + + + Restores @object with the data from the parent XML node. + The XML node to load @object from - - + + + Saves @object into the parent XML node. + + the new xmlNodePtr with the saved object + + + + + The parent XML node to save @object into + + + + + + A default error function. +The default handler will simply print the error string using g_print. + the GError. - + + an additional debug information string, or NULL - - + + Returns a copy of the name of @object. +Caller should g_free() the return value after usage. +For a nameless object, this returns NULL, which you can safely g_free() +as well. +MT safe. This function grabs and releases @object's LOCK. + + the name of @object. g_free() after usage. + + + + + Returns a copy of the name prefix of @object. +Caller should g_free() the return value after usage. +For a prefixless object, this returns NULL, which you can safely g_free() +as well. +MT safe. This function grabs and releases @object's LOCK. +for anything. + + the name prefix of @object. g_free() after usage. + + + + + Returns the parent of @object. This function increases the refcount +of the parent object so you should gst_object_unref() it after usage. +has no parent. unref after usage. +MT safe. Grabs and releases @object's LOCK. + + parent of @object, this can be NULL if @object + + + + + Generates a string describing the path of @object in +the object hierarchy. Only useful (or used) for debugging. +g_free() the string after usage. +MT safe. Grabs and releases the #GstObject's LOCK for all objects +in the hierarchy. + + a string describing the path of @object. You must + + + + + Check if @object has an ancestor @ancestor somewhere up in +the hierarchy. One can e.g. check if a #GstElement is inside a #GstPipeline. +MT safe. Grabs and releases @object's locks. + + TRUE if @ancestor is an ancestor of @object. + + + + + a #GstObject to check as ancestor + + + + + + Restores @object with the data from the parent XML node. + + + + + + The XML node to load @object from + + + + + + Saves @object into the parent XML node. + + the new xmlNodePtr with the saved object + + + + + The parent XML node to save @object into + + + + + + Sets the name of @object, or gives @object a guaranteed unique +name (if @name is NULL). +This function makes a copy of the provided name, so the caller +retains ownership of the name it sent. +a parent cannot be renamed, this function returns FALSE in those +cases. +MT safe. This function grabs and releases @object's LOCK. + + TRUE if the name could be set. Since Objects that have + + + + + new name of object + + + + + + Sets the name prefix of @object to @name_prefix. +This function makes a copy of the provided name prefix, so the caller +retains ownership of the name prefix it sent. +MT safe. This function grabs and releases @object's LOCK. +for anything. + + + + + + new name prefix of @object + + + + + + Sets the parent of @object to @parent. The object's reference count will +be incremented, and any floating reference will be removed (see gst_object_sink()). +This function causes the parent-set signal to be emitted when the parent +was successfully set. +already had a parent or @object and @parent are the same. +MT safe. Grabs and releases @object's LOCK. + + TRUE if @parent could be set or FALSE when @object + + + + + new parent of object + + + + + + Clear the parent of @object, removing the associated reference. +This function decreases the refcount of @object. +MT safe. Grabs and releases @object's lock. + + + + + + - + @@ -9433,66 +11187,71 @@ The default handler will simply print the error string using g_print."> - + - + - + The deep notify signal is used to be notified of property changes. It is typically attached to the toplevel bin to receive notifications from all -the elements contained in that bin."> - - +the elements contained in that bin. + + - - + + the object that originated the signal + - - + + the property that changed + - - - + + Trigered whenever a new object is saved to XML. You can connect to this +signal to insert custom XML tags into the core XML. + + - - + + the xmlNodePtr of the parent node + - - - + + Emitted when the parent of an object is set. + + - - + + the new parent + - - - + + Emitted when the parent of an object is unset. + + - - + + the old parent + + glib:is-gtype-struct-for="Object"> + GStreamer base object class. @@ -9506,7 +11265,7 @@ signal to insert custom XML tags into the core XML."> - + @@ -9521,7 +11280,7 @@ signal to insert custom XML tags into the core XML."> - + @@ -9536,7 +11295,7 @@ signal to insert custom XML tags into the core XML."> - + @@ -9551,7 +11310,7 @@ signal to insert custom XML tags into the core XML."> - + @@ -9568,9 +11327,10 @@ signal to insert custom XML tags into the core XML."> - - - + + + + the new xmlNodePtr with the saved object @@ -9578,13 +11338,14 @@ signal to insert custom XML tags into the core XML."> + The parent XML node to save @object into - + @@ -9593,6 +11354,7 @@ signal to insert custom XML tags into the core XML."> + The XML node to load @object from @@ -9600,338 +11362,363 @@ signal to insert custom XML tags into the core XML."> - + - + + The standard flags that an gstobject may have. + + + - + - + - + - + - + - The #GstPad structure. Use the functions to update the variables. + + Creates a new pad with the given name in the given direction. If name is NULL, a guaranteed unique name (across all pads) will be assigned. This function makes a copy of the name so you can safely free the name. -MT safe."> +MT safe. + a new #GstPad, or NULL in case of an error. + the name of the new pad. + the #GstPadDirection of the pad. - - - - - - - - - - - - - + Creates a new pad with the given name from the given static template. If name is NULL, a guaranteed unique name (across all pads) will be assigned. -This function makes a copy of the name so you can safely free the name."> +This function makes a copy of the name so you can safely free the name. + a new #GstPad, or NULL in case of an error. + the #GstStaticPadTemplate to use + the name of the element - + + Creates a new pad with the given name from the given template. +If name is NULL, a guaranteed unique name (across all pads) +will be assigned. +This function makes a copy of the name so you can safely free the name. + + a new #GstPad, or NULL in case of an error. + + + + + the pad template to use + + + + the name of the element + + + + + + Reads the pad definition from the XML node and links the given pad +in the element to a pad of an element up in the hierarchy. + an #xmlNodePtr to read the description from. + the #GstObject element that owns the pad. - - - - - - + + Check if the given pad accepts the caps. - + TRUE if the pad can accept the caps. + - - + + a #GstCaps to check on the pad + - - - - - - + Activates or deactivates the given pad in pull mode via dispatching to the +pad's activatepullfunc. For use from within pad activation functions only. When called on sink pads, will first proxy the call to the peer pad, which is expected to activate its internally linked pads from within its activate_pull function. -If you don't know what this is, you probably don't want to call it. -MT safe."> +If you don't know what this is, you probably don't want to call it. +MT safe. - + TRUE if the operation was successful. + - + whether or not the pad should be active. + - + + Activates or deactivates the given pad in push mode via dispatching to the +pad's activatepushfunc. For use from within pad activation functions only. +If you don't know what this is, you probably don't want to call it. +MT safe. - + %TRUE if the operation was successful. + - + whether the pad should be active or not. + - + + Adds a probe that will be called for all buffers passing through a pad. See +gst_pad_add_data_probe() for more information. - + The handler id + - - + + function to call when buffers are passed over pad + + + + data to pass along with the handler + - + + Adds a probe that will be called for all buffers passing through a pad. See +gst_pad_add_data_probe() for more information. +The @notify function is called when the probe is disconnected and usually +used to free @data. - + The handler id + - - - - - - - - - - - - - - - - - - - - - + closure="1" + destroy="2"> + function to call when buffer are passed over pad + - - + + data to pass along with the handler + - + allow-none="1" + scope="async"> + function to call when the probe is disconnected, or NULL - + + Adds a "data probe" to a pad. This function will be called whenever data +passes through a pad. In this case data means both events and buffers. The +probe will be called with the data as an argument, meaning @handler should +have the same callback signature as the #GstPad::have-data signal. +Note that the data will have a reference count greater than 1, so it will +be immutable -- you must not change it. +For source pads, the probe will be called after the blocking function, if any +(see gst_pad_set_blocked_async()), but before looking up the peer to chain +to. For sink pads, the probe function will be called before configuring the +sink with new caps, if any, and before calling the pad's chain function. +Your data probe should return TRUE to let the data continue to flow, or FALSE +to drop it. Dropping data is rarely useful, but occasionally comes in handy +with events. +Although probes are implemented internally by connecting @handler to the +have-data signal on the pad, if you want to remove a probe it is insufficient +to only call g_signal_handler_disconnect on the returned handler id. To +remove a probe, use the appropriate function, such as +gst_pad_remove_data_probe(). - - - - - - - - - - - + The handler id. + - - + + function to call when data is passed over pad + + + + data to pass along with the handler + - + + Adds a "data probe" to a pad. This function will be called whenever data +passes through a pad. In this case data means both events and buffers. The +probe will be called with the data as an argument, meaning @handler should +have the same callback signature as the #GstPad::have-data signal. +Note that the data will have a reference count greater than 1, so it will +be immutable -- you must not change it. +For source pads, the probe will be called after the blocking function, if any +(see gst_pad_set_blocked_async()), but before looking up the peer to chain +to. For sink pads, the probe function will be called before configuring the +sink with new caps, if any, and before calling the pad's chain function. +Your data probe should return TRUE to let the data continue to flow, or FALSE +to drop it. Dropping data is rarely useful, but occasionally comes in handy +with events. +Although probes are implemented internally by connecting @handler to the +have-data signal on the pad, if you want to remove a probe it is insufficient +to only call g_signal_handler_disconnect on the returned handler id. To +remove a probe, use the appropriate function, such as +gst_pad_remove_data_probe(). +The @notify function is called when the probe is disconnected and usually +used to free @data. - - - - - - - - - - - + The handler id. + - - + + function to call when data is passed over pad + + + + data to pass along with the handler + + + + function to call when the probe is disconnected, or NULL + - + Adds a probe that will be called for all events passing through a pad. See +gst_pad_add_data_probe() for more information. + + The handler id + + + + + function to call when events are passed over pad + + + + data to pass along with the handler + + + + + + Adds a probe that will be called for all events passing through a pad. See +gst_pad_add_data_probe() for more information. +The @notify function is called when the probe is disconnected and usually +used to free @data. + + The handler id + + + + + function to call when events are passed over pad + + + + data to pass along with the handler, or NULL + + + + function to call when probe is disconnected, or NULL + + + + + + Allocates a new, empty buffer optimized to push to pad @pad. This function only works if @pad is a source pad and has a peer. A new, empty #GstBuffer will be put in the @buf argument. You need to check the caps of the buffer after performing this @@ -9942,28 +11729,33 @@ result code other than #GST_FLOW_OK is an error and @buf should not be used. An error can occur if the pad is not connected or when the downstream peer elements cannot provide an acceptable buffer. -MT safe."> - +MT safe. + + a result code indicating success of the operation. Any - + the offset of the new buffer in the stream + - + the size of the new buffer + + the caps of the new buffer + a newly allocated buffer + In addition to the function gst_pad_alloc_buffer(), this function automatically calls gst_pad_set_caps() when the caps of the newly allocated buffer are different from the @pad caps. After a renegotiation, the size of the new buffer returned in @buf could @@ -9973,441 +11765,606 @@ result code other than #GST_FLOW_OK is an error and @buf should not be used. An error can occur if the pad is not connected or when the downstream peer elements cannot provide an acceptable buffer. -MT safe."> - +MT safe. + + a result code indicating success of the operation. Any - + the offset of the new buffer in the stream + - + the size of the new buffer + + the caps of the new buffer - + + a newly allocated buffer - + + Checks if the source pad and the sink pad are compatible so they can be +linked. - + TRUE if the pads can be linked. + - - + + the sink #GstPad. + - + + Chain a buffer to @pad. +The function returns #GST_FLOW_WRONG_STATE if the pad was flushing. +If the caps on @buffer are different from the current caps on @pad, this +function will call any setcaps function (see gst_pad_set_setcaps_function()) +installed on @pad. If the new caps are not acceptable for @pad, this +function returns #GST_FLOW_NOT_NEGOTIATED. +The function proceeds calling the chain function installed on @pad (see +gst_pad_set_chain_function()) and the return value of that function is +returned to the caller. #GST_FLOW_NOT_SUPPORTED is returned if @pad has no +chain function. +In all cases, success or failure, the caller loses its reference to @buffer +after calling this function. +MT safe. - + a #GstFlowReturn from the pad. + - - + + the #GstBuffer to send, return GST_FLOW_ERROR if not. + - - - - - - - - - - - - - - - - - - - - - + Chain a bufferlist to @pad. +The function returns #GST_FLOW_WRONG_STATE if the pad was flushing. +If the caps on the first buffer of @list are different from the current +caps on @pad, this function will call any setcaps function +(see gst_pad_set_setcaps_function()) installed on @pad. If the new caps +are not acceptable for @pad, this function returns #GST_FLOW_NOT_NEGOTIATED. +The function proceeds calling the chainlist function installed on @pad (see +gst_pad_set_chain_list_function()) and the return value of that function is +returned to the caller. #GST_FLOW_NOT_SUPPORTED is returned if @pad has no +chainlist function. +In all cases, success or failure, the caller loses its reference to @list +after calling this function. +MT safe. + + a #GstFlowReturn from the pad. + + + + + the #GstBufferList to send, return GST_FLOW_ERROR if not. + + + + + + Checks if a gst_pad_pull_range() can be performed on the peer +source pad. This function is used by plugins that want to check +if they can use random access on the peer source pad. +The peer sourcepad can implement a custom #GstPadCheckGetRangeFunction +if it needs to perform some logic to determine if pull_range is +possible. +MT safe. + + a gboolean with the result. + + + + + Invokes the given dispatcher function on each respective peer of +all pads that are internally linked to the given pad. +The GstPadDispatcherFunction should return TRUE when no further pads +need to be processed. + + TRUE if one of the dispatcher functions returned TRUE. + + + + + the #GstPadDispatcherFunction to call. + + + + gpointer user data passed to the dispatcher function. + + + + + + Invokes the default event handler for the given pad. End-of-stream and +discontinuity events are handled specially, and then the event is sent to all +pads internally linked to @pad. Note that if there are many possible sink +pads that are internally linked to @pad, only one will be sent an event. +Multi-sinkpad elements should implement custom event handlers. + + TRUE if the event was sent succesfully. + + + + + the #GstEvent to handle. + + + + + + Fixate a caps on the given pad. Modifies the caps in place, so you should +make sure that the caps are actually writable (see gst_caps_make_writable()). - - + + the #GstCaps to fixate + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the capabilities of the allowed media types that can flow through +The allowed capabilities is calculated as the intersection of the results of +calling gst_pad_get_caps() on @pad and its peer. The caller owns a reference +on the resulting caps. +caps when you no longer need it. This function returns NULL when @pad +has no peer. +MT safe. - - - - - - - - - - - - - - - - - - - - - + the allowed #GstCaps of the pad link. Unref the + - + + Gets the capabilities this pad can produce or consume. +Note that this method doesn't necessarily return the caps set by +gst_pad_set_caps() - use GST_PAD_CAPS() for that instead. +gst_pad_get_caps returns all possible caps a pad can operate with, using +the pad's get_caps function; +this returns the pad template caps if not explicitly set. +MT safe. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + a newly allocated copy of the #GstCaps of this pad + Gets the capabilities this pad can produce or consume. Preferred function if +one only wants to read or intersect the caps. + the caps of the pad with incremented ref-count. - - - - - - + + Gets the direction of the pad. The direction of the pad is +decided at construction time so this function does not take +the LOCK. +MT safe. - + the #GstPadDirection of the pad. + - - - - - - + + Gets the private data of a pad. +No locking is performed in this function. - + a #gpointer to the private data. + - - - - - - - - - - - - - - - - + + A helper function you can use as a GetCaps function that +will return the currently negotiated caps or the padtemplate +when NULL. + the currently negotiated caps or the padtemplate. - + + Gets a list of pads to which the given pad is linked to +inside of the parent element. +The caller must free this list after use. +Not MT safe. +of pads, free with g_list_free(). +could become invalid by the time the application accesses them. It's also +possible that the list changes while handling the pads, which the caller of +this function is unable to know. Use the thread-safe +gst_pad_iterate_internal_links() instead. - + a newly allocated #GList + + + - - - - - - - - - - - + + Gets a list of pads to which the given pad is linked to +inside of the parent element. +This is the default handler, and thus returns a list of all of the +pads inside the parent element with opposite direction. +The caller must free this list after use with g_list_free(). +of pads, or NULL if the pad has no parent. +Not MT safe. +could become invalid by the time the application accesses them. It's also +possible that the list changes while handling the pads, which the caller of +this function is unable to know. Use the thread-safe +gst_pad_iterate_internal_links_default() instead. - + a newly allocated #GList + + + + Gets the capabilities of the media type that currently flows through @pad and its peer. This function can be used on both src and sinkpads. Note that srcpads are always negotiated before sinkpads so it is possible that the negotiated caps on the srcpad do not match the negotiated caps of the peer. -you no longer need it. This function returns NULL when the @pad has no -peer or is not negotiated yet. -MT safe."> +the caps when you no longer need it. This function returns NULL when +the @pad has no peer or is not negotiated yet. +MT safe. + the negotiated #GstCaps of the pad link. Unref - + Gets the template for @pad. +instantiated, or %NULL if this pad has no template. + + the #GstPadTemplate from which this pad was + + + + + Gets the capabilities for @pad's template. +to keep a reference on the caps, make a copy (see gst_caps_copy ()). + + the #GstCaps of this pad template. If you intend + + + + + Gets the parent of @pad, cast to a #GstElement. If a @pad has no parent or +its parent is not an element, return NULL. +reference on the parent, so unref when you're finished with it. +MT safe. + + the parent of the pad. The caller has a + + + + + Gets the peer of @pad. This function refs the peer pad so +you need to unref it after use. +MT safe. + + the peer #GstPad. Unref after usage. + + + + + Get an array of supported queries that can be performed +on this pad. +of #GstQueryType. + + a zero-terminated array + + + + + + + Invoke the default dispatcher for the query types on +the pad. +of #GstQueryType, or NULL if none of the internally-linked pads has a +query types function. + + a zero-terminated array + + + + + + + When @pad is flushing this function returns #GST_FLOW_WRONG_STATE +immediatly and @buffer is %NULL. +Calls the getrange function of @pad, see #GstPadGetRangeFunction for a +description of a getrange function. If @pad has no getrange function +installed (see gst_pad_set_getrange_function()) this function returns +#GST_FLOW_NOT_SUPPORTED. +This is a lowlevel function. Usualy gst_pad_pull_range() is used. +MT safe. + + a #GstFlowReturn from the pad. + + + + + The start offset of the buffer + + + + The length of the buffer + + + + a pointer to hold the #GstBuffer, returns #GST_FLOW_ERROR if %NULL. + + + + + + Query if a pad is active +MT safe. + + TRUE if the pad is active. + + + + + Checks if the pad is blocked or not. This function returns the +last requested state of the pad. It is not certain that the pad +is actually blocking at this point (see gst_pad_is_blocking()). +MT safe. + + TRUE if the pad is blocked. + + + + + Checks if the pad is blocking or not. This is a guaranteed state +of whether the pad is actually blocking on a #GstBuffer or a #GstEvent. +MT safe. + + TRUE if the pad is blocking. + + + + + Checks if a @pad is linked to another pad or not. +MT safe. + + TRUE if the pad is linked, FALSE otherwise. + + + + + Gets an iterator for the pads to which the given pad is linked to inside +of the parent element. +Each #GstPad element yielded by the iterator will have its refcount increased, +so unref after use. +pad does not have an iterator function configured. Use +gst_iterator_free() after usage. + + a new #GstIterator of #GstPad or %NULL when the + + + + + Iterate the list of pads to which the given pad is linked to inside of +the parent element. +This is the default handler, and thus returns an iterator of all of the +pads inside the parent element with opposite direction. +The caller must free this iterator after use with gst_iterator_free(). +returned pad with gst_object_unref(). + + a #GstIterator of #GstPad, or NULL if @pad has no parent. Unref each + + + + + Links the source pad and the sink pad. +what went wrong. +MT Safe. + + A result code indicating if the connection worked or + + + + + the sink #GstPad to link. + + + + + + Links the source pad and the sink pad. +This variant of #gst_pad_link provides a more granular control on the +checks being done when linking. While providing some considerable speedups +the caller of this method must be aware that wrong usage of those flags +can cause severe issues. Refer to the documentation of #GstPadLinkCheck +for more information. +MT Safe. +what went wrong. + + A result code indicating if the connection worked or + + + + + the sink #GstPad to link. + + + + the checks to validate when linking + + + + + + Pause the task of @pad. This function will also wait until the +function executed by the task is finished if this function is not +called from the task function. +has no task. + + a TRUE if the task could be paused or FALSE when the pad + + + + + Check if the peer of @pad accepts @caps. If @pad has no peer, this function +returns TRUE. + + TRUE if the peer of @pad can accept the caps or @pad has no peer. + + + + + a #GstCaps to check on the pad + + + + + + Gets the capabilities of the peer connected to this pad. Similar to +gst_pad_get_caps(). +peer pad. Use gst_caps_unref() to get rid of it. This function +returns %NULL if there is no peer pad. + + a newly allocated copy of the #GstCaps of the + + + + + Gets the capabilities of the peer connected to this pad. Preferred function +if one only wants to read or intersect the caps. + + the caps of the pad with incremented ref-count + + + + + Performs gst_pad_query() on the peer of @pad. +The caller is responsible for both the allocation and deallocation of +the query structure. +if @pad has no peer. + + TRUE if the query could be performed. This function returns %FALSE + + + + + the #GstQuery to perform. + + + + + + Calls gst_pad_get_allowed_caps() for every other pad belonging to the +same element as @pad, and returns the intersection of the results. +This function is useful as a default getcaps function for an element +that can handle any stream format, but requires all its pads to have +the same caps. Two such elements are tee and adder. + + the intersection of the other pads' allowed caps. + + + + + + + + + + + + + + + Pulls a @buffer from the peer pad. +This function will first trigger the pad block signal if it was +installed. +When @pad is not linked #GST_FLOW_NOT_LINKED is returned else this +function returns the result of gst_pad_get_range() on the peer pad. +See gst_pad_get_range() for a list of return values and for the +semantics of the arguments of this function. +configured on @pad. Renegotiation within a running pull-mode pipeline is not +supported. +When this function returns #GST_FLOW_OK, @buffer will contain a valid +#GstBuffer that should be freed with gst_buffer_unref() after usage. +#GST_FLOW_OK is returned. +MT safe. + + a #GstFlowReturn from the peer pad. + + + + + The start offset of the buffer + + + + The length of the buffer + + + + a pointer to hold the #GstBuffer, returns GST_FLOW_ERROR if %NULL. + + + + + + Pushes a buffer to the peer of @pad. This function will call an installed pad block before triggering any installed pad probes. If the caps on @buffer are different from the currently configured caps on @@ -10418,19 +12375,40 @@ the value from that function. If @pad has no peer, #GST_FLOW_NOT_LINKED will be returned. In all cases, success or failure, the caller loses its reference to @buffer after calling this function. -MT safe."> - +MT safe. + + a #GstFlowReturn from the peer pad. - + + the #GstBuffer to push returns GST_FLOW_ERROR if not. + + Sends the event to the peer of the given pad. This function is +mainly used by elements to send events to their peer +elements. +This function takes owership of the provided event so you should +gst_event_ref() it if you want to reuse the event after this call. +MT safe. + + TRUE if the event was handled. + + + + + the #GstEvent to send to the pad. + + + + + Pushes a buffer list to the peer of @pad. This function will call an installed pad block before triggering any installed pad probes. If the caps on the first buffer in the first group of @list are different @@ -10448,170 +12426,256 @@ every group buffer of the list will be merged into a normal #GstBuffer and chained via gst_pad_chain(). In all cases, success or failure, the caller loses its reference to @list after calling this function. -MT safe." - version="0.10.24"> - +MT safe. + + a #GstFlowReturn from the peer pad. - + + the #GstBufferList to push returns GST_FLOW_ERROR if not. - + + Dispatches a query to a pad. The query should have been allocated by the +caller via one of the type-specific allocation functions. The element that +the pad belongs to is responsible for filling the query with an appropriate +response, which should then be parsed with a type-specific query parsing +function. +Again, the caller is responsible for both the allocation and deallocation of +the query structure. +Please also note that some queries might need a running pipeline to work. - - - - - - + TRUE if the query could be performed. + - - - - - - - - + + the #GstQuery to perform. + - + + Queries a pad to convert @src_val in @src_format to @dest_format. - + TRUE if the query could be performed. + - - + + a #GstFormat to convert from. + + + + a value to convert. + + + + a pointer to the #GstFormat to convert to. + + + + a pointer to the result. + - + + Invokes the default query handler for the given pad. +The query is sent to all pads internally linked to @pad. Note that +if there are many possible sink pads that are internally linked to +Multi-sinkpad elements should implement custom query handlers. - + TRUE if the query was performed succesfully. + - - + + the #GstQuery to handle. + - - - + + Queries a pad for the total stream duration. + + TRUE if the query could be performed. + - - + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + + + + a location in which to store the total duration, or NULL. + - - - + + Queries the peer pad of a given sink pad to convert @src_val in @src_format +to @dest_format. + + TRUE if the query could be performed. + - - + + a #GstFormat to convert from. + + + + a value to convert. + + + + a pointer to the #GstFormat to convert to. + + + + a pointer to the result. + - - - + + Queries the peer pad of a given sink pad for the total stream duration. + + TRUE if the query could be performed. + - - + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + - - - - - + + a location in which to store the total duration, or NULL. + - + Queries the peer of a given sink pad for the stream position. + + TRUE if the query could be performed. + + + + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + + + + a location in which to store the current position, or NULL. + + + + + + Queries a pad for the stream position. + + TRUE if the query could be performed. + + + + + a pointer to the #GstFormat asked for. On return contains the #GstFormat used. + + + + A location in which to store the current position, or NULL. + + + + + + Removes a buffer probe from @pad. + + + + + + handler id returned from gst_pad_add_buffer_probe + + + + + + Removes a data probe from @pad. + + + + + + handler id returned from gst_pad_add_data_probe + + + + + + Removes an event probe from @pad. + + + + + + handler id returned from gst_pad_add_event_probe + + + + + + Sends the event to the pad. This function can be used by applications to send events in the pipeline. If @pad is a source pad, @event should be an upstream event. If @pad is a sink pad, @event should be a downstream event. For example, you would not @@ -10619,648 +12683,576 @@ send a #GST_EVENT_EOS on a src pad; EOS events only propagate downstream. Furthermore, some downstream events have to be serialized with data flow, like EOS, while some can travel out-of-band, like #GST_EVENT_FLUSH_START. If the event needs to be serialized with data flow, this function will take the -pad's stream lock while calling its event function. +pad's stream lock while calling its event function. To find out whether an event type is upstream, downstream, or downstream and serialized, see #GstEventTypeFlags, gst_event_type_get_flags(), #GST_EVENT_IS_UPSTREAM, #GST_EVENT_IS_DOWNSTREAM, and #GST_EVENT_IS_SERIALIZED. Note that in practice that an application or -plugin doesn't need to bother itself with this information; the core handles +plugin doesn't need to bother itself with this information; the core handles all necessary locks and checks. This function takes owership of the provided event so you should -gst_event_ref() it if you want to reuse the event after this call."> +gst_event_ref() it if you want to reuse the event after this call. - + TRUE if the event was handled. + - + + the #GstEvent to send to the pad. - - - - - - - - - - - - - - - - - - - - - - - - + + Sets the given acceptcaps function for the pad. The acceptcaps function +will be called to check if the pad can accept the given caps. Setting the +acceptcaps function to NULL restores the default behaviour of allowing +any caps that matches the caps from gst_pad_get_caps(). - + + the #GstPadAcceptCapsFunction to set. + + + + + + Sets the given activate function for @pad. The activate function will +dispatch to gst_pad_activate_push() or gst_pad_activate_pull() to perform +the actual activation. Only makes sense to set on sink pads. +Call this function if your sink pad can start a pull-based task. + + + + + + the #GstPadActivateFunction to set. + + + + + + Sets the given activate_pull function for the pad. An activate_pull function +prepares the element and any upstream connections for pulling. See XXX +part-activation.txt for details. + + + + + + the #GstPadActivateModeFunction to set. + + + + + + Sets the given activate_push function for the pad. An activate_push function +prepares the element for pushing. See XXX part-activation.txt for details. + + + + + + the #GstPadActivateModeFunction to set. + + + + + + Activates or deactivates the given pad. +Normally called from within core state change functions. +If @active, makes sure the pad is active. If it is already active, either in +push or pull mode, just return. Otherwise dispatches to the pad's activate +function to perform the actual activation. +If not @active, checks the pad's current mode and calls +gst_pad_activate_push() or gst_pad_activate_pull(), as appropriate, with a +FALSE argument. +MT safe. + + #TRUE if the operation was successful. + + + + + whether or not the pad should be active. + + + + + + Blocks or unblocks the dataflow on a pad. This function is +a shortcut for gst_pad_set_blocked_async() with a NULL +callback. +wrong parameters were passed or the pad was already in the requested state. +MT safe. + + TRUE if the pad could be blocked. This function can fail if the + + + + + boolean indicating we should block or unblock + + + + + + Blocks or unblocks the dataflow on a pad. The provided callback +is called when the operation succeeds; this happens right before the next +attempt at pushing a buffer on the pad. +This can take a while as the pad can only become blocked when real dataflow +is happening. +When the pipeline is stalled, for example in PAUSED, this can +take an indeterminate amount of time. +You can pass NULL as the callback to make this call block. Be careful with +this blocking call as it might not return for reasons stated above. +wrong parameters were passed or the pad was already in the requested state. +MT safe. + + TRUE if the pad could be blocked. This function can fail if the + + + + + boolean indicating whether the pad should be blocked or unblocked + + + + #GstPadBlockCallback that will be called when the operation succeeds + + + + user data passed to the callback + + + + + + Blocks or unblocks the dataflow on a pad. The provided callback +is called when the operation succeeds; this happens right before the next +attempt at pushing a buffer on the pad. +This can take a while as the pad can only become blocked when real dataflow +is happening. +When the pipeline is stalled, for example in PAUSED, this can +take an indeterminate amount of time. +You can pass NULL as the callback to make this call block. Be careful with +this blocking call as it might not return for reasons stated above. +wrong parameters were passed or the pad was already in the requested state. +MT safe. + + TRUE if the pad could be blocked. This function can fail if the + + + + + boolean indicating whether the pad should be blocked or unblocked + + + + #GstPadBlockCallback that will be called when the operation succeeds + + + + user data passed to the callback + + + + #GDestroyNotify for user_data + + + + + + Sets the given bufferalloc function for the pad. Note that the +bufferalloc function can only be set on sinkpads. + + + + + + the #GstPadBufferAllocFunction to set. + + + + + + Sets the capabilities of this pad. The caps must be fixed. Any previous +caps on the pad will be unreffed. This function refs the caps so you should +unref if as soon as you don't need it anymore. +It is possible to set NULL caps, which will make the pad unnegotiated +again. +or bad parameters were provided to this function. +MT safe. + + TRUE if the caps could be set. FALSE if the caps were not fixed + + + + + a #GstCaps to set. + + + + + + Sets the given chain function for the pad. The chain function is called to +process a #GstBuffer input buffer. see #GstPadChainFunction for more details. + + + + + + the #GstPadChainFunction to set. + + + + + + Sets the given chain list function for the pad. The chainlist function is +called to process a #GstBufferList input buffer list. See +#GstPadChainListFunction for more details. + + + + + + the #GstPadChainListFunction to set. + + + + + + Sets the given checkgetrange function for the pad. Implement this function +on a pad if you dynamically support getrange based scheduling on the pad. + + + + + + the #GstPadCheckGetRangeFunction to set. + + + + + + Set the given private data gpointer on the pad. +This function can only be used by the element that owns the pad. +No locking is performed in this function. + + + + + + The private data to attach to the pad. + + + + + + Sets the given event handler for the pad. + + + + + + the #GstPadEventFunction to set. + + + + + + Sets the given fixatecaps function for the pad. The fixatecaps function +will be called whenever the default values for a GstCaps needs to be +filled in. + + + + + + the #GstPadFixateCapsFunction to set. + + + + + + Sets the given getcaps function for the pad. @getcaps should return the +allowable caps for a pad in the context of the element's state, its link to +other elements, and the devices or files it has opened. These caps must be a +subset of the pad template caps. In the NULL state with no links, @getcaps +should ideally return the same caps as the pad template. In rare +circumstances, an object property can affect the caps returned by @getcaps, +but this is discouraged. +You do not need to call this function if @pad's allowed caps are always the +same as the pad template caps. This can only be true if the padtemplate +has fixed simple caps. +For most filters, the caps returned by @getcaps is directly affected by the +allowed caps on other pads. For demuxers and decoders, the caps returned by +the srcpad's getcaps function is directly related to the stream data. Again, +helps with autoplugging. +Note that the return value from @getcaps is owned by the caller, so the +caller should unref the caps after usage. + + + + + + the #GstPadGetCapsFunction to set. + + + + + + Sets the given getrange function for the pad. The getrange function is +called to produce a new #GstBuffer to start the processing pipeline. see +#GstPadGetRangeFunction for a description of the getrange function. + + + + + + the #GstPadGetRangeFunction to set. + + + + + + Sets the given internal link function for the pad. + + + + + + the #GstPadIntLinkFunction to set. - - - - - - - - - - + version="0.10.21" + introspectable="0"> + Sets the given internal link iterator function for the pad. - + + the #GstPadIterIntLinkFunction to set. - - - - - - - - - - - + + Sets the given link function for the pad. It will be called when +the pad is linked with another pad. +The return value #GST_PAD_LINK_OK should be used when the connection can be +made. +The return value #GST_PAD_LINK_REFUSED should be used when the connection +cannot be made for some reason. +If @link is installed on a source pad, it should call the #GstPadLinkFunction +of the peer sink pad, if present. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the #GstPadLinkFunction to set. + + introspectable="0"> + Set the given query function for the pad. - + + the #GstPadQueryFunction to set. - + + Set the given query type function for the pad. - + - - + + the #GstPadQueryTypeFunction to set. + - + + Sets the given setcaps function for the pad. The setcaps function +will be called whenever a buffer with a new media type is pushed or +pulled from the pad. The pad/element needs to update its internal +structures to process the new media type. If this new type is not +acceptable, the setcaps function should return FALSE. - + - - + + the #GstPadSetCapsFunction to set. + + + + + + Sets the given unlink function for the pad. It will be called +when the pad is unlinked. + + + + + + the #GstPadUnlinkFunction to set. + + + + + + Starts a task that repeatedly calls @func with @data. This function +is mostly used in pad activation functions to start the dataflow. +The #GST_PAD_STREAM_LOCK of @pad will automatically be acquired +before @func is called. + + a %TRUE if the task could be started. + + + + + the task function to call + - + data passed to the task function + - + Stop the task of @pad. This function will also make sure that the +function executed by the task will effectively stop if not called +from the GstTaskFunction. +This function will deadlock if called from the GstTaskFunction of +the task. Use gst_task_pause() instead. +Regardless of whether the pad has a task, the stream lock is acquired and +released so as to ensure that streaming through this pad has finished. + + a TRUE if the task could be stopped or FALSE on error. + + + + + Unlinks the source pad from the sink pad. Will emit the #GstPad::unlinked +signal on both pads. +the pads were not linked together. +MT safe. + + TRUE if the pads were unlinked. This function returns FALSE if + + + + + the sink #GstPad to unlink. + + + + + + A helper function you can use that sets the pad. This way the function will always return the negotiated caps or in case the pad is not negotiated, the padtemplate caps. Use this function on a pad that, once gst_pad_set_caps() has been called -on it, cannot be renegotiated to something else."> +on it, cannot be renegotiated to something else. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + - - + + - - + + - + @@ -11287,7 +13279,7 @@ used to free @data." - + @@ -11325,7 +13317,7 @@ used to free @data." - + @@ -11357,12 +13349,12 @@ used to free @data." c:type="GstPadBufferAllocFunction"/> - + - + - + @@ -11372,7 +13364,7 @@ used to free @data." - + @@ -11380,121 +13372,132 @@ used to free @data." - + - + Signals that new data is available on the pad. This signal is used internally for implementing pad probes. -See gst_pad_add_*_probe functions."> - - +See gst_pad_add_*_probe functions. + + %TRUE to keep the data, %FALSE to drop it + - - + + new data + - - - + + Signals that a pad has been linked to the peer pad. + + - - + + the peer pad that has been connected + - - - + + Signals that a pad connection has been requested. + + - - - + + Signals that a pad has been unlinked from the peer pad. + + - - + + the peer pad that has been disconnected + - + Check if @pad can accept @caps. By default this function will see if @caps intersect with the result from gst_pad_get_caps() by can be overridden to -perform extra checks."> +perform extra checks. - + TRUE if the caps can be accepted by the pad. + + the #GstPad to check + the #GstCaps to check - + This function is called when the pad is activated during the element READY to PAUSED state change. By default this function will call the activate function that puts the pad in push mode but elements can -override this function to activate the pad in pull mode if they wish."> +override this function to activate the pad in pull mode if they wish. - + TRUE if the pad could be activated. + + a #GstPad + c:type="GstPadActivateModeFunction"> + The prototype of the push and pull activate functions. - + TRUE if the pad could be activated or deactivated. + + a #GstPad - + activate or deactivate the pad. + - + + Callback used by gst_pad_set_blocked_async(). Gets called when the blocking +operation succeeds. + the #GstPad that is blockend or unblocked. - + blocking state for the pad + - + the gpointer to optional user data. + - + Ask the sinkpad @pad to allocate a buffer with @offset, @size and @caps. The result will be stored in @buf. The purpose of this function is to allocate a buffer that is optimal to be processed by @pad. The function is mostly overridden by elements that can @@ -11509,80 +13512,92 @@ the @buf is NULL, a #GstBuffer will be created with @caps, @offset and @size. By default this function returns a new buffer of @size and with @caps containing purely malloced data. The buffer should be freed with gst_buffer_unref() after usage. -value means @buf does not hold a valid buffer."> - +value means @buf does not hold a valid buffer. + + #GST_FLOW_OK if @buf contains a valid buffer, any other return + a sink #GstPad - + the desired offset of the buffer + - + the desired size of the buffer + + the desired caps of the buffer + pointer to hold the allocated buffer. - + A function that will be called on sinkpads when chaining buffers. The function typically processes the data contained in the buffer and either consumes the data or passes it on to the internally linked pad(s). The implementer of this function receives a refcount to @buffer and should gst_buffer_unref() when the buffer is no longer needed. When a chain function detects an error in the data stream, it must post an -error on the bus and return an appropriate #GstFlowReturn value."> - +error on the bus and return an appropriate #GstFlowReturn value. + + #GST_FLOW_OK for success + the sink #GstPad that performed the chain. + the #GstBuffer that is chained, not %NULL. - + A function that will be called on sinkpads when chaining buffer lists. The function typically processes the data contained in the buffer list and either consumes the data or passes it on to the internally linked pad(s). The implementer of this function receives a refcount to @list and should gst_buffer_list_unref() when the list is no longer needed. When a chainlist function detects an error in the data stream, it must -post an error on the bus and return an appropriate #GstFlowReturn value."> - +post an error on the bus and return an appropriate #GstFlowReturn value. + + #GST_FLOW_OK for success + the sink #GstPad that performed the chain. + the #GstBufferList that is chained, not %NULL. + Check if @pad can be activated in pull mode. This function will be deprecated after 0.10; use the seeking query to check -if a pad can support random access."> +if a pad can support random access. - + TRUE if the pad can operate in pull mode. + + a #GstPad @@ -11594,7 +13609,7 @@ if a pad can support random access."> - + @@ -11609,7 +13624,7 @@ if a pad can support random access."> - + @@ -11624,7 +13639,7 @@ if a pad can support random access."> - + @@ -11636,9 +13651,9 @@ if a pad can support random access."> - + - + @@ -11652,67 +13667,72 @@ if a pad can support random access."> - + - + + The direction of a pad. - + + A dispatcher function is called for all internally linked pads, see +gst_pad_dispatcher(). - + TRUE if the dispatching procedure has to be stopped. + + the #GstPad that is dispatched. - + the gpointer to optional user data. + - + + Function signature to handle an event for the pad. - + TRUE if the pad could handle the event. + + the #GstPad to handle the event. + the #GstEvent to handle. - + Given possibly unfixed caps @caps, let @pad use its default prefered format to make a fixed caps. @caps should be writable. By default this function will pick the first value of any ranges or lists in the caps but -elements can override this function to perform other behaviour."> +elements can override this function to perform other behaviour. + a #GstPad + the #GstCaps to fixate - + + Pad state flags @@ -11720,23 +13740,23 @@ elements can override this function to perform other behaviour."> - + Returns a copy of the capabilities of the specified pad. By default this function will return the pad template capabilities, but can optionally -be overridden by elements."> +be overridden by elements. + a newly allocated copy #GstCaps of the pad. + the #GstPad to get the capabilities of. - + This function will be called on source pads when a peer element request a buffer at the specified @offset and @length. If this function returns #GST_FLOW_OK, the result buffer will be stored in @buffer. The contents of @buffer is invalid for any other return value. @@ -11749,8 +13769,9 @@ length (duration in bytes) can be retrieved with a #GST_QUERY_DURATION or with a Any @offset larger or equal than the length will make the function return #GST_FLOW_UNEXPECTED, which corresponds to EOS. In this case @buffer does not contain a valid buffer. -The buffer size of @buffer might be smaller than @length when @offset is near -the end of the stream. +The buffer size of @buffer will only be smaller than @length when @offset is +near the end of the stream. In all other cases, the size of @buffer must be +exactly the requested size. It is allowed to call this function with a 0 @length and valid @offset, in which case @buffer will contain a 0-sized buffer and the function returns #GST_FLOW_OK. @@ -11758,57 +13779,91 @@ When this function is called with a -1 @offset, the sequentially next buffer of length @length in the stream is returned. When this function is called with a -1 @length, a buffer with a default optimal length is returned in @buffer. The length might depend on the value -of @offset."> - +of @offset. +return value leaves @buffer undefined. + + #GST_FLOW_OK for success and a valid buffer in @buffer. Any other + the src #GstPad to perform the getrange on. - + the offset of the range + - + the length of the range + + a memory location to hold the result buffer, cannot be NULL. - - + The signature of the internal pad link function. +the inside of the parent element. +The caller must call g_list_free() on it after use. + + a newly allocated #GList of pads that are linked to the given pad on + + + + The #GstPad to query. + The signature of the internal pad link iterator function. linked to the given pad on the inside of the parent element. the caller must call gst_iterator_free() after usage. -Since 0.10.21"> - +Since 0.10.21 + + a new #GstIterator that will iterate over all pads that are + The #GstPad to query. + + The amount of checking to be done when linking pads. @GST_PAD_LINK_CHECK_CAPS +and @GST_PAD_LINK_CHECK_TEMPLATE_CAPS are mutually exclusive. If both are +specified, expensive but safe @GST_PAD_LINK_CHECK_CAPS are performed. +<warning><para> +Only disable some of the checks if you are 100% certain you know the link +will not fail because of hierarchy/caps compatibility failures. If uncertain, +use the default checks (%GST_PAD_LINK_CHECK_DEFAULT) or the regular methods +for linking the pads. +</para></warning> + + + + + - + @@ -11820,9 +13875,8 @@ Since 0.10.21"> - + + Result values from gst_pad_link and friends. - + + Indicates when this pad will become available. - + - + + The signature of the query function. - + TRUE if the query could be performed. + + the #GstPad to query. + the #GstQuery object to execute - + + The signature of the query types function. + a constant array of query types + a #GstPad to query - + Set @caps on @pad. By default this function updates the caps of the pad but the function can be overriden by elements to perform extra -actions or verifications."> +actions or verifications. - + TRUE if the caps could be set on the pad. + + the #GstPad to set the capabilities of. + the #GstCaps to set - The padtemplate object. + + Creates a new pad template with a name according to the given template and with the given arguments. This functions takes ownership of the provided -caps, so be sure to not use them afterwards."> +caps, so be sure to not use them afterwards. + a new #GstPadTemplate. + the name template. + the #GstPadDirection of the template. + the #GstPadPresence of the pad. - + + a #GstCaps set for the template. The caps are taken ownership of. - - + + Gets the capabilities of the pad template. +keep a reference to the caps, take a ref (see gst_caps_ref ()). + + the #GstCaps of the pad template. If you need to - + + Emit the pad-created signal for this template when created by this pad. + the #GstPad that created it - - + + - - + + - - + + - - + + @@ -11970,17 +14046,18 @@ the caps, take a ref (see gst_caps_ref ())."> - + - - - + + This signal is fired when an element creates a pad from this template. + + - - + + the pad that was created. + @@ -11992,7 +14069,7 @@ the caps, take a ref (see gst_caps_ref ())."> - + @@ -12008,13 +14085,12 @@ the caps, take a ref (see gst_caps_ref ())."> - + - + + Flags for the padtemplate - + + + This function creates a fraction GParamSpec for use by objects/elements +that want to expose properties of fraction type. This function is typically +used in connection with g_object_class_install_property() in a GObjects's +instance_init function. + + a newly created parameter specification + + + + + canonical name of the property specified + + + + nick name for the property specified + + + + description of the property specified + + + + minimum value (fraction numerator) + + + + minimum value (fraction denominator) + + + + maximum value (fraction numerator) + + + + maximum value (fraction denominator) + + + + default value (fraction numerator) + + + + default value (fraction denominator) + + + + flags for the property specified + + + + + + + A GParamSpec derived structure that contains the meta data for fractional +properties. - + - + - + - + - + - + - + + A %GParamSpec derived structure that contains the meta data +for %GstMiniObject properties. - - - + Opaque structure. + + Frees a parse context previously allocated with gst_parse_context_new(). + + - + + Retrieve missing elements from a previous run of gst_parse_launch_full() or gst_parse_launchv_full(). Will only return results if an error code of %GST_PARSE_ERROR_NO_SUCH_ELEMENT was returned. -missing elements. Free with g_strfreev() when no longer needed." - version="0.10.20"> +NULL-terminated array of element factory name strings of missing +elements. Free with g_strfreev() when no longer needed. + a - - - - - + The different parsing errors that can occur. - + + Parsing options. + The #GstPipeline structure. - + + Create a new pipeline with the given name. +MT safe. - + newly created GstPipeline + + name of new pipeline - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Let @pipeline select a clock automatically. This is the default behaviour. Use this function if you previous forced a fixed clock with gst_pipeline_use_clock() and want to restore the default pipeline clock selection algorithm. -MT safe."> +MT safe. - + + Check if @pipeline will automatically flush messages when going to +the NULL state. +going from READY to NULL state or not. +MT safe. - + whether the pipeline will automatically flush its bus when + + + + + Gets the #GstBus of @pipeline. The bus allows applications to receive +#GstMessage packets. +MT safe. + + a #GstBus, unref after usage. + + + + + Gets the current clock used by @pipeline. + + a #GstClock, unref after usage. + - - - - - - + Get the configured delay (see gst_pipeline_set_delay()). +MT safe. + + The configured delay. + + + + + Gets the last running time of @pipeline. If the pipeline is PLAYING, +the returned time is the running time used to configure the element's +base time in the PAUSED->PLAYING state. If the pipeline is PAUSED, the +returned time is the running time when the pipeline was paused. +This function returns #GST_CLOCK_TIME_NONE if the pipeline was +configured to not handle the management of the element's base time +(see gst_pipeline_set_new_stream_time()). +MT safe. +gst_element_get_start_time(). + + a #GstClockTime. + Usually, when a pipeline goes from READY to NULL state, it automatically flushes all pending messages on the bus, which is done for refcounting purposes, to break circular references. This means that applications that update state using (async) bus messages @@ -12297,38 +14357,105 @@ be flushed before they can be dispatched in the main thread. This behaviour can be disabled using this function. It is important that all messages on the bus are handled when the automatic flushing is disabled else memory leaks will be introduced. -MT safe." - version="0.10.4"> +MT safe. - + whether or not to automatically flush the bus when the pipeline goes from READY to NULL state + - + + Set the clock for @pipeline. The clock will be distributed +to all the elements managed by the pipeline. +some element did not accept the clock. +MT safe. - + TRUE if the clock could be set on the pipeline. FALSE if + + + + the clock to set + + + + + + Set the expected delay needed for all elements to perform the +PAUSED to PLAYING state change. @delay will be added to the +base time of the elements so that they wait an additional @delay +amount of time before starting to process buffers and cannot be +#GST_CLOCK_TIME_NONE. +This option is used for tuning purposes and should normally not be +used. +MT safe. + + + + + + the delay + + + + + + Set the new start time of @pipeline to @time. The start time is used to +set the base time on the elements (see gst_element_set_base_time()) +in the PAUSED->PLAYING state transition. +Setting @time to #GST_CLOCK_TIME_NONE will disable the pipeline's management +of element base time. The application will then be responsible for +performing base time distribution. This is sometimes useful if you want to +synchronize capture from multiple pipelines, and you can also ensure that the +pipelines have the same clock. +MT safe. +gst_element_set_start_time(). + + + + + + the new running time to set + + + + + + Force @pipeline to use the given @clock. The pipeline will +always use the given clock even if new clock providers are added +to this pipeline. +If @clock is NULL all clocking will be disabled which will make +the pipeline run as fast as possible. +MT safe. + + + + + + the clock to use + + + - + transfer-ownership="none"> + Whether or not to automatically flush all messages on the +pipeline's bus when going from READY to NULL state. Please see +gst_pipeline_set_auto_flush_bus() for more information on this option. + - - + + @@ -12347,7 +14474,7 @@ gst_pipeline_set_auto_flush_bus() for more information on this option."> - + @@ -12359,13 +14486,12 @@ gst_pipeline_set_auto_flush_bus() for more information on this option."> - + - + + Pipeline flags @@ -12373,320 +14499,214 @@ gst_pipeline_set_auto_flush_bus() for more information on this option."> value="536870912" c:identifier="GST_PIPELINE_FLAG_LAST"/> - + + The plugin object + + Get the error quark. + + The error quark used in GError messages + + + + + Unrefs each member of @list, then frees the list. + + + + + + list of #GstPlugin + + + + + + + + Load the named plugin. Refs the plugin. + + a reference to a loaded plugin, or NULL on error. + + + + + name of plugin to load + + + + + + Loads the given plugin and refs it. Caller needs to unref after use. +reference to the newly-loaded GstPlugin, or NULL if an error occurred. + + a reference to the existing loaded GstPlugin, a + + + + + the plugin filename to load + + + + + Registers a static plugin, ie. a plugin which is private to an application or library and contained within the application or library (as opposed to being shipped as a separate module file). You must make sure that GStreamer has been initialised (with gst_init() or -via gst_init_get_option_group()) before calling this function." - version="0.10.16"> +via gst_init_get_option_group()) before calling this function. - + TRUE if the plugin was registered correctly, otherwise FALSE. + - + the major version number of the GStreamer core that the plugin was compiled for, you can just use GST_VERSION_MAJOR here + - + the minor version number of the GStreamer core that the plugin was compiled for, you can just use GST_VERSION_MINOR here + + a unique name of the plugin (ideally prefixed with an application- or library-specific namespace prefix in order to avoid name conflicts in case a similar plugin with the same name ever gets added to GStreamer) + description of the plugin + pointer to the init function of this plugin. + version string of the plugin + effective license of plugin. Must be one of the approved licenses (see #GstPluginDesc above) or the plugin will not be registered. + source module plugin belongs to + shipped package plugin belongs to + URL to provider of plugin + Registers a static plugin, ie. a plugin which is private to an application or library and contained within the application or library (as opposed to being shipped as a separate module file) with a #GstPluginInitFullFunc which allows user data to be passed to the callback function (useful for bindings). You must make sure that GStreamer has been initialised (with gst_init() or -via gst_init_get_option_group()) before calling this function." - version="0.10.24"> +via gst_init_get_option_group()) before calling this function. - + TRUE if the plugin was registered correctly, otherwise FALSE. + - + the major version number of the GStreamer core that the plugin was compiled for, you can just use GST_VERSION_MAJOR here + - + the minor version number of the GStreamer core that the plugin was compiled for, you can just use GST_VERSION_MINOR here + + a unique name of the plugin (ideally prefixed with an application- or library-specific namespace prefix in order to avoid name conflicts in case a similar plugin with the same name ever gets added to GStreamer) + description of the plugin + scope="call" + closure="10"> + pointer to the init function with user data of this plugin. + version string of the plugin + effective license of plugin. Must be one of the approved licenses (see #GstPluginDesc above) or the plugin will not be registered. + source module plugin belongs to + shipped package plugin belongs to + URL to provider of plugin - + gpointer to user data + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Make GStreamer aware of external dependencies which affect the feature set of this plugin (ie. the elements or typefinders associated with it). GStreamer will re-inspect plugins with external dependencies whenever any of the external dependencies change. This is useful for plugins which wrap other plugin systems, e.g. a plugin which wraps a plugin-based visualisation library and makes visualisations available as GStreamer elements, or a codec loader which exposes elements and/or caps dependent on what external -codec libraries are currently installed." - version="0.10.22"> +codec libraries are currently installed. - - - + NULL-terminated array of environent variables affecting the feature set of the plugin (e.g. an environment variable containing paths where to look for additional modules/plugins of a library), or NULL. Environment variable names may be followed by a path component which will be added to the content of the environment variable, e.g. "HOME/.mystuff/plugins". + - - - + NULL-terminated array of directories/paths where dependent files may be. + - - - + NULL-terminated array of file names (or file name suffixes, depending on @flags) to be used in combination with the paths from + + optional flags, or #GST_PLUGIN_DEPENDENCY_FLAG_NONE @@ -12694,11 +14714,8 @@ codec libraries are currently installed." + Make GStreamer aware of external dependencies which affect the feature set of this plugin (ie. the elements or typefinders associated with it). GStreamer will re-inspect plugins with external dependencies whenever any of the external dependencies change. This is useful for plugins which wrap @@ -12708,27 +14725,157 @@ codec loader which exposes elements and/or caps dependent on what external codec libraries are currently installed. Convenience wrapper function for gst_plugin_add_dependency() which takes simple strings as arguments instead of string arrays, with multiple -arguments separated by predefined delimiters (see above)." - version="0.10.22"> +arguments separated by predefined delimiters (see above). + one or more environent variables (separated by ':', ';' or ','), or NULL. Environment variable names may be followed by a path component which will be added to the content of the environment variable, e.g. "HOME/.mystuff/plugins:MYSTUFF_PLUGINS_PATH" + one ore more directory paths (separated by ':' or ';' or ','), or NULL. Example: "/usr/lib/mystuff/plugins" + one or more file names or file name suffixes (separated by commas), or NULL + optional flags, or #GST_PLUGIN_DEPENDENCY_FLAG_NONE + + Gets the plugin specific data cache. If it is %NULL there is no cached data +stored. This is the case when the registry is getting rebuilt. + + The cached data as a #GstStructure or %NULL. + + + + + Get the long descriptive name of the plugin + + the long name of the plugin + + + + + get the filename of the plugin + + the filename of the plugin + + + + + get the license of the plugin + + the license of the plugin + + + + + Gets the #GModule of the plugin. If the plugin isn't loaded yet, NULL is +returned. +plugin isn't loaded yet. + + module belonging to the plugin or NULL if the + + + + + Get the short name of the plugin + + the name of the plugin + + + + + get the URL where the plugin comes from + + the origin of the plugin + + + + + get the package the plugin belongs to. + + the package of the plugin + + + + + get the source module the plugin belongs to. + + the source of the plugin + + + + + get the version of the plugin + + the version of the plugin + + + + + queries if the plugin is loaded into memory + + TRUE is loaded, FALSE otherwise + + + + + Loads @plugin. Note that the *return value* is the loaded plugin; @plugin is +untouched. The normal use pattern of this function goes like this: +<programlisting> +GstPlugin *loaded_plugin; +loaded_plugin = gst_plugin_load (plugin); +// presumably, we're no longer interested in the potentially-unloaded plugin +gst_object_unref (plugin); +plugin = loaded_plugin; +</programlisting> + + a reference to a loaded plugin, or NULL on error. + + + + + A standard filter that returns TRUE when the plugin is of the +given name. + + TRUE if the plugin is of the given name. + + + + + the name of the plugin + + + + + + Adds plugin specific data to cache. Passes the ownership of the structure to +the @plugin. +The cache is flushed every time the registry is rebuilt. + + + + + + a structure containing the data to cache + + + + @@ -12739,7 +14886,7 @@ arguments separated by predefined delimiters (see above)." - + @@ -12751,20 +14898,20 @@ arguments separated by predefined delimiters (see above)." - + - + - + - + @@ -12776,17 +14923,14 @@ arguments separated by predefined delimiters (see above)." - + + Flags used in connection with gst_plugin_add_dependency(). @@ -12800,16 +14944,15 @@ Flags used in connection with gst_plugin_add_dependency()." value="4" c:identifier="GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_SUFFIX"/> - + A plugin should export a variable of this type called plugin_desc. The plugin loader will use the data provided there to initialize the plugin. -BSD, MIT/X11, Proprietary, unknown."> +BSD, MIT/X11, Proprietary, unknown. - + - + @@ -12835,16 +14978,17 @@ BSD, MIT/X11, Proprietary, unknown."> + + + - - + + - + + The plugin loading errors c:identifier="GST_PLUGIN_ERROR_NAME_MISMATCH"/> - + Opaque #GstPluginFeature structure. + + Copies the list of features. Caller should call @gst_plugin_feature_list_free +when done with the list. +with each feature's reference count incremented. + + a copy of @list, + + + + + + + list of #GstPluginFeature + + + + + + + + Debug the plugin feature names in @list. - + a #GList of plugin features + + + - - - + + Unrefs each member of @list, then frees the list. + + - - + + list of #GstPluginFeature + + + - + Compares the two given #GstPluginFeature instances. This function can be +used as a #GCompareFunc when sorting by rank and then by name. +equal but the name of p1 comes before the name of p2; zero if the rank +and names are equal; positive value if the rank of p1 < the rank of p2 or the +ranks are equal but the name of p2 comes after the name of p1 + + negative value if the rank of p1 > the rank of p2 or the ranks are + + + + + a #GstPluginFeature + + + + a #GstPluginFeature + + + + + + Checks whether the given plugin feature is at least +the required version +the required version, otherwise #FALSE. + + #TRUE if the plugin feature has at least + + + + + minimum required major version + + + + minimum required minor version + + + + minimum required micro version + + + + + + Gets the name of a plugin feature. + + the name + + + + + Gets the rank of a plugin feature. + + The rank of the feature + + + + + Loads the plugin containing @feature if it's not already loaded. @feature is unaffected; use the return value instead. Normally this function is used like this: |[ GstPluginFeature *loaded_feature; loaded_feature = gst_plugin_feature_load (feature); -// presumably, we're no longer interested in the potentially-unloaded feature +// presumably, we're no longer interested in the potentially-unloaded feature gst_object_unref (feature); feature = loaded_feature; -]|"> +]| + a reference to the loaded feature, or NULL on error - - - - - - - - - - - - - - - - - - - - - + Sets the name of a plugin feature. The name uniquely identifies a feature within all features of the same type. Renaming a plugin feature is not allowed. A copy is made of the name so you should free the supplied @name -after calling this function."> +after calling this function. + the name to set - + + Specifies a rank for a plugin feature, so that autoplugging uses +the most appropriate feature. - - - - - - - - - - - + - - + + rank value - higher number means more priority rank + - - - - - + + + + Compares type and name of plugin feature. Can be used with gst_filter_run(). + + TRUE if equal. + + + + + the type and name to check against + @@ -12981,20 +15180,20 @@ the required version, otherwise #FALSE."> - + - + - + @@ -13006,46 +15205,48 @@ the required version, otherwise #FALSE."> - + - + + A function that can be used with e.g. gst_registry_feature_filter() +to get a list of pluginfeature that match certain criteria. - + %TRUE for a positive match, %FALSE otherwise + + the pluginfeature to check - + the user_data that has been passed on e.g. gst_registry_feature_filter() + - + + A function that can be used with e.g. gst_registry_plugin_filter() +to get a list of plugins that match certain criteria. - + TRUE for a positive match, FALSE otherwise + + the plugin to check - + the user_data that has been passed on e.g. gst_registry_plugin_filter() + - + + The plugin loading state + A plugin should provide a pointer to a function of either #GstPluginInitFunc or this type in the plugin_desc struct. The function will be called by the loader at startup. One would then register each #GstPluginFeature. This version allows -user data to be passed to init function (useful for bindings)." - version="0.10.24"> +user data to be passed to init function (useful for bindings). - + %TRUE if plugin initialised successfully + + The plugin object - + extra data + - + A plugin should provide a pointer to a function of this type in the plugin_desc struct. This function will be called by the loader at startup. One would then -register each #GstPluginFeature."> +register each #GstPluginFeature. - + %TRUE if plugin initialised successfully + + The plugin object - + - - - - - - - - - - - - - - - - - + + A set of file/network descriptors. + + Add a file descriptor to the file descriptor set. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE if the file descriptor was successfully added to the set. + + a file descriptor. + Check if @fd in @set has data to be read. - + %TRUE if the descriptor has data to be read. + + a file descriptor. + Check if @fd in @set can be used for writing. - + %TRUE if the descriptor can be used for writing. + + a file descriptor. - + Control whether the descriptor @fd in @set will be monitored for +readability. + + %TRUE if the descriptor was successfully updated. + + + + + a file descriptor. + + + + a new status. + + + + + + Control whether the descriptor @fd in @set will be monitored for +writability. + + %TRUE if the descriptor was successfully updated. + + + + + a file descriptor. + + + + a new status. + + + + + + Check if @fd in @set has closed the connection. + + %TRUE if the connection was closed. + + + + + a file descriptor. + + + + + + Check if @fd in @set has an error. + + %TRUE if the descriptor has an error. + + + + + a file descriptor. + + + + + + Mark @fd as ignored so that the next call to gst_poll_wait() will yield +the same result for @fd as last time. This function must be called if no +operation (read/write/recv/send/etc.) will be performed on @fd before +the next call to gst_poll_wait(). +The reason why this is needed is because the underlying implementation +might not allow querying the fd more than once between calls to one of +the re-enabling operations. + + + + + + a file descriptor. + + + + + + Free a file descriptor set. + + + + + + Get a GPollFD for the reading part of the control socket. This is useful when +integrating with a GSource and GMainLoop. + + + + + + a #GPollFD + + + + + + Read a byte from the control socket of the controllable @set. +This function is mostly useful for timer #GstPoll objects created with +gst_poll_new_timer(). +was no byte to read. + + %TRUE on success. %FALSE when @set is not controllable or when there + + + + + Remove a file descriptor from the file descriptor set. + + %TRUE if the file descriptor was successfully removed from the set. + + + + + a file descriptor. + + + + + + Restart any gst_poll_wait() that is in progress. This function is typically +used after adding or removing descriptors to @set. +If @set is not controllable, then this call will have no effect. + + + + + + When @controllable is %TRUE, this function ensures that future calls to +gst_poll_wait() will be affected by gst_poll_restart() and +gst_poll_set_flushing(). + + %TRUE if the controllability of @set could be updated. + + + + + new controllable state. + + + + + + When @flushing is %TRUE, this function ensures that current and future calls +to gst_poll_wait() will return -1, with errno set to EBUSY. +Unsetting the flushing state will restore normal operation of @set. + + + + + + new flushing state. + + + + + + Wait for activity on the file descriptors in @set. This function waits up to the specified @timeout. A timeout of #GST_CLOCK_TIME_NONE waits forever. For #GstPoll objects created with gst_poll_new(), this function can only be called from a single thread at a time. If called from multiple threads, @@ -13269,203 +15527,244 @@ This is not true for timer #GstPoll objects created with gst_poll_new_timer(), where it is allowed to have multiple threads waiting simultaneously. activity was detected after @timeout. If an error occurs, -1 is returned -and errno is set." - version="0.10.18"> +and errno is set. - + The number of #GstPollFD in @set that have activity or 0 when no + + a timeout in nanoseconds. - - - - - - - - - - - - - - - - - - - - - - - - - + Write a byte to the control socket of the controllable @set. This function is mostly useful for timer #GstPoll objects created with -gst_poll_new_timer(). +gst_poll_new_timer(). It will make any current and future gst_poll_wait() function return with 1, meaning the control socket is set. After an equal amount of calls to gst_poll_read_control() have been performed, calls to gst_poll_wait() will block again until their timeout expired. -byte could not be written." - version="0.10.23"> +byte could not be written. - - - - - - + %TRUE on success. %FALSE when @set is not controllable or when the + - + + A file descriptor object. - + - + - + + Initializes @fd. Alternatively you can initialize it with +#GST_POLL_FD_INIT. - + Opaque #GstPreset data structure. + + Delete the given preset. + + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + + + + preset name to remove + + + + + + Gets the @value for an existing meta data @tag. Meta data @tag names can be +something like e.g. "comment". Returned values need to be released when done. +or no value for the given @tag + + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + + + + preset name + + + + meta data item name + + + + value + + + + + + Get a copy of preset names as a NULL terminated string array. +list with names, ue g_strfreev() after usage. - + + Get a the names of the GObject properties that can be used for presets. +array of property names which should be freed with g_strfreev() after use. + an - + + Load the given preset. - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name to load - + + Renames a preset. If there is already a preset by the @new_name it will be +overwritten. - - - - - - - - - - - + %TRUE for success, %FALSE if e.g. there is no preset with @old_name + + current preset name + new preset name - + + Save the current object settings as a preset under the given name. If there +is already a preset by this @name it will be overwritten. - + %TRUE for success, %FALSE + + preset name to save - + + Sets a new @value for an existing meta data item or adds a new item. Meta +data @tag names can be something like e.g. "comment". Supplying %NULL for the - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name + meta data item name + new value - + + Delete the given preset. - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name to remove + + + + + + Gets the @value for an existing meta data @tag. Meta data @tag names can be +something like e.g. "comment". Returned values need to be released when done. +or no value for the given @tag + + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + + + + preset name + meta data item name - - - - + + value + - + - + Get a copy of preset names as a NULL terminated string array. +list with names, ue g_strfreev() after usage. + @@ -13473,9 +15772,11 @@ was no byte to read." - + Get a the names of the GObject properties that can be used for presets. +array of property names which should be freed with g_strfreev() after use. + + an @@ -13483,114 +15784,89 @@ was no byte to read." + Load the given preset. - - - - - - - - - - - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name to load + Renames a preset. If there is already a preset by the @new_name it will be +overwritten. - + %TRUE for success, %FALSE if e.g. there is no preset with @old_name + + current preset name + new preset name - + Save the current object settings as a preset under the given name. If there +is already a preset by this @name it will be overwritten. - + %TRUE for success, %FALSE + + preset name to save + Sets a new @value for an existing meta data item or adds a new item. Meta +data @tag names can be something like e.g. "comment". Supplying %NULL for the - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name + meta data item name + new value - - - - - - - - - - - - - - - - - - + glib:is-gtype-struct-for="Preset"> + #GstPreset interface. - + @@ -13604,8 +15880,9 @@ or no value for the given @tag" - + + an @@ -13618,119 +15895,138 @@ or no value for the given @tag" - + - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name to load - + - + %TRUE for success, %FALSE + + preset name to save - + - + %TRUE for success, %FALSE if e.g. there is no preset with @old_name + + current preset name + new preset name - + - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name to remove - + - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name + meta data item name + new value - + - + %TRUE for success, %FALSE if e.g. there is no preset with that @name + + preset name + meta data item name - - - - + + value + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + The #GstQuery structure. + c:identifier="gst_query_new_application"> + Constructs a new custom application query object. Use gst_query_unref() +when done with it. + a new #GstQuery + the query type + a structure for the query - - - - - - - - - - - - - - - @@ -13891,338 +16091,638 @@ the stream." - + + Constructs a new convert query object. Use gst_query_unref() +when done with it. A convert query is used to ask for a conversion between +one format and another. + a #GstQuery + + + + + the source #GstFormat for the new query + + + + the value to convert + + + + the target #GstFormat + + + + + + Constructs a new stream duration query object to query in the given format. +Use gst_query_unref() when done with it. A duration query will give the +total length of the stream. + + a new #GstQuery + + + + + the #GstFormat for this duration query + + + + + + Constructs a new query object for querying formats of +the stream. + + a new #GstQuery - - - + + Constructs a new latency query object. +Use gst_query_unref() when done with it. A latency query is usually performed +by sinks to compensate for additional latency introduced by elements in the +pipeline. + + a #GstQuery + + + + + Constructs a new query stream position query object. Use gst_query_unref() +when done with it. A position query is used to query the current position +of playback in the streams, in some format. + + a new #GstQuery + + the default #GstFormat for the new query - - + + + + Constructs a new query object for querying seeking properties of +the stream. + + a new #GstQuery + + + + + the default #GstFormat for the new query + + + + + + Constructs a new segment query object. Use gst_query_unref() +when done with it. A segment query is used to discover information about the +currently configured segment for playback. + + a new #GstQuery + + + + + the #GstFormat for the new query + + + + + + Constructs a new query URI query object. Use gst_query_unref() +when done with it. An URI query is used to query the current URI +that is used by the source or sink. + + a new #GstQuery + + + + + Get the query type registered with @nick. +if the query was not registered. + + The query registered with @nick or #GST_QUERY_NONE + + + + + The nick of the query + + + + + + Get details about the given #GstQueryType. + + The #GstQueryTypeDefinition for @type or NULL on failure. + + + + + a #GstQueryType + + + + + + Get a printable name for the given query type. Do not modify or free. + + a reference to the static name of the query. + + + + + the query type + + + + + + Get a #GstIterator of all the registered query types. The definitions +iterated over are read only. + + a #GstIterator of #GstQueryTypeDefinition. + + + + + Create a new GstQueryType based on the nick or return an +already registered query with that nick +with the same nick. + + A new GstQueryType or an already registered query + + + + + The nick of the new query + + + + The description of the new query + + + + + + Get the unique quark for the given query type. + + the quark associated with the query type + + + + + the query type + + + + + + See if the given #GstQueryType is inside the @types query types array. + + TRUE if the type is found inside the array + + + + + The query array to search + + + + the #GstQueryType to find + + + + + + + + + + + + + + - + + + + + + + Get the structure of a query. +still owned by the query and will therefore be freed when the query +is unreffed. + + the #GstStructure of the query. The structure is + + + + - + + + + + + + + + + Parse an available query, writing the format into @format, and +other results into the passed parameters, if the respective parameters +are non-NULL + + + + + + the format to set for the @segment_start and @segment_end values, or NULL - - + + the start to set, or NULL + + + + the stop to set, or NULL + + + + estimated total amount of download time, or NULL + - + + Extracts the buffering stats values from @query. - - + + a buffering mode, or NULL + - - + + the average input rate, or NULL + + + + the average output rat, or NULLe + + + + amount of buffering time left, or NULL + - + + Parse a convert query answer. Any of @src_format, @src_value, @dest_format, +and @dest_value may be NULL, in which case that value is omitted. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the storage for the #GstFormat of the source value, or NULL - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + the storage for the source value, or NULL + - + + the storage for the #GstFormat of the destination value, or NULL - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + the storage for the destination value, or NULL + - + + Parse a duration query answer. Write the format of the duration into @format, +and the value into @duration, if the respective variables are non-NULL. - - - - - - - - - - - - - - - - - - - - - - - + + the storage for the #GstFormat of the duration value, or NULL. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + caller-allocates="0" + transfer-ownership="full" + allow-none="1"> + the storage for the total duration, or NULL. + + Parse the number of formats in the formats @query. - + the number of formats in this query. + + Parse the format query and retrieve the @nth format from it into +set to GST_FORMAT_UNDEFINED. - - + + the nth format to retrieve. + - + + a pointer to store the nth format + + Parse a latency query answer. + + + + + + storage for live or NULL + + + + the storage for the min latency or NULL + + + + the storage for the max latency or NULL + + + + + + + + + + + + + + + + + + + + + + Parse a position query, writing the format into @format, and the position +into @cur, if the respective parameters are non-NULL. + + + + + + the storage for the #GstFormat of the position values (may be NULL) + + + + the storage for the current position (may be NULL) + + + + + + Parse a seeking query, writing the format into @format, and +other results into the passed parameters, if the respective parameters +are non-NULL + + + + + + the format to set for the @segment_start and @segment_end values, or NULL + + + + the seekable flag to set, or NULL + + + + the segment_start to set, or NULL + + + + the segment_end to set, or NULL + + + + + + Parse a segment query answer. Any of @rate, @format, @start_value, and +See gst_query_set_segment() for an explanation of the function arguments. + + + + + + the storage for the rate of the segment, or NULL + + + + the storage for the #GstFormat of the values, or NULL + + + + the storage for the start value, or NULL + + + + the storage for the stop value, or NULL + + + + + + Parse an URI query, writing the URI into @uri as a newly +allocated string, if the respective parameters are non-NULL. +Free the string with g_free() after usage. + + + + + + the storage for the current URI (may be NULL) + + + + @@ -14230,167 +16730,278 @@ set to GST_FORMAT_UNDEFINED." - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Set the available query result fields in @query. + the format to set for the @start and @stop values - + the start to set + - + the stop to set + - + estimated total amount of download time + - + Configures the buffering stats values in @query. + + + + + + a buffering mode + + + + the average input rate + + + + the average output rate + + + + amount of buffering time left + + + + + + Answer a convert query by setting the requested values. + + + + + + the source #GstFormat + + + + the source value + + + + the destination #GstFormat + + + + the destination value + + + + + + Answer a duration query by setting the requested value in the given format. - + the #GstFormat for the duration + - - - - - - - - + + the duration of the stream + - + + Set the formats query result fields in @query. The number of formats passed +must be equal to @n_formats. - - - + + the number of formats to set. + + + + + + + + + + Set the formats query result fields in @query. The number of formats passed +in the @formats array must be equal to @n_formats. + + + + + + the number of formats to set. + + + + an array containing @n_formats + + + + Answer a latency query by setting the requested values in the given format. + + + + + + if there is a live element upstream + + + + the minimal latency of the live element + + + + the maximal latency of the live element + + + + + + Answer a position query by setting the requested value in the given format. + + + + + + the requested #GstFormat + + + + the position to set + + + + + + Set the seeking query result fields in @query. + + + + + + the format to set for the @segment_start and @segment_end values + + + + the seekable flag to set + + + + the segment_start to set + + + + the segment_end to set + + + + + + Answer a segment query by setting the requested values. The normal +playback segment of a pipeline is 0 to duration at the default rate of +1.0. If a seek was performed on the pipeline to play a different +segment, this query will return the range specified in the last seek. +playback range start and stop values expressed in @format. +The values are always between 0 and the duration of the media and +negative rates, playback will actually happen from @stop_value to + + + + + + the rate of the segment + + + + the #GstFormat of the segment values (@start_value and @stop_value) + + + + the start value + + + + the stop value + + + + + Answer a URI query by setting the requested URI. + the URI to set - - - + + + + + + + + + + + + + + + - + - + - + + Standard predefined Query types @@ -14405,9 +17016,8 @@ Standard predefined Query types" - + + A Query Type definition @@ -14421,304 +17031,345 @@ Standard predefined Query types" - + Element priority ranks. Defines the order in which the autoplugger (or similar rank-picking mechanisms, such as e.g. gst_element_make_from_uri()) will choose this element over an alternative one with the same function. These constants serve as a rough guidance for defining the rank of a -#GstPluginFeature. Any value is valid, including values bigger than" - c:type="GstRank"> +#GstPluginFeature. Any value is valid, including values bigger than - - - - - + Opaque #GstRegistry structure. + By default GStreamer will perform scanning and rebuilding of the registry file using a helper child process. Applications might want to disable this behaviour with the gst_registry_fork_set_enabled() function, in which case new plugins are scanned (and loaded) into the application process. -rebuilding the registry." - version="0.10.10"> +rebuilding the registry. - + %TRUE if GStreamer will use the child helper process when + + Applications might want to disable/enable spawning of a child helper process +when rebuilding the registry. See gst_registry_fork_is_enabled() for more +information. - + whether rebuilding the registry can use a temporary child helper process. + - + + Retrieves the default registry. The caller does not own a reference on the +registry, as it is alive as long as GStreamer is initialized. - + The default #GstRegistry. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Add the feature to the registry. The feature-added signal will be emitted. This function sinks @feature. -MT safe."> +MT safe. - + TRUE on success. + - + + the feature to add - + + Add the given path to the registry. The syntax of the +path is specific to the registry. If the path has already been +added, do nothing. - - + + the path to add to the registry + - - - - - - - - + + Add the plugin to the registry. The plugin-added signal will be emitted. +This function will sink @plugin. +MT safe. + + TRUE on success. + - - - - - - - - + + the plugin to add + + Runs a filter against all features of the plugins in the registry and returns a GList with the results. If the first flag is set, only the first match is returned (as a list with a single object). -after usage. -MT safe."> +#GstPluginFeature. Use gst_plugin_feature_list_free() after usage. +MT safe. - + a #GList of + + + - + + the filter to use - + only return first match + - + user data passed to the filter function + + + + + + Find the pluginfeature with the given name and type in the registry. +or NULL if the plugin was not found. gst_object_unref() after usage. +MT safe. + + the pluginfeature with the given name and type + + + + + the pluginfeature name to find + + + + the pluginfeature type to find + + + + + + Find the plugin with the given name in the registry. +The plugin will be reffed; caller is responsible for unreffing. +plugin was not found. gst_object_unref() after usage. +MT safe. + + the plugin with the given name or NULL if the + + + + + the plugin name to find + + c:identifier="gst_registry_get_feature_list"> + Retrieves a #GList of #GstPluginFeature of @type. +#GstPluginFeature of @type. Use gst_plugin_feature_list_free() after use +MT safe. - + a #GList of + + + + a #GType. + c:identifier="gst_registry_get_feature_list_by_plugin"> + Retrieves a #GList of features of the plugin with name @name. +#GstPluginFeature. Use gst_plugin_feature_list_free() after usage. - + a #GList of + + + + a plugin name. + Returns the registrys feature list cookie. This changes +every time a feature is added or removed from the registry. - + the feature list cookie. + - + + Get the list of paths for the given registry. +strings. g_list_free after use. +MT safe. + + A #GList of paths as + + + + + + + Get a copy of all plugins registered in the given registry. The refcount +of each element in the list in incremented. +Use gst_plugin_list_free() after usage. +MT safe. - + a #GList of #GstPlugin. + + + - - - - - - - - - - - - - - - - - - - + Look up a plugin in the given registry with the given filename. If found, plugin is reffed. -after usage."> +gst_object_unref() after usage. + the #GstPlugin if found, or NULL if not. + the name of the file to look up - + + Find a #GstPluginFeature with @name in @registry. +use gst_object_unref() after usage. +MT safe. + a #GstPluginFeature with its refcount incremented, + a #GstPluginFeature name + + Runs a filter against all plugins in the registry and returns a #GList with +the results. If the first flag is set, only the first match is +returned (as a list with a single object). +Every plugin is reffed; use gst_plugin_list_free() after use, which +will unref again. +Use gst_plugin_list_free() after usage. +MT safe. + + a #GList of #GstPlugin. + + + + + + + the filter to use + + + + only return first match + + + + user data passed to the filter function + + + + + + Remove the feature from the registry. +MT safe. + + + + + + the feature to remove + + + + + + Remove the plugin from the registry. +MT safe. + + + + + + the plugin to remove + + + + + + Scan the given path for plugins to add to the registry. The syntax of the +path is specific to the registry. + + %TRUE if registry changed + + + + + the path to scan + + + + - + @@ -14729,7 +17380,7 @@ MT safe."> - + @@ -14741,52 +17392,66 @@ MT safe."> - + + + - + + + - + + + - + - + + + + - + + + + - + - - - + + Signals that a feature has been added to the registry (possibly +replacing a previously-added one by the same name) + + - - + + the feature that has been added + - - - + + Signals that a plugin has been added to the registry (possibly +replacing a previously-added one by the same name) + + - - + + the plugin that has been added + @@ -14798,7 +17463,7 @@ replacing a previously-added one by the same name)"> - + @@ -14813,7 +17478,7 @@ replacing a previously-added one by the same name)"> - + @@ -14829,21 +17494,18 @@ replacing a previously-added one by the same name)"> - + - + + Resource errors are for any resource used by an element: +memory, files, network connections, process space, ... +They're typically used by source and sink elements. @@ -14879,26 +17541,20 @@ They're typically used by source and sink elements." c:identifier="GST_RESOURCE_ERROR_NUM_ERRORS"/> - + - + + The different search modes. - + Flags to be used with gst_element_seek() or gst_event_new_seek(). All flags can be used together. A non flushing seek might take some time to perform as the currently playing data in the pipeline will not be cleared. -An accurate seek might be slower for formats that don't have any indexes +An accurate seek might be slower for formats that don't have any indexes or timestamp markers in the stream. Specifying this flag might require a complete scan of the file in those cases. no EOS will be emmited by the element that performed the seek, but a @@ -14909,8 +17565,7 @@ looping or simple linear editing. When doing fast forward (rate > 1.0) or fast reverse (rate < -1.0) trickmode playback, the @GST_SEEK_FLAG_SKIP flag can be used to instruct decoders and demuxers to adjust the playback rate by skipping frames. This can improve -performance and decrease CPU usage because not all frames need to be decoded." - c:type="GstSeekFlags"> +performance and decrease CPU usage because not all frames need to be decoded. @@ -14918,15 +17573,11 @@ performance and decrease CPU usage because not all frames need to be decoded." - + The different types of seek events. When constructing a seek event with gst_event_new_seek(), a format, a seek method and optional flags are to be provided. The seek event is then inserted into the graph with -gst_pad_send_event() or gst_element_send_event()." - c:type="GstSeekType"> +gst_pad_send_event() or gst_element_send_event(). @@ -14934,15 +17585,16 @@ gst_pad_send_event() or gst_element_send_event()." + glib:get-type="gst_segment_get_type" + c:symbol-prefix="segment"> + A helper structure that holds the configured region of +interest in a media file. - + - + @@ -14951,112 +17603,252 @@ interest in a media file." - + - + - + - + - + - + - + - + - + + Allocate a new #GstSegment structure and initialize it using +gst_segment_init(). + a new #GstSegment, free with gst_segment_free(). - + + Clip the given @start and @stop values to the segment boundaries given +in @segment. @start and @stop are compared and clipped to @segment +start and stop values. +If the function returns FALSE, @start and @stop are known to fall +outside of @segment and @clip_start and @clip_stop are not updated. +When the function returns TRUE, @clip_start and @clip_stop will be +updated. If @clip_start or @clip_stop are different from @start or @stop +respectively, the region fell partially in the segment. +Note that when @stop is -1, @clip_stop will be set to the end of the +segment. Depending on the use case, this may or may not be what you want. +completely in @segment, FALSE if the values are completely outside +of the segment. + + TRUE if the given @start and @stop times fall partially or + + + + + the format of the segment. + + + + the start position in the segment + + + + the stop position in the segment + + + + the clipped start position in the segment + + + + the clipped stop position in the segment + + + + + + Create a copy of given @segment. + a new #GstSegment, free with gst_segment_free(). - + + Free the allocated segment @segment. - + The start/last_stop positions are set to 0 and the stop/duration fields are set to -1 (unknown). The default rate of 1.0 and no flags are set. -Initialize @segment to its default values."> +Initialize @segment to its default values. + the format of the segment. - + Set the duration of the segment to @duration. This function is mainly used by elements that perform seeking and know the total duration of the -segment. +segment. This field should be set to allow seeking requests relative to the -duration."> +duration. + the format of the segment. - + the duration of the segment info or -1 if unknown. + - + Set the last observed stop position in the segment to @position. This field should be set to allow seeking requests relative to the -current playing position."> +current playing position. + the format of the segment. - + the position + - + Update the segment structure with the field values of a new segment event and +with a default applied_rate of 1.0. + + + + + + flag indicating a new segment is started or updated + + + + the rate of the segment. + + + + the format of the segment. + + + + the new start value + + + + the new stop value + + + + the new stream time + + + + + + Update the segment structure with the field values of a new segment event. + + + + + + flag indicating a new segment is started or updated + + + + the rate of the segment. + + + + the applied rate of the segment. + + + + the format of the segment. + + + + the new start value + + + + the new stop value + + + + the new stream time + + + + + + Adjust the start/stop and accum values of @segment such that the next valid +buffer will be one with @running_time. +returned, @running_time is -1 or not in @segment. + + %TRUE if the segment could be updated successfully. If %FALSE is + + + + + the format of the segment. + + + + the running_time in the segment + + + + + + Update the segment structure with the field values of a seek event (see gst_event_new_seek()). After calling this method, the segment field last_stop and time will contain the requested new position in the segment. The new requested -position in the segment depends on @rate and @start_type and @stop_type. +position in the segment depends on @rate and @start_type and @stop_type. For positive @rate, the new position in the segment is the new @segment start field when it was updated with a @start_type different from #GST_SEEK_TYPE_NONE. If no update was performed on @segment start position @@ -15071,123 +17863,69 @@ The applied rate of the segment will be set to 1.0 by default. If the caller can apply a rate change, it should update @segment rate and applied_rate after calling this function. last_stop field. This field can be FALSE if, for example, only the @rate -has been changed but not the playback position."> +has been changed but not the playback position. - + the rate of the segment. + + the format of the segment. + the seek flags for the segment + the seek method - + the seek start value + + the seek method - + the seek stop value + - - - - - - - - - - - - - - - - - - - - - - - - - - + boolean holding whether last_stop was updated. + - + + Convert @running_time into a position in the segment so that +gst_segment_to_running_time() with that position returns @running_time. +-1 when @running_time is -1 or when it is not inside @segment. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the position in the segment for @running_time. This function returns + + the format of the segment. - - + + the running_time in the segment + + Translate @position to the total running time using the currently configured and previously accumulated segments. Position is a value between @segment start and stop time. This function is typically used by elements that need to synchronize to the @@ -15195,102 +17933,52 @@ global clock in a pipeline. The runnning time is a constantly increasing value starting from 0. When gst_segment_init() is called, this value will reset to 0. This function returns -1 if the position is outside of @segment start and stop. -was given."> +was given. - + the position as the total running time or -1 when an invalid position + + the format of the segment. - + the position in the segment + - + + Translate @position to stream time using the currently configured +segment. The @position value must be between @segment start and +stop value. +This function is typically used by elements that need to operate on +the stream time of the buffers it receives, such as effect plugins. +In those use cases, @position is typically the buffer timestamp or +clock time that one wants to convert to the stream time. +The stream time is always between 0 and the total duration of the +media stream. +was given. - + the position in stream_time or -1 when an invalid position + + the format of the segment. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + the position in the segment + - + + The possible states an element can be in. States can be changed using +gst_element_set_state() and checked using gst_element_get_state(). @@ -15299,124 +17987,10 @@ gst_element_set_state() and checked using gst_element_get_state()." - + These are the different state changes an element goes through. %GST_STATE_NULL &rArr; %GST_STATE_PLAYING is called an upwards state change -and %GST_STATE_PLAYING &rArr; %GST_STATE_NULL a downwards state change." - c:type="GstStateChange"> +and %GST_STATE_PLAYING &rArr; %GST_STATE_NULL a downwards state change. @@ -15436,11 +18010,8 @@ and %GST_STATE_PLAYING &rArr; %GST_STATE_NULL a downwards state change." value="17" c:identifier="GST_STATE_CHANGE_READY_TO_NULL"/> - + + The possible return values from a state change function. Only @@ -15452,11 +18023,10 @@ The possible return values from a state change function. Only" value="3" c:identifier="GST_STATE_CHANGE_NO_PREROLL"/> - + Datastructure to initialize #GstCaps from a string description usually used in conjunction with GST_STATIC_CAPS() and gst_static_caps_get() to -instantiate a #GstCaps."> +instantiate a #GstCaps. @@ -15465,15 +18035,15 @@ instantiate a #GstCaps."> - + - + + Converts a #GstStaticCaps to a #GstCaps. +Since the core holds an additional ref to the returned caps, +use gst_caps_make_writable() on the returned caps to modify it. + a pointer to the #GstCaps. Unref after usage. @@ -15491,37 +18061,30 @@ use gst_caps_make_writable() on the returned caps to modify it."> - + + Converts a #GstStaticPadTemplate into a #GstPadTemplate. + a new #GstPadTemplate. - + Gets the capabilities of the static pad template. Unref after usage. Since the core holds an additional ref to the returned caps, use gst_caps_make_writable() -on the returned caps to modify it."> +on the returned caps to modify it. + the #GstCaps of the static pad template. + Stream errors are for anything related to the stream being processed: +format errors, media type errors, ... +They're typically used by decoders, demuxers, converters, ... + The type of a %GST_MESSAGE_STREAM_STATUS. The stream status messages inform the +application of new streaming threads and their status. @@ -15582,9 +18145,10 @@ application of new streaming threads and their status." + glib:get-type="gst_structure_get_type" + c:symbol-prefix="structure"> + The GstStructure object. Most fields are private. @@ -15592,28 +18156,90 @@ application of new streaming threads and their status." - + - + + + - + - + + Creates a new, empty #GstStructure with the given @name. +See gst_structure_set_name() for constraints on the @name parameter. + a new, empty #GstStructure + name of new structure + + + + + + Creates a new, empty #GstStructure with the given name as a GQuark. + + a new, empty #GstStructure + + + + + name of new structure + + + + + + Creates a new #GstStructure with the given name as a GQuark, followed by +fieldname quark, GType, argument(s) "triplets" in the same format as +gst_structure_id_set(). Basically a convenience wrapper around +gst_structure_id_empty_new() and gst_structure_id_set(). +The last variable argument must be NULL (or 0). + + a new #GstStructure + + + + + name of new structure + + + + the GQuark for the name of the field to set + + + + + + + + + + Creates a new #GstStructure with the given name. Parses the +list of variable arguments and sets fields to the values listed. +Variable arguments should be passed as field name, field type, +and value. Last variable argument should be NULL. + + a new #GstStructure + + + + + name of new structure + name of first field to set @@ -15622,152 +18248,172 @@ and value. Last variable argument should be NULL."> - + + Creates a new #GstStructure with the given @name. Structure fields +are set according to the varargs in a manner similar to +gst_structure_new(). +See gst_structure_set_name() for constraints on the @name parameter. + a new #GstStructure + + + + + name of new structure + + + + name of first field to set + + + + variable argument list + + + + + + Duplicates a #GstStructure and all its fields and values. + + a new #GstStructure. - + + Fixates a #GstStructure by changing the given @field_name field to the given - + TRUE if the structure could be fixated + - - + + a field in @structure + + + + the target value of the fixation + - + + Fixates a #GstStructure by changing the given field to the nearest +double to @target that is a subset of the existing field. - - - - - - - - - - - - - - - - + TRUE if the structure could be fixated + - + + a field in @structure + + + + the target value of the fixation + + + + + + Fixates a #GstStructure by changing the given field to the nearest +fraction to @target_numerator/@target_denominator that is a subset +of the existing field. + + TRUE if the structure could be fixated + + + + + a field in @structure + + + + The numerator of the target value of the fixation + + + + The denominator of the target value of the fixation + + + + + + Fixates a #GstStructure by changing the given field to the nearest +integer to @target that is a subset of the existing field. + + TRUE if the structure could be fixated + + + + + a field in @structure + + + + the target value of the fixation + + + + + + Fixates a #GstStructure by changing the given @field_name field to the given + + TRUE if the structure could be fixated + + + + + a field in @structure + + + + the target value of the fixation - + + Calls the provided function once for each field in the #GstStructure. The +function must not modify the fields. Also see gst_structure_map_in_place(). +FALSE otherwise. - + TRUE if the supplied function returns TRUE For each of the fields, + - - + + a function to call for each field + + + + private data + - + + Frees a #GstStructure and all its fields and values. The structure must not +have a parent when this function is called. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Parses the variable arguments and reads fields from @structure accordingly. Variable arguments should be in the form field name, field type (as a GType), pointer(s) to a variable(s) to hold the return value(s). The last variable argument should be NULL. @@ -15776,13 +18422,14 @@ you must release with a suitable _unref() when no longer needed. For strings and boxed types you will acquire a copy which you will need to release with either g_free() or the suiteable function for the boxed type. because the field requested did not exist, or was of a type other -than the type specified), otherwise TRUE." - version="0.10.24"> +than the type specified), otherwise TRUE. - + FALSE if there was a problem reading any of the fields (e.g. + + the name of the first field to read @@ -15791,14 +18438,404 @@ than the type specified), otherwise TRUE." + + Sets the boolean pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain a boolean, this +function returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a #gboolean to set + + + + + + Sets the clock time pointed to by @value corresponding to the clock time +of the given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain a #GstClockTime, this +function returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a #GstClockTime to set + + + + + + Sets the date pointed to by @value corresponding to the date of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +On success @value will point to a newly-allocated copy of the date which +inconsistent with e.g. gst_structure_get_string() which doesn't return a +copy of the string). +with @fieldname or the existing field did not contain a data, this function +returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a #GDate to set + + + + + + Sets the datetime pointed to by @value corresponding to the datetime of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +On success @value will point to a reference of the datetime which +should be unreffed with gst_date_time_unref() when no longer needed +(note: this is inconsistent with e.g. gst_structure_get_string() +which doesn't return a copy of the string). +with @fieldname or the existing field did not contain a data, this function +returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a #GstDateTime to set + + + + + + Sets the double pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain a double, this +function returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a gdouble to set + + + + + + Sets the int pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists, +has the correct type and that the enumtype is correct. +with @fieldname or the existing field did not contain an enum of the given +type, this function returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + the enum type of a field + + + + a pointer to an int to set + + + + + + Finds the field with the given name, and returns the type of the +value it contains. If the field is not found, G_TYPE_INVALID is +returned. + + the #GValue of the field + + + + + the name of the field + + + + + + Sets the Fourcc pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain a fourcc, this function +returns FALSE. + + TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a 32bit unsigned int to set + + + + + + Sets the integers pointed to by @value_numerator and @value_denominator +corresponding to the value of the given field. Caller is responsible +for making sure the field exists and has the correct type. +with @fieldname or the existing field did not contain a GstFraction, this +function returns FALSE. + + TRUE if the values could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to an int to set + + + + a pointer to an int to set + + + + + + Sets the int pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain an int, this function +returns %FALSE. + + %TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to an int to set + + + + + + Get the name of @structure as a string. + + the name of the structure. + + + + + Get the name of @structure as a GQuark. + + the quark representing the name of the structure. + + + + + Finds the field corresponding to @fieldname, and returns the string +contained in the field's value. Caller is responsible for making +sure the field exists and has the correct type. +The string should not be modified, and remains valid until the next +call to a gst_structure_*() function with the given structure. +or did not contain a string. + + a pointer to the string or NULL when the field did not exist + + + + + the name of a field + + + + + + Sets the uint pointed to by @value corresponding to the value of the +given field. Caller is responsible for making sure the field exists +and has the correct type. +with @fieldname or the existing field did not contain a uint, this function +returns %FALSE. + + %TRUE if the value could be set correctly. If there was no field + + + + + the name of a field + + + + a pointer to a uint to set + + + + + + Parses the variable arguments and reads fields from @structure accordingly. +valist-variant of gst_structure_get(). Look at the documentation of +gst_structure_get() for more details. + + TRUE, or FALSE if there was a problem reading any of the fields + + + + + the name of the first field to read + + + + variable arguments + + + + + + Get the value of the field with name @fieldname. + + the #GValue corresponding to the field with the given name. + + + + + the name of the field to get + + + + + + Check if @structure contains a field named @fieldname. + + TRUE if the structure contains a field with the given name + + + + + the name of a field + + + + + + Check if @structure contains a field named @fieldname and with GType @type. + + TRUE if the structure contains a field with the given name and type + + + + + the name of a field + + + + the type of a value + + + + + + Checks if the structure has the given name + + TRUE if @name matches the name of the structure. + + + + + structure name to check for + + + + + Parses the variable arguments and reads fields from @structure accordingly. Variable arguments should be in the form field id quark, field type (as a GType), pointer(s) to a variable(s) to hold the return value(s). The last variable argument should be NULL (technically it should be a 0 quark, but we require NULL so compilers that support it can check for -the NULL terminator and warn if it's not there). +the NULL terminator and warn if it's not there). This function is just like gst_structure_get() only that it is slightly more efficient since it saves the string-to-quark lookup in the global quark hashtable. @@ -15807,13 +18844,14 @@ you must release with a suitable _unref() when no longer needed. For strings and boxed types you will acquire a copy which you will need to release with either g_free() or the suiteable function for the boxed type. because the field requested did not exist, or was of a type other -than the type specified), otherwise TRUE." - version="0.10.24"> +than the type specified), otherwise TRUE. - + FALSE if there was a problem reading any of the fields (e.g. + + the quark of the first field to read @@ -15822,486 +18860,378 @@ than the type specified), otherwise TRUE." - + + Parses the variable arguments and reads fields from @structure accordingly. +valist-variant of gst_structure_id_get(). Look at the documentation of +gst_structure_id_get() for more details. + TRUE, or FALSE if there was a problem reading any of the fields + + + + + the quark of the first field to read + + + + variable arguments + + + + + + Get the value of the field with GQuark @field. +identifier. + + the #GValue corresponding to the field with the given name + the #GQuark of the field to get - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Check if @structure contains a field named @field. - + TRUE if the structure contains a field with the given name + + #GQuark of the field name + Check if @structure contains a field named @field and with GType @type. - + TRUE if the structure contains a field with the given name and type + + #GQuark of the field name + the type of a value - + + Identical to gst_structure_set, except that field names are +passed using the GQuark for the field name. This allows more efficient +setting of the structure if the caller already knows the associated +quark values. +The last variable argument must be NULL. - + - + the GQuark for the name of the field to set + + + + + - + + va_list form of gst_structure_id_set(). - + - + the name of the field to set + - - + + variable arguments + - + + Sets the field with the given GQuark @field to @value. If the field +does not exist, it is created. If the field exists, the previous +value is replaced and freed. - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + a #GQuark representing a field + - + the new value of the field + - + + Sets the field with the given GQuark @field to @value. If the field +does not exist, it is created. If the field exists, the previous +value is replaced and freed. - + - - + + a #GQuark representing a field + - - + + the new value of the field + - + + Calls the provided function once for each field in the #GstStructure. In +contrast to gst_structure_foreach(), the function may modify but not delete the +fields. The structure must be mutable. +FALSE otherwise. + TRUE if the supplied function returns TRUE For each of the fields, + + + + + a function to call for each field + + + + private data + + + + + + Get the number of fields in the structure. + + the number of fields in the structure + + + + + Get the name of the given field number, counting from 0 onwards. + + the name of the given field number - - + + the index to get the name of + - + + Removes all fields in a GstStructure. - + + + + + Removes the field with the given name. If the field with the given +name does not exist, the structure is unchanged. + + + the name of the field to remove - - - - - - - + + Removes the fields with the given names. If a field does not exist, the +argument is ignored. - + + the name of the field to remove - - - - - + + + - + va_list form of gst_structure_remove_fields(). + + + + + + the name of the field to remove + + + + NULL-terminated list of more fieldnames to remove + + + + + + Parses the variable arguments and sets fields accordingly. +Variable arguments should be in the form field name, field type +(as a GType), value(s). The last variable argument should be NULL. + + + + + + the name of the field to set + + + + + + + + + + Sets the name of the structure to the given @name. The string +provided is copied before being used. It must not be empty, start with a +letter and can be followed by letters, numbers and any of "/-_.:". + + + + + + the new name of the structure + + + + + + Sets the parent_refcount field of #GstStructure. This field is used to +determine whether a structure is mutable or not. This function should only be +called by code implementing parent objects of #GstStructure, as described in +the MT Refcounting section of the design documents. + + + + + + a pointer to the parent's refcount + + + + + + va_list form of gst_structure_set(). + + + + + + the name of the field to set + + + + variable arguments + + + + + + Sets the field with the given name @field to @value. If the field +does not exist, it is created. If the field exists, the previous +value is replaced and freed. + + + + + + the name of the field to set + + + + the new value of the field + + + + + + Sets the field with the given name @field to @value. If the field +does not exist, it is created. If the field exists, the previous +value is replaced and freed. The function will take ownership of @value. + + + + + + the name of the field to set + + + + the new value of the field + + + + + + Converts @structure to a human-readable string representation. For debugging purposes its easier to do something like this: |[ -GST_LOG ("structure is %" GST_PTR_FORMAT, structure); +GST_LOG ("structure is %" GST_PTR_FORMAT, structure); ]| This prints the structure in human readble form. -usage."> - +g_free() after usage. + + (transfer full)L a pointer to string allocated by g_malloc(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + The type of a %GST_MESSAGE_STRUCTURE_CHANGE. @@ -16309,65 +19239,75 @@ of the existing field."> value="1" c:identifier="GST_STRUCTURE_CHANGE_TYPE_PAD_UNLINK"/> - + A function that will be called in gst_structure_foreach(). The function may not modify @value. -the foreach operation should stop with FALSE."> +the foreach operation should stop with FALSE. - + TRUE if the foreach operation should continue, FALSE if + + the #GQuark of the field name + the #GValue of the field - + user data + - + A function that will be called in gst_structure_map_in_place(). The function may modify @value. -the map operation should stop with FALSE."> +the map operation should stop with FALSE. - + TRUE if the map operation should continue, FALSE if + + the #GQuark of the field name + the #GValue of the field - + user data + - The default implementation of a #GstClock that uses the system time. + + Get a handle to the default system clock. The refcount of the clock will be increased so you need to unref the clock after usage. -MT safe."> +MT safe. + the default clock. - - + + @@ -16376,14 +19316,14 @@ MT safe."> - + - + @@ -16395,223 +19335,258 @@ MT safe."> - + - + - + - + - + - + - + - + - + - + + + + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + - + + + + + + + - + - + - + - + - + + + + - + - + - + + + + - + - + + + + + + + - + - + - + - + - + + + + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + + Extra tag flags used when registering tags. @@ -16620,53 +19595,59 @@ MT safe."> - + + A function that will be called in gst_tag_list_foreach(). The function may +not modify the tag list. + the #GstTagList + a name of a tag in @list - + user data + - + glib:get-type="gst_tag_list_get_type" + c:symbol-prefix="tag_list"> + Opaque #GstTagList data structure. + + Creates a new empty GstTagList. + An empty tag list + Creates a new taglist and appends the values for the given tags. It expects tag-value pairs like gst_tag_list_add(), and a NULL terminator after the last pair. The type of the values is implicit and is documented in the API reference, but can also be queried at runtime with gst_tag_get_type(). It is an error to pass a value of a type not matching the tag type into this function. The tag list will make copies of any arguments passed (e.g. strings, buffers). -needed." - version="0.10.24"> - +when no longer needed. + + a new #GstTagList. Free with gst_tag_list_free() + tag @@ -16675,82 +19656,36 @@ needed." - - - - - - - - - - - - - - - - - - - - - - - - + + Just like gst_tag_list_new_full(), only that it takes a va_list argument. +Useful mostly for language bindings. +when no longer needed. + a new #GstTagList. Free with gst_tag_list_free() - - - - - + + tag / value pairs to set + - - - - - - - - - - - - - - - - - + + + Sets the values for the given tags using the specified mode. + the mode to use + tag @@ -16759,60 +19694,104 @@ copy of the other is returned. If both lists are NULL, NULL is returned."> - + + Sets the values for the given tags using the specified mode. + the mode to use + tag - - - + + tag / value pairs to set + + + + + + Sets the GValues for the given tags using the specified mode. + + + + + + the mode to use + + + + tag + + + + tag / GValue pairs to set + + Sets the GValue for a given tag using the specified mode. + the mode to use + tag + GValue for this tag - + + Sets the GValues for the given tags using the specified mode. + + the mode to use + + + tag + + + + - + + Copies a given #GstTagList. + + copy of the given list + + + + + Calls the given function for each tag inside the tag list. Note that if there +is no tag, the function won't be called at all. @@ -16820,635 +19799,967 @@ is no tag, the function won't be called at all."> + closure="1"> + function to be called for each tag - + user specified data + - + + Frees the given list and all associated values. - + - - - - - - - - - + Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. -given list."> +given list. - + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + tag to read out - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + location for the result + + Gets the value that is at the given index for the given tag in the given list. -given list."> +given list. - + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + tag to read out - + number of entry to read out + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + location for the result + + Copies the first buffer for the given tag in the taglist into the variable pointed to by @value. Free the buffer with gst_buffer_unref() when it is no longer needed. -given list or if it was #NULL." - version="0.10.23"> +given list or if it was #NULL. - + TRUE, if a buffer was copied, FALSE if the tag didn't exist in the + + tag to read out - + + address of a GstBuffer pointer variable to store the result into + Gets the buffer that is at the given index for the given tag in the given list and copies it into the variable pointed to by @value. Free the buffer with gst_buffer_unref() when it is no longer needed. -given list or if it was #NULL." - version="0.10.23"> +given list or if it was #NULL. - + TRUE, if a buffer was copied, FALSE if the tag didn't exist in the + + tag to read out - + number of entry to read out + - + + address of a GstBuffer pointer variable to store the result into + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the first date for the given tag in the taglist into the variable +pointed to by @value. Free the date with g_date_free() when it is no longer +needed. +given list or if it was #NULL. + + TRUE, if a date was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + address of a GDate pointer variable to store the result into + + + + + + Gets the date that is at the given index for the given tag in the given +list and copies it into the variable pointed to by @value. Free the date +with g_date_free() when it is no longer needed. +given list or if it was #NULL. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the first datetime for the given tag in the taglist into the variable +pointed to by @value. Unref the date with gst_date_time_unref() when +it is no longer needed. +thegiven list or if it was #NULL. + + TRUE, if a datetime was copied, FALSE if the tag didn't exist in + + + + + tag to read out + + + + address of a #GstDateTime pointer variable to store the result into + + + + + + Gets the datetime that is at the given index for the given tag in the given +list and copies it into the variable pointed to by @value. Unref the datetime +with gst_date_time_unref() when it is no longer needed. +given list or if it was #NULL. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, possibly merging +multiple values into one if multiple values are associated with the tag. +Use gst_tag_list_get_string_index (list, tag, 0, value) if you want +to retrieve the first string associated with this tag unmodified. +The resulting string in @value will be in UTF-8 encoding and should be +freed by the caller using g_free when no longer needed. Since 0.10.24 the +returned string is also guaranteed to be non-NULL and non-empty. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +The resulting string in @value will be in UTF-8 encoding and should be +freed by the caller using g_free when no longer needed. Since 0.10.24 the +returned string is also guaranteed to be non-NULL and non-empty. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Checks how many value are stored in this tag list for the given tag. + + The number of tags stored + + + + + the tag to query + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Copies the contents for the given tag into the value, merging multiple values +into one if multiple values are associated with the tag. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +given list. + + TRUE, if a value was copied, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Gets the value that is at the given index for the given tag in the given +list. +tag wasn't available or the tag doesn't have as many entries + + The GValue for the specified entry or NULL if the + + + + + tag to read out + + + + number of entry to read out + + + + + + Inserts the tags of the @from list into the first list using the given mode. + + + + + + list to merge from + + + + the mode to use + + + + + + Checks if the given taglist is empty. + + TRUE if the taglist is empty, otherwise FALSE. + + + + + Merges the two given lists into a new list. If one of the lists is NULL, a +copy of the other is returned. If both lists are NULL, NULL is returned. + + the new list + + + + + second list to merge + + + + the mode to use + + + + + + Peeks at the value that is at the given index for the given tag in the given +list. +The resulting string in @value will be in UTF-8 encoding and doesn't need +to be freed by the caller. The returned string is also guaranteed to +be non-NULL and non-empty. +given list. + + TRUE, if a value was set, FALSE if the tag didn't exist in the + + + + + tag to read out + + + + number of entry to read out + + + + location for the result + + + + + + Removes the given tag from the taglist. + + + + + + tag to remove + + + + - + + A function for merging multiple values of a tag used when registering +tags. + the destination #GValue + the source #GValue - + The different tag merging modes are basically replace, overwrite and append, already in the element and (B) the ones that are supplied to the element ( e.g. via gst_tag_setter_merge_tags() / gst_tag_setter_add_tags() or a %GST_EVENT_TAG), how are these tags merged? In the table below this is shown for the cases that a tag exists in the list (A) or does not exists (!A) and combinations thereof. -<table frame="all" colsep="1" rowsep="1"> +<table frame="all" colsep="1" rowsep="1"> <title>merge mode</title> -<tgroup cols='5' align='left'> +<tgroup cols='5' align='left'> <thead> <row> <entry>merge mode</entry> @@ -17503,8 +20814,7 @@ In the table below this is shown for the cases that a tag exists in the list </row> </tbody> </tgroup> -</table>" - c:type="GstTagMergeMode"> +</table> @@ -17519,152 +20829,212 @@ In the table below this is shown for the cases that a tag exists in the list + Opaque #GstTagSetter data structure. - - - - - - - - - - - - - - - - - - - + + Adds the given tag / value pairs on the setter using the given merge mode. +The list must be terminated with NULL. + the mode to use + tag to set - - - + + tag / value pairs to set + - + + Adds the given tag / GValue pairs on the setter using the given merge mode. +The list must be terminated with NULL. + the mode to use + tag to set - - - + + tag / GValue pairs to set + + Adds the given tag / GValue pair on the setter using the given merge mode. + the mode to use + tag to set + GValue to set for the tag - - - - - - + + Adds the given tag / GValue pairs on the setter using the given merge mode. +The list must be terminated with NULL. + the mode to use + + + + tag to set + + + + + + + + + + Adds the given tag / value pairs on the setter using the given merge mode. +The list must be terminated with NULL. + + + + + + the mode to use + + + + tag to set + + + + + + + + + + Returns the current list of tags the setter uses. The list should not be +modified or freed. +This function is not thread-safe. +setter or NULL if none is used. + + a current snapshot of the taglist used in the + + + + + Queries the mode by which tags inside the setter are overwritten by tags +from events + + the merge mode used inside the element. + + + + + Merges the given list into the setter's list using the given mode. + + + + + + a tag list to merge from + + + + the mode to merge with - - - + + Reset the internal taglist. Elements should call this from within the +state-change handler. + + + + Sets the given merge mode that is used for adding tags from events to tags +specified by this interface. The default is #GST_TAG_MERGE_KEEP, which keeps +the tags set with this interface and discards tags from events. + + + + + + The mode with which tags are added + + + + - + + #GstTagSetterIFace interface. - The #GstTask object. + + Wait for all tasks to be stopped. This is mainly used internally to ensure proper cleanup of internal data structures in test suites. -MT safe."> +MT safe. + Create a new Task that will repeatedly call the provided @func with @data as a parameter. Typically the task will run in a new thread. The function cannot be changed after the task has been created. You @@ -17673,168 +21043,176 @@ This function will not yet create and start a thread. Use gst_task_start() or gst_task_pause() to create and start the GThread. Before the task can be used, a #GStaticRecMutex must be configured using the gst_task_set_lock() function. This lock will always be acquired while -MT safe."> +MT safe. + A new #GstTask. - + + The #GstTaskFunction to use - + User data to pass to @func + - - - - - - - - - - - - - - - - - - - - + Get the #GstTaskPool that this task will use for its streaming threads. MT safe. -after usage." - version="0.10.24"> +after usage. + the #GstTaskPool used by @task. gst_object_unref() - + + Get the current state of the task. +MT safe. - - - - - - - - - - - - - - - - - - - - - - - - - - + The #GstTaskState of the task - - - - - - - - - - - - - - - - - - - - - - - - - - + Joins @task. After this call, it is safe to unref the task and clean up the lock set with gst_task_set_lock(). The task will automatically be stopped with this call. This function cannot be called from within a task function as this would cause a deadlock. The function will detect this and print a g_warning. -MT safe."> +MT safe. - + %TRUE if the task could be joined. + + + + + Pauses @task. This method can also be called on a task in the +stopped state, in which case a thread will be started and will remain +in the paused state. This function does not wait for the task to complete +the paused state. +MT safe. + + %TRUE if the task could be paused. + + + + + Set the mutex used by the task. The mutex will be acquired before +calling the #GstTaskFunction. +This function has to be called before calling gst_task_pause() or +gst_task_start(). +MT safe. + + + + + + The #GMutex to use + + + + + + Set @pool as the new GstTaskPool for @task. Any new streaming threads that +will be created by @task will now use @pool. +MT safe. + + + + + + a #GstTaskPool + + + + + + Changes the priority of @task to @priority. +MT safe. + + + + + + a new priority for @task + + + + + + Sets the state of @task to @state. +The @task must have a lock associated with it using +gst_task_set_lock() when going to GST_TASK_STARTED or GST_TASK_PAUSED or +this function will return %FALSE. +MT safe. + + %TRUE if the state could be changed. + + + + + the new task state + + + + + + Set callbacks which will be executed when a new thread is needed, the thread +function is entered and left and when the thread is joined. +By default a thread for @task will be created from a default thread pool. +Objects can use custom GThreads or can perform additional configuration of +the threads (such as changing the thread priority) by installing callbacks. +MT safe. + + + + + + a #GstTaskThreadCallbacks pointer + + + + user data passed to the callbacks + + + + called when @user_data is no longer referenced + + + + + + Starts @task. The @task must have a lock associated with it using +gst_task_set_lock() or this function will return %FALSE. +MT safe. + + %TRUE if the task could be started. + + + + + Stops @task. This method merely schedules the task to stop and +will not wait for the task to have completely stopped. Use +gst_task_join() to stop and wait for completion. +MT safe. + + %TRUE if the task could be stopped. + @@ -17853,10 +21231,10 @@ MT safe."> - + - + @@ -17866,7 +21244,7 @@ MT safe."> - + @@ -17885,128 +21263,151 @@ MT safe."> - + - + + A function that will repeatedly be called in the thread created by +a #GstTask. - + user data passed to the function + + The #GstTaskPool object. - + Create a new default task pool. The default task pool will use a regular +GThreadPool for threads. + + a new #GstTaskPool. gst_object_unref() after usage. - + + Wait for all tasks to be stopped. This is mainly used internally +to ensure proper cleanup of internal data structures in test suites. +MT safe. - - - - - - - - - - - - - - - - - - - + + Join a task and/or return it to the pool. @id is the id obtained from +gst_task_pool_push(). - + the id + + + Prepare the taskpool for accepting gst_task_pool_push() operations. +MT safe. + + + + + + Start the execution of a new thread from @pool. +function. This pointer can be NULL, you must check @error to detect +errors. + + a pointer that should be used for the gst_task_pool_join + + + + + the function to call + + + + data to pass to @func + + + + + + Wait for all tasks to be stopped. This is mainly used internally +to ensure proper cleanup of internal data structures in test suites. +MT safe. + + + + + + Join a task and/or return it to the pool. @id is the id obtained from +gst_task_pool_push(). + + + + + + the id + + + + + Prepare the taskpool for accepting gst_task_pool_push() operations. +MT safe. - - + Start the execution of a new thread from @pool. +function. This pointer can be NULL, you must check @error to detect +errors. + + a pointer that should be used for the gst_task_pool_join + - + + the function to call - + data to pass to @func + - - - - - - - - - - - - - - - @@ -18015,19 +21416,19 @@ MT safe." - + + glib:is-gtype-struct-for="TaskPool"> + The #GstTaskPoolClass object. - + @@ -18039,7 +21440,7 @@ MT safe." - + @@ -18050,26 +21451,29 @@ MT safe." - - - - + + + + a pointer that should be used for the gst_task_pool_join + - + + the function to call - + data to pass to @func + - + @@ -18078,116 +21482,126 @@ MT safe." - + the id + - + + Task function, see gst_task_pool_push(). - + user data for the task function + - + - + + The different states a task can be in + Custom GstTask thread callback functions that can be installed. - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + - + + Opaque #GstTrace structure. - + - + - + - - - - - - - - - - - - - - + + Flush an close the previously allocated @trace. - + + Flush any pending trace entries in @trace to the trace file. +flushed. - + Set the default #GstTrace to @trace. + + + + + + Flush any pending trace entries in @trace to the trace file, formatted as a text line with timestamp and sequence numbers. -flushed."> - - - - - +flushed. @@ -18195,84 +21609,136 @@ flushed."> - + - + - + - + - + + Object that stores typefind callbacks. To use with #GstTypeFindFactory. - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + - + + + + + + + + + + - + - + - + Get the length of the data stream. + + The length of the data stream, or 0 if it is not available. + + + + + Returns the @size bytes of the stream to identify beginning at offset. If offset is a positive number, the offset is relative to the beginning of the stream, if offset is a negative number the offset is relative to the end of the stream. The returned memory is valid until the typefinding function -returns and must not be freed."> - - - +returns and must not be freed. +if that data is not available. + + the requested data, or NULL + + - + The offset + - - + + The number of bytes to return + - + If a #GstTypeFindFunction calls this function it suggests the caps with the given probability. A #GstTypeFindFunction may supply different suggestions in one call. -It is up to the caller of the #GstTypeFindFunction to interpret these values."> +It is up to the caller of the #GstTypeFindFunction to interpret these values. - + The probability in percent that the suggestion is right + + The fixed #GstCaps to suggest + If a #GstTypeFindFunction calls this function it suggests the caps with the given probability. A #GstTypeFindFunction may supply different suggestions in one call. It is up to the caller of the #GstTypeFindFunction to interpret these values. @@ -18282,19 +21748,21 @@ way as you can with gst_caps_new_simple(). Make sure you terminate the list of arguments with a NULL argument and that the values passed have the correct type (in terms of width in bytes when passed to the vararg function - this applies particularly to gdouble and -guint64 arguments)." - version="0.10.20"> +guint64 arguments). - + The probability in percent that the suggestion is right + + the media type of the suggested caps + first field of the suggested caps, or NULL @@ -18303,84 +21771,83 @@ guint64 arguments)." - - - - - - Object that stores information about a typefind function. + + Gets the list of all registered typefind factories. You must free the +list using gst_plugin_feature_list_free(). The returned factories are sorted by highest rank first, and then by -factory name. (behaviour change since 0.10.26)"> +factory name. (behaviour change since 0.10.26) +registered #GstTypeFindFactory. - + the list of all + + + - - - - - - - - - - - - + c:identifier="gst_type_find_factory_call_function"> + Calls the #GstTypeFindFunction associated with this factory. + a properly setup #GstTypeFind entry. The get_data and suggest_type members must be set. + + Gets the #GstCaps associated with a typefind factory. + + the #GstCaps associated with this factory + + + + + Gets the extensions associated with a #GstTypeFindFactory. The returned +array should not be changed. If you need to change stuff in it, you should +copy it using g_strdupv(). This function may return NULL to indicate +a 0-length list. +NULL-terminated array of extensions associated with this factory + + a + + + + + - + - + - + - - + + - + - + - + @@ -18390,31 +21857,31 @@ Calls the #GstTypeFindFunction associated with this factory."> - + - + - + + A function that will be called by typefinding. + A #GstTypeFind structure - + optionnal data to pass to the function + - + + The probability of the typefind function. Higher values have more certainty +in doing a reliable typefind. - + + Structure used for filtering based on @name and @type. @@ -18436,103 +21902,112 @@ in doing a reliable typefind." + Opaque #GstURIHandler structure. + Gets the currently handled URI. +Returns NULL if there are no URI currently handled. The +returned string must not be modified or freed. + the URI currently handled by the @handler. + Tries to set the URI of the given handler. - + TRUE if the URI was set successfully, else FALSE. + + URI to set - - - - - + Gets the list of protocols supported by @handler. This list may not be modified. -Returns NULL if the @handler isn't implemented properly, or the @handler -doesn't support any protocols."> - +supported protocols. Returns NULL if the @handler isn't implemented +properly, or the @handler doesn't support any protocols. + + the - + + Gets the currently handled URI. +Returns NULL if there are no URI currently handled. The +returned string must not be modified or freed. + the URI currently handled by the @handler. - + + Gets the type of the given URI handler +Returns #GST_URI_UNKNOWN if the @handler isn't implemented correctly. - + the #GstURIType of the URI handler. + - - - - - - + + Emits the new-uri signal for a given handler, when that handler has a new URI. +This function should only be called by URI handlers themselves. + new URI or NULL if it was unset - - - + + Tries to set the URI of the given handler. + + TRUE if the URI was set successfully, else FALSE. + - + URI to set + + + + + + The URI of the given @handler has changed. + + + + + + The new URI, or NULL if the URI was removed + + glib:is-gtype-struct-for="URIHandler"> + Any #GstElement using this interface should implement these methods. - + @@ -18547,15 +22022,15 @@ Any #GstElement using this interface should implement these methods."> - - + + - - - + + + @@ -18563,8 +22038,9 @@ Any #GstElement using this interface should implement these methods."> - + + the URI currently handled by the @handler. @@ -18575,23 +22051,25 @@ Any #GstElement using this interface should implement these methods."> - + - + TRUE if the URI was set successfully, else FALSE. + + URI to set - - + + @@ -18601,9 +22079,9 @@ Any #GstElement using this interface should implement these methods."> - - - + + + @@ -18617,119 +22095,131 @@ Any #GstElement using this interface should implement these methods."> - + - - - - + + The different types of URI direction. - + - + - + - + - + - + + Used together with gst_value_compare() to compare #GValue items. +or GST_VALUE_UNORDERED - + one of GST_VALUE_LESS_THAN, GST_VALUE_EQUAL, GST_VALUE_GREATER_THAN + + first value for comparison + second value for comparison - + + Used by gst_value_deserialize() to parse a non-binary form into the #GValue. - + %TRUE for success + + a #GValue + a string - + Used by gst_value_intersect() to perform intersection for a specific #GValue type. If the intersection is non-empty, the result is placed in @dest and TRUE is returned. If the intersection is empty, @dest is unmodified and FALSE is returned. -Register a new implementation with gst_value_register_intersect_func()."> +Register a new implementation with gst_value_register_intersect_func(). - + %TRUE if the values can intersect + - + + a #GValue for the result + a #GValue operand + a #GValue operand - + + Used by gst_value_serialize() to obtain a non-binary form of the #GValue. + the string representation of the value + a #GValue - + + Used by gst_value_subtract() to perform subtraction for a specific #GValue +type. Register a new implementation with gst_value_register_subtract_func(). - + %TRUE if the subtraction is not empty + - + + a #GValue for the result + a #GValue operand + a #GValue operand - + + VTable for the #GValue @type. @@ -18743,71 +22233,98 @@ type. Register a new implementation with gst_value_register_subtract_func()."> - - + + - + + Used by gst_value_union() to perform unification for a specific #GValue +type. Register a new implementation with gst_value_register_union_func(). - + %TRUE if a union was successful + + a #GValue for the result + a #GValue operand + a #GValue operand - + XML parser object + + Create a new GstXML parser object. + a pointer to a new GstXML object. - - - - - - - - - - - + introspectable="0"> + Load the element from the XML description + + the new element + the xml node + the parent of this object when it's loaded + + Converts the given element into an XML presentation. + + a pointer to an XML document + + + + + The element to write out + + + + + + Converts the given element into XML and writes the formatted XML to an open +file. + + number of bytes written on success, -1 otherwise. + + + + + The element to write out + + + + an open file, like stdout + + + + @@ -18821,121 +22338,129 @@ type. Register a new implementation with gst_value_register_union_func()."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This function is used to get a pointer to the GstElement corresponding to name in the pipeline description. You would use this if you have -to do anything to the element after loading."> - +to do anything to the element after loading. + + a pointer to a new GstElement, caller owns returned reference. - - - + The name of element to retrieve + + Retrieve a list of toplevel elements. of the list and must not free or modify the list. The caller also does not own a reference to any of the elements in the list and should obtain its own -reference using gst_object_ref() if necessary."> - - +reference using gst_object_ref() if necessary. + + a GList of top-level elements. The caller does not own a copy + + + + + Fills the GstXML object with the elements from the +xmlDocPtr. + + TRUE on success, FALSE otherwise + + + + + a pointer to an xml document to parse + + + + The name of the root object to build + + + + + + Fills the GstXML object with the corresponding elements from +the XML file fname. Optionally it will only build the element from +the element node root (if it is not NULL). This feature is useful +if you only want to build a specific element from an XML file +but not the pipeline it is embedded in. +Pass "-" as fname to read from stdin. You can also pass a URI +of any format that libxml supports, including http. + + TRUE on success, FALSE otherwise + + + + + The filename with the xml description + + + + The name of the root object to build + + + + + + Fills the GstXML object with the corresponding elements from +an in memory XML buffer. + + TRUE on success + + + + + a pointer to the in memory XML buffer + + + + the size of the buffer + + + + the name of the root objects to build + + + + - + + + - + - - - + + Signals that a new object has been deserialized. + + - + the object that has been loaded + - - + + the related xml_node pointer to the document tree + @@ -18947,7 +22472,7 @@ reference using gst_object_ref() if necessary."> - + @@ -18965,7 +22490,7 @@ reference using gst_object_ref() if necessary."> - + @@ -18984,171 +22509,198 @@ reference using gst_object_ref() if necessary."> - + + c:identifier="gst_alloc_trace_available"> + Check if alloc tracing was compiled into the core +tracing enabled. - + TRUE if the core was compiled with alloc + - + introspectable="0"> + Get the named alloc trace object. +no alloc tracer was registered with that name. + + a GstAllocTrace with the given name or NULL when + the name of the alloc trace object - + + Get a list of all registered alloc trace objects. - + a GList of GstAllocTrace objects. + + + + c:identifier="gst_alloc_trace_live_all"> + Get the total number of live registered alloc trace objects. - + the total number of live registered alloc trace objects. + + c:identifier="gst_alloc_trace_print_all"> + Print the status of all registered alloc trace objects. + c:identifier="gst_alloc_trace_print_live"> + Print the status of all registered alloc trace objects, ignoring those +without live objects. + c:identifier="gst_alloc_trace_set_flags_all"> + Enable the specified options on all registered alloc trace +objects. + the options to enable + Unconditionally sets the atomic integer to @value. - - + + pointer to an atomic integer + - + value to set + - - - - - - - - - - - + + Converts @caps from a string representation. + a newly allocated #GstCaps + a string to convert to #GstCaps - + + Creates a #GstCaps from its XML serialization. + a new #GstCaps structure + a XML node + + Replaces *caps with @newcaps. Unrefs the #GstCaps in the location +pointed to by @caps, if applicable, then modifies @caps to point to +This function does not take any locks so you might want to lock +the object owning @caps pointer. + + + + + + a pointer to #GstCaps + + + + a #GstCaps to replace *caps + + + + + c:identifier="gst_child_proxy_child_added"> + Emits the "child-added" signal. + the parent object + the newly added child + c:identifier="gst_child_proxy_child_removed"> + Emits the "child-removed" signal. + the parent object + the removed child + introspectable="0"> + Gets properties of the parent object and its children. + the parent object + name of the first property to get @@ -19158,59 +22710,102 @@ MT safe." + c:identifier="gst_child_proxy_get_property"> + Gets a single property using the GstChildProxy mechanism. +You are responsible for for freeing it by calling g_value_unset() + object to query + name of the property - + + a #GValue that should take the result. - + + Gets properties of the parent object and its children. - + + the object to query + + + + name of the first property to get + + + + return location for the first property, followed optionally by more name/return location pairs, followed by NULL + + + + + + Looks up which object and #GParamSpec would be effected by the given @name. +case the values for @pspec and @target are not modified. Unref @target after +usage. +MT safe. + + TRUE if @target and @pspec could be found. FALSE otherwise. In that + + + + + object to lookup the property in + name of the property to look up - + + pointer to a #GstObject that takes the real object to set property on - + + pointer to take the #GParamSpec describing the property + introspectable="0"> + Sets properties of the parent object and its children. + the parent object + name of the first property to set @@ -19220,27 +22815,52 @@ MT safe."> + c:identifier="gst_child_proxy_set_property"> + Sets a single property using the GstChildProxy mechanism. + the parent object + name of the property to set + new #GValue for the property + + Sets properties of the parent object and its children. + + + + + + the parent object + + + + name of the first property to set + + + + value for the first property, followed optionally by more name/value pairs, followed by NULL + + + + - + @@ -19250,148 +22870,174 @@ MT safe."> - + - + + c:identifier="gst_class_signal_emit_by_name"> + emits the named class signal. + a #GstObject that emits the signal + the name of the signal to emit + data for the signal + + + + + + introspectable="0"> + Adds the logging function to the list of logging functions. +Be sure to use #G_GNUC_NO_INSTRUMENT on that function, it is needed. - + + the function to use - + user data + + Constructs a string that can be used for getting the desired color in color terminals. -You need to free the string after use."> +You need to free the string after use. +definition - + a string containing the color + - + the color info + + Constructs an integer that can be used for getting the desired color in +windows' terminals (cmd.exe). As there is no mean to underline, we simply +ignore this attribute. +This function returns 0 on non-windows machines. - + an integer containing the color definition + - + the color info + + Returns a snapshot of a all categories that are currently in use . This list may change anytime. -The caller has to free the list after use."> - - +The caller has to free the list after use. +debug categories + + the list of + + + - + c:identifier="gst_debug_get_default_threshold"> + Returns the default threshold that is used for new categories. + + the default threshold level - + + Checks if debugging output is activated. - + TRUE, if debugging is activated + - + + Checks if the debugging output should be colored. - + TRUE, if the debug output should be colored. + + c:identifier="gst_debug_level_get_name"> + Get the string representation of a debugging level + the name + the level to get the name for - + + Logs the given message using the currently registered debugging handlers. + category to log + level of the message is in + the file that emitted the message, usually the __FILE__ identifier + the function that emitted the message - + the line from that the message was emitted, usually __LINE__ + - + + the object this message relates to, or NULL if none + a printf style format string @@ -19400,425 +23046,502 @@ The caller has to free the list after use."> - + The default logging handler used by GStreamer. Logging functions get called whenever a macro like GST_DEBUG or similar is used. This function outputs the -message and additional info using the glib error handler. +message and additional info to stderr (or the log file specified via the +GST_DEBUG_FILE environment variable). You can add other handlers by using gst_debug_add_log_function(). And you can remove this handler by calling -gst_debug_remove_log_function(gst_debug_log_default);"> +gst_debug_remove_log_function(gst_debug_log_default); + category to log + level of the message + the file that emitted the message, usually the __FILE__ identifier + the function that emitted the message - + the line from that the message was emitted, usually __LINE__ + - + + the object this message relates to, or NULL if none + the actual message - + an unused variable, reserved for some user_data. + + + + + + Logs the given message using the currently registered debugging handlers. + + + + + + category to log + + + + level of the message is in + + + + the file that emitted the message, usually the __FILE__ identifier + + + + the function that emitted the message + + + + the line from that the message was emitted, usually __LINE__ + + + + the object this message relates to, or NULL if none + + + + a printf style format string + + + + optional arguments for the format + + c:identifier="gst_debug_print_stack_trace"> + If GST_ENABLE_FUNC_INSTRUMENTATION is defined a stacktrace is available for +gstreamer code, which can be printed with this function. + introspectable="0"> + Removes all registered instances of the given logging functions. - + How many instances of the function were removed + - + + the log function to remove + c:identifier="gst_debug_remove_log_function_by_data"> + Removes all registered instances of log functions with the given user data. - + How many instances of the function were removed + - + user data of the log function to remove + - + If activated, debugging messages are sent to the debugging handlers. It makes sense to deactivate it for speed issues. <note><para>This function is not threadsafe. It makes sense to only call it -during initialization.</para></note>"> +during initialization.</para></note> - + Whether to use debugging output or not + - + + Sets or unsets the use of coloured debugging output. +This function may be called before gst_init(). - + Whether to use colored output or not + + c:identifier="gst_debug_set_default_threshold"> + Sets the default threshold to the given level and updates all categories to +use this threshold. +This function may be called before gst_init(). + level to set + c:identifier="gst_debug_set_threshold_for_name"> + Sets all categories which match the given glob style pattern to the given +level. + name of the categories to set + level to set them to + c:identifier="gst_debug_unset_threshold_for_name"> + Resets all categories with the given name back to the default level. + name of the categories to set + Checks whether a plugin feature by the given name exists in the default registry and whether its version is at least the version required. -the same as the required version or newer, and #FALSE otherwise."> +the same as the required version or newer, and #FALSE otherwise. - + #TRUE if the feature could be found and the version is + + the name of the feature (e.g. "oggdemux") - + the minimum major version number + - + the minimum minor version number + - + the minimum micro version number + - + Clean up any resources created by GStreamer in gst_init(). It is normally not needed to call this function in a normal application as the resources will automatically be freed when the program terminates. This function is therefore mostly used by testsuites and other memory profiling tools. -After this call GStreamer (including this method) should not be used anymore."> +After this call GStreamer (including this method) should not be used anymore. - + + + + + + + Get a string describing the error message in the current locale. +the error message (in UTF-8 encoding) + a newly allocated string describing + the GStreamer error domain this error belongs to. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the error code belonging to the domain. + + Iterates over the elements in @list, calling @func with the list item data for each item. If @func returns TRUE, @data is prepended to the list of results returned. If @first is true, the search is halted after the first result is found. Since gst_filter_run() knows nothing about the type of @data, no reference will be taken (if @data refers to an object) and no copy of results. -(the data contained in the list is a flat copy and does need to be -unreferenced or freed)."> - - +when no longer needed (the data contained in the list is a flat copy +and does need to be unreferenced or freed). + + the list of results. Free with g_list_free() + + + - + a linked list + + + - + + the function to execute for each item - + flag to stop execution after a successful item + - + user data + - + + Gets a string representing the given flow return. + a static string with the name of the flow return. + a #GstFlowReturn to get the name of. - - + + Get the unique quark for the given GstFlowReturn. +invalid return was specified. + + the quark associated with the flow return or 0 if an + a #GstFlowReturn to get the quark of. - - + + Return the format registered with the given nick. +if the format was not registered. + + The format with @nick or GST_FORMAT_UNDEFINED + The nick of the format - + + Get details about the given format. +MT safe. + The #GstFormatDefinition for @format or NULL on failure. + The format to get details of - + + Get a printable name for the given format. Do not modify or free. +the format is unknown. + a reference to the static name of the format or NULL if + a #GstFormat + introspectable="0"> + Iterate all the registered formats. The format definition is read +only. + a GstIterator of #GstFormatDefinition. - + Create a new GstFormat based on the nick or return an already registered format with that nick. with the same nick. -MT safe."> - +MT safe. + + A new GstFormat or an already registered format + The nick of the new format + The description of the new format - - + + Get the unique quark for the given format. +is unknown. + + the quark associated with the format or 0 if the format + a #GstFormat - + + See if the given format is inside the format array. - + TRUE if the format is found inside the array + + The format array to search + the format to find + + + + + + + + + + + + + + + - - + introspectable="0"> + cast a given object to an interface type, and check whether this +interface is supported for this specific instance. + + a gpointer to the interface type + - - + + the object (any sort) from which to cast to the interface + + the interface type to cast to + c:identifier="gst_implements_interface_check"> + check a given object for an interface implementation, and check +whether this interface is supported for this specific instance. - + whether or not the object implements the given interface + - - + + the object (any sort) from which to check from for the interface + + the interface type to check for - + Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins. Unless the plugin registry is disabled at compile time, the registry will be loaded. By default this will also check if the registry cache needs to be updated and rescan all plugins if needed. See gst_update_registry() for details and section -<link linkend="gst-running">Running GStreamer Applications</link> +<link linkend="gst-running">Running GStreamer Applications</link> for how to disable automatic registry updates. This function should be called before calling any other GLib functions. If this is not an option, your program must initialise the GLib thread system @@ -19830,54 +23553,59 @@ use gst_init_check() instead. </para></note> functions in other glib-style libraries, such as gtk_init(). In particular, unknown command line options cause this function to -abort program execution."> +abort program execution. - + allow-none="1"> + pointer to application's argc + + allow-none="1"> + pointer to application's argv - + Initializes the GStreamer library, setting up internal path lists, registering built-in elements, and loading standard plugins. This function will return %FALSE if GStreamer could not be initialized for some reason. If you want your program to fail fatally, use gst_init() instead. This function should be called before calling any other GLib functions. If this is not an option, your program must initialise the GLib thread system -using g_thread_init() before any other GLib functions are called." - throws="1"> +using g_thread_init() before any other GLib functions are called. - + %TRUE if GStreamer could be initialized. + - + allow-none="1"> + pointer to application's argc + + allow-none="1"> + pointer to application's argv @@ -19886,7 +23614,8 @@ using g_thread_init() before any other GLib functions are called." + Returns a #GOptionGroup with GStreamer's argument specifications. The group is set up to use standard GOption callbacks, so when using this group in combination with GOption parsing methods, all argument parsing and initialization is automated. @@ -19894,118 +23623,227 @@ This function is useful if you want to integrate GStreamer with other libraries that use GOption (see g_option_context_add_group() ). If you use this function, you should make sure you initialise the GLib threading system as one of the very first things in your program -(see the example at the beginning of this section)."> +(see the example at the beginning of this section). + a pointer to GStreamer's option group. - + - + + + + + + + + + + Use this function to check if GStreamer has been initialized with gst_init() +or gst_init_check(). + + TRUE if initialization has been done, FALSE otherwise. + + + + + Checks if the given pointer is a taglist. + + TRUE, if the given pointer is a taglist + - + Object that might be a taglist + - - - + + Create a new iterator. This function is mainly used for objects +implementing the next/resync/free function to iterate a data structure. +For each item retrieved, the @item function is called with the lock +held. The @free function is called when the iterator is freed. +MT safe. + + the new #GstIterator. + + + + + the size of the iterator structure + + + + #GType of children + + + + pointer to a #GMutex. + + + + pointer to a guint32 that is changed when the items in the iterator changed. + + + + function to get next item + + + + function to call on each item retrieved + + + + function to resync the iterator + + + + function to free the iterator + + + + + + Create a new iterator designed for iterating @list. +The list you iterate is usually part of a data structure @owner and is +protected with @lock. +The iterator will use @lock to retrieve the next item of the list and it +will then call the @item function before releasing @lock again. +The @item function usualy makes sure that the item remains alive while +responsible for freeing/unreffing the item after usage as explained in +gst_iterator_next(). +When a concurrent update to the list is performed, usually by @owner while +holding @lock, @master_cookie will be updated. The iterator implementation +will notice the update of the cookie and will return %GST_ITERATOR_RESYNC to +the user of the iterator in the next call to gst_iterator_next(). +MT safe. + + the new #GstIterator for @list. + - + #GType of elements + + + + pointer to a #GMutex protecting the list. + + + + pointer to a guint32 that is incremented when the list is changed. + + + + pointer to the list + + + + + + object owning the list + + + + function to call for each item + + + + function to call when the iterator is freed + - - + + This #GstIterator is a convenient iterator for the common +case where a #GstIterator needs to be returned but only +a single object has to be considered. This happens often +for the #GstPadIterIntLinkFunction. + + the new #GstIterator for @object. + + + + + #GType of the passed object + + + + object that this iterator should return + + + + Function that returns a copy of @object or increases its refcount + + + + Function to be called for freeing @object + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + introspectable="0"> + Creates a new #GParamSpec instance that hold #GstMiniObject references. + a newly allocated #GParamSpec instance + the canonical name of the property + the nickname of the property + a short description of the property + the #GstMiniObject #GType for the property + a combination of #GParamFlags + + + + + + This is a convenience wrapper around gst_parse_launch() to create a #GstBin from a gst-launch-style pipeline description. See gst_parse_launch() and the gst-launch man page for details about the syntax. Ghost pads on the bin for unlinked source or sink pads @@ -20013,25 +23851,27 @@ within the bin can automatically be created (but only a maximum of one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads -yourself)." - version="0.10.3" - throws="1"> +yourself). + a newly-created bin, or NULL if an error occurred. + command line describing the bin - + whether to automatically create ghost pads for unlinked source or sink pads within the bin + + This is a convenience wrapper around gst_parse_launch() to create a #GstBin from a gst-launch-style pipeline description. See gst_parse_launch() and the gst-launch man page for details about the syntax. Ghost pads on the bin for unlinked source or sink pads @@ -20039,80 +23879,106 @@ within the bin can automatically be created (but only a maximum of one ghost pad for each direction will be created; if you expect multiple unlinked source pads or multiple unlinked sink pads and want them all ghosted, you will have to create the ghost pads -yourself)." - version="0.10.20" - throws="1"> +yourself). + a newly-created bin, or NULL if an error occurred. + command line describing the bin - + whether to automatically create ghost pads for unlinked source or sink pads within the bin + - + + a parse context allocated with gst_parse_context_new(), or %NULL + parsing options, or #GST_PARSE_FLAG_NONE - + Allocates a parse context for use with gst_parse_launch_full() or +gst_parse_launchv_full(). +gst_parse_context_free() when no longer needed. + + a newly-allocated parse context. Free with + + + + + Get the error quark used by the parsing subsystem. + + the quark of the parse errors. + + + + + Create a new pipeline based on command line syntax. Please note that you might get a return value that is not %NULL even though the @error is set. In this case there was a recoverable parsing error and you can try to play the pipeline. -element is specified by the @pipeline_description, all elements are put into -a #GstPipeline, which than is returned." - throws="1"> +more than one toplevel element is specified by the @pipeline_description, +all elements are put into a #GstPipeline, which than is returned. + a new element on success, %NULL on failure. If + the command line describing the pipeline + Create a new pipeline based on command line syntax. Please note that you might get a return value that is not %NULL even though the @error is set. In this case there was a recoverable parsing error and you can try to play the pipeline. -element is specified by the @pipeline_description, all elements are put into -a #GstPipeline, which then is returned." - version="0.10.20" - throws="1"> +more than one toplevel element is specified by the @pipeline_description, +all elements are put into a #GstPipeline, which then is returned. + a new element on success, %NULL on failure. If + the command line describing the pipeline - + + a parse context allocated with gst_parse_context_new(), or %NULL + parsing options, or #GST_PARSE_FLAG_NONE - + + Create a new element based on command line syntax. +An error does not mean that the pipeline could not be constructed. + a new element on success and %NULL on failure. + null-terminated array of arguments @@ -20121,286 +23987,223 @@ An error does not mean that the pipeline could not be constructed." + Create a new element based on command line syntax. +An error does not mean that the pipeline could not be constructed. +or a partially-constructed bin or element will be returned and @error will +be set (unless you passed #GST_PARSE_FLAG_FATAL_ERRORS in @flags, then +%NULL will always be returned on failure) + a new element on success; on failure, either %NULL + null-terminated array of arguments - + + a parse context allocated with gst_parse_context_new(), or %NULL + parsing options, or #GST_PARSE_FLAG_NONE - + + Create a new file descriptor set. If @controllable, it +is possible to restart or flush a call to gst_poll_wait() with +gst_poll_restart() and gst_poll_set_flushing() respectively. +Free with gst_poll_free(). + + a new #GstPoll, or %NULL in case of an error. + + + + + whether it should be possible to control a wait. + + + + + + Create a new poll object that can be used for scheduling cancellable +timeouts. +A timeout is performed with gst_poll_wait(). Multiple timeouts can be +performed from different threads. +Free with gst_poll_free(). + + a new #GstPoll, or %NULL in case of an error. + + + + + Print the element argument in a human readable format in the given +GString. + the buffer to print the args in - + initial indentation + + the element to print the args of - + + Write the pad capabilities in a human readable format into +the given GString. + the buffer to print the caps in - + initial indentation + + the pad to print the caps from - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Some functions in the GStreamer core might install a custom SIGSEGV handler to better catch and report errors to the application. Currently this feature is enabled by default when loading plugins. Applications might want to disable this behaviour with the gst_segtrap_set_enabled() function. This is typically done if the application -wants to install its own handler without GStreamer interfering." - version="0.10.10"> +wants to install its own handler without GStreamer interfering. - + %TRUE if GStreamer is allowed to install a custom SIGSEGV handler. + + Applications might want to disable/enable the SIGSEGV handling of +the GStreamer core. See gst_segtrap_is_enabled() for more information. - + whether a custom SIGSEGV handler should be installed. + - - - + + + + + + + + + + + + + - - - - - + Creates a #GstStructure from a string representation. If end is not NULL, a pointer to the place inside the given string where parsing ended will be returned. -be parsed. Free with gst_structure_free() after use."> +not be parsed. Free with gst_structure_free() after use. + a new #GstStructure or NULL when the string could + a string representation of a #GstStructure. - - - - + + pointer to store the end of the string in. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Checks if the given type is already registered. - + TRUE if the type is already registered + + name of the tag + c:identifier="gst_tag_get_description"> + Returns the human-readable description of this tag, You must not change or +free this string. + the human-readable description of this tag + the tag - - + + Gets the flag of @tag. + + the flag of this tag. + the tag @@ -20415,91 +24218,111 @@ free this string."> - + + Gets the #GType used for this tag. + the #GType of this tag + the tag - + + Checks if the given tag is fixed. A fixed tag can only contain one value. +Unfixed tags can contain lists of values. - + TRUE, if the given tag is fixed. + + tag to check + Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. You must g_value_unset() the value after use. -given list."> +given list. - + TRUE, if a value was copied, FALSE if the tag didn't exist in the + - + + uninitialized #GValue to copy into + list to get the tag from + tag to read out + This is a convenience function for the func argument of gst_tag_register(). It concatenates all given strings using a comma. The tag must be registered -as a G_TYPE_STRING or this function will fail."> +as a G_TYPE_STRING or this function will fail. - + + uninitialized GValue to store result in + GValue to copy from + c:identifier="gst_tag_merge_use_first"> + This is a convenience function for the func argument of gst_tag_register(). +It creates a copy of the first value from the list. - + + uninitialized GValue to store result in + GValue to copy from + Registers a new tag type for the use with GStreamer's type system. If a type with that name is already registered, that one is used. -The old registration may have used a different type however. So don't rely +The old registration may have used a different type however. So don't rely on your supplied values. that there can only be one single value for this tag in a tag list and any additional values will silenty be discarded when being added (unless @@ -20512,162 +24335,197 @@ one single value. This may happen from gst_tag_list_get_string(), gst_tag_list_get_int(), gst_tag_list_get_double() etc. What will happen exactly in that case depends on how the tag was registered and if a merge function was supplied and if so which one. -gst_tag_merge_strings_with_comma()."> +gst_tag_merge_strings_with_comma(). + the name or identifier string + a flag describing the type of tag info + the type this data is in + human-readable name + a human-readable description about this tag - + + function for merging multiple values of this tag, or NULL - + + Create a ringbuffer of @size in the file with @filename to +store trace results in. + + a new #GstTrace. + + + + + a filename + + + + the max size of the file + + + + + + Read a platform independent timer value that can be used in +benchmarks. - - + + (out) pointer to hold the result. + - + - + + + + + Registers a new typefind function to be used for typefinding. After +registering this function will be available for typefinding. +This function is typically called during an element's plugin initialization. + + TRUE on success, FALSE otherwise + + A #GstPlugin, or NULL for a static typefind function (note that passing NULL only works in GStreamer 0.10.16 and later) + The name for registering - - + + The rank (or importance) of this typefind function + - + + The #GstTypeFindFunction to use + Optional extensions that could belong to this type + Optionally the caps that could be returned when typefinding succeeds - + Optional user data. This user data must be available until the plugin is unloaded. + - + + a #GDestroyNotify that will be called on @data when the plugin is unloaded. + Helper function which constructs a #GTypeInfo structure and registers a GType, but which generates less linker overhead than a static const #GTypeInfo structure. For further details of the parameters, please see #GTypeInfo in the GLib documentation. Registers type_name as the name of a new static type derived from parent_type. The value of flags determines the nature (e.g. abstract or not) of the type. It works by filling a GTypeInfo struct and calling -g_type_register_static()." - version="0.10.14"> +g_type_register_static(). + A #GType for the newly-registered type. + The GType of the parent type the newly registered type will derive from + NULL-terminated string used as the name of the new type - + Size of the class structure. + - + + Location of the base initialization function (optional). - + + Location of the base finalization function (optional). - + + Location of the class initialization function for class types Location of the default vtable inititalization function for interface types. (optional) - + + Location of the class finalization function for class types. Location of the default vtable finalization function for interface types. (optional) - + User-supplied data passed to the class init/finalize functions. + - - + + Size of the instance (object) structure (required for instantiatable types only). + - - + + The number of pre-allocated (cached) instances to reserve memory for (0 indicates no caching). Ignored on recent GLib's. + - + + Location of the instance initialization function (optional, for instantiatable types only). + A GTypeValueTable function table for generic handling of GValues of this type (usually only useful for fundamental types). + #GTypeFlags for this GType. E.g: G_TYPE_FLAG_ABSTRACT + Forces GStreamer to re-scan its plugin paths and update the default plugin registry. Applications will almost never need to call this function, it is only useful if the application knows new plugins have been installed (or old @@ -20680,387 +24538,500 @@ thread-safe and should therefore not have any dynamic pipelines running any elements or access the GStreamer registry while the update is in progress. Note that this function may block for a significant amount of time. -imply that there were changes), otherwise %FALSE." - version="0.10.12"> +imply that there were changes), otherwise %FALSE. - + %TRUE if the registry has been updated successfully (does not + - + + Constructs a URI for a given valid protocol and location. +URI. Returns NULL if the given URI protocol is not valid, or the given +location is NULL. - + a new string for this + + + + Protocol for URI - + Location for URI + + + - + Extracts the location out of a given valid URI, ie. the protocol and "://" are stripped from the URI, which means that the location returned includes the hostname if one is specified. The returned string must be freed using g_free(). -the URI does not contain a location, an empty string is returned."> +URI. Returns NULL if the URI isn't valid. If the URI does not contain +a location, an empty string is returned. - + the location for this + + + + A URI string - + + Extracts the protocol out of a given valid URI. The returned string must be +freed using g_free(). + The protocol for this URI. + A URI string + Checks if the protocol of a given valid URI matches @protocol. - + %TRUE if the protocol matches. + + a URI string + a protocol string (e.g. "http") - + + Tests if the given string is a valid URI identifier. URIs start with a valid +scheme followed by ":" and maybe a string identifying the location. - + TRUE if the string is a valid URI + + A URI string + Checks if an element exists that supports the given URI protocol. Note +that a positive return value does not imply that a subsequent call to +gst_element_make_from_uri() is guaranteed to work. - + TRUE + + Whether to check for a source or a sink + Protocol that should be checked for (e.g. "http" or "smb") + c:identifier="gst_uri_protocol_is_valid"> + Tests if the given string is a valid protocol identifier. Protocols +must consist of alphanumeric characters, '+', '-' and '.' and must +start with a alphabetic character. See RFC 3986 Section 3.1. - + TRUE if the string is a valid protocol identifier, FALSE otherwise. + + A string + Searches inside @array for @search_data by using the comparison function +As @search_data is always passed as second argument to @search_func it's not required that @search_data has the same type as the array elements. -The complexity of this search function is O(log (num_elements))." - version="0.10.23"> - - +The complexity of this search function is O(log (num_elements)). + + The address of the found element or %NULL if nothing was found + - + the sorted input array + - + number of elements in the array + - + size of every element in bytes + - + + function to compare two elements, @search_data will always be passed as second argument + search mode that should be used - + element that should be found + - + data to pass to @search_func + + Transforms a #gdouble to a fraction and simplifies +the result. - + #gdouble to transform + - - + + pointer to a #gint to hold the result numerator + - - + + pointer to a #gint to hold the result denominator + - + + Dumps the memory block into a hex representation. Useful for debugging. - - - + a pointer to the memory to dump + - + the size of the memory block to dump + + Adds the fractions @a_n/@a_d and @b_n/@b_d and stores +the result in @res_n and @res_d. - + %FALSE on overflow, %TRUE otherwise. + - + Numerator of first value + - + Denominator of first value + - + Numerator of second value + - + Denominator of second value + - - + + Pointer to #gint to hold the result numerator + - - + + Pointer to #gint to hold the result denominator + + + + + + Compares the fractions @a_n/@a_d and @b_n/@b_d and returns +-1 if a < b, 0 if a = b and 1 if a > b. + + -1 if a < b; 0 if a = b; 1 if a > b. + + + + + Numerator of first value + + + + Denominator of first value + + + + Numerator of second value + + + + Denominator of second value + + Multiplies the fractions @a_n/@a_d and @b_n/@b_d and stores +the result in @res_n and @res_d. - + %FALSE on overflow, %TRUE otherwise. + - + Numerator of first value + - + Denominator of first value + - + Numerator of second value + - + Denominator of second value + - - + + Pointer to #gint to hold the result numerator + - - + + Pointer to #gint to hold the result denominator + + Transforms a #gdouble to a fraction and simplifies the result. - + Fraction numerator as #gint + - + Fraction denominator #gint + - - + + pointer to a #gdouble for the result + - + - + - + Get a timestamp as GstClockTime to be used for interval meassurements. +The timestamp should not be interpreted in any other way. + + the timestamp + Calculates the greatest common divisor of @a +and @b. - + Greatest common divisor of @a and @b + - + First value as #gint + - + Second value as #gint + - + - + + Compare two sequence numbers, handling wraparound. +The current implementation just returns (gint32)(@s1 - @s2). +positive number if @s1 is after @s2. - + A negative number if @s1 is before @s2, 0 if they are equal, or a + - + A sequence number. + - + Another sequence number. + + Return a constantly incrementing sequence number. This function is used internally to GStreamer to be able to determine which -events and messages are "the same". For example, elements may set the seqnum +events and messages are "the same". For example, elements may set the seqnum on a segment-done message to be the same as that of the last seek event, to indicate that event and the message correspond to the same segment. overflow back to 0 at some point. Use gst_util_seqnum_compare() to make sure -you handle wraparound correctly." - version="0.10.22"> +you handle wraparound correctly. - + A constantly incrementing 32-bit unsigned integer, which might + + Convertes the string value to the type of the objects argument and sets the argument with it. -Note that this function silently returns if @object has no property named"> +Note that this function silently returns if @object has no property named + the object to set the argument of + the name of the argument to set + the string value to set + Converts the string to the type of the value and sets the value with it. Note that this function is dangerous as it does not return any indication -if the conversion worked or not."> +if the conversion worked or not. - + + the value to set + the string to get the value from - + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. @@ -21068,25 +25039,29 @@ function returns G_MAXUINT64. If the result is not exactly representable as an integer it is truncated. See also gst_util_uint64_scale_round(), gst_util_uint64_scale_ceil(), gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), -gst_util_uint64_scale_int_ceil()."> +gst_util_uint64_scale_int_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - + the number to scale + - + the numerator of the scale ratio + - + the denominator of the scale ratio + + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. @@ -21094,97 +25069,113 @@ function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is rounded up. See also gst_util_uint64_scale(), gst_util_uint64_scale_round(), gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), -gst_util_uint64_scale_int_ceil()."> +gst_util_uint64_scale_int_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - + the number to scale + - + the numerator of the scale ratio + - + the denominator of the scale ratio + + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is truncated. See also gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(), gst_util_uint64_scale(), gst_util_uint64_scale_round(), -gst_util_uint64_scale_ceil()."> +gst_util_uint64_scale_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - - + + guint64 (such as a #GstClockTime) to scale. + - + numerator of the scale factor. + - + denominator of the scale factor. + + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is rounded up. See also gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), gst_util_uint64_scale(), gst_util_uint64_scale_round(), -gst_util_uint64_scale_ceil()."> +gst_util_uint64_scale_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - - + + guint64 (such as a #GstClockTime) to scale. + - + numerator of the scale factor. + - + denominator of the scale factor. + + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. @num must be non-negative and function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is rounded to the nearest integer (half-way cases are rounded up). See also gst_util_uint64_scale_int(), gst_util_uint64_scale_int_ceil(), gst_util_uint64_scale(), -gst_util_uint64_scale_round(), gst_util_uint64_scale_ceil()."> +gst_util_uint64_scale_round(), gst_util_uint64_scale_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - - + + guint64 (such as a #GstClockTime) to scale. + - + numerator of the scale factor. + - + denominator of the scale factor. + + Scale @val by the rational number @num / @denom, avoiding overflows and underflows and without loss of precision. This function can potentially be very slow if val and num are both greater than G_MAXUINT32. @@ -21192,870 +25183,1119 @@ function returns G_MAXUINT64. If the result is not exactly representable as an integer, it is rounded to the nearest integer (half-way cases are rounded up). See also gst_util_uint64_scale(), gst_util_uint64_scale_ceil(), gst_util_uint64_scale_int(), -gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil()."> +gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(). - + @val * @num / @denom. In the case of an overflow, this + - + the number to scale + - + the numerator of the scale ratio + - + the denominator of the scale ratio + + c:identifier="gst_value_array_append_value"> + Appends @append_value to the GstValueArray in @value. + a #GValue of type #GST_TYPE_ARRAY + the value to append + c:identifier="gst_value_array_get_size"> + Gets the number of values contained in @value. - + the number of values + + a #GValue of type #GST_TYPE_ARRAY - + + + + + + Gets the value that is a member of the array contained in @value and +has the index @index. + + the value at the given index + a #GValue of type #GST_TYPE_ARRAY - + index of value to get from the array + + c:identifier="gst_value_array_prepend_value"> + Prepends @prepend_value to the GstValueArray in @value. + a #GValue of type #GST_TYPE_ARRAY + the value to prepend - + + Determines if @value1 and @value2 can be compared. - + TRUE if the values can be compared + + a value to compare + another value to compare + Determines if intersecting two values will produce a valid result. Two values will produce a valid intersection if they have the same type, or if there is a method (registered by -gst_value_register_intersect_func()) to calculate the intersection."> +gst_value_register_intersect_func()) to calculate the intersection. - + TRUE if the values can intersect + + a value to intersect + another value to intersect - + + Checks if it's possible to subtract @subtrahend from @minuend. - + TRUE if a subtraction is possible + + the value to subtract from + the value to subtract - + Determines if @value1 and @value2 can be non-trivially unioned. Any two values can be trivially unioned by adding both of them to a GstValueList. However, certain types have the possibility to be unioned in a simpler way. For example, an integer range and an integer can be unioned if the integer is a subset of the integer range. If there is the possibility that two values can be unioned, this function returns TRUE. -be unioned."> +be unioned. - + TRUE if there is a function allowing the two values to + + a value to union + another value to union - + Compares @value1 and @value2. If @value1 and @value2 cannot be compared, the function returns GST_VALUE_UNORDERED. Otherwise, if @value1 is greater than @value2, GST_VALUE_GREATER_THAN is returned. If @value1 is less than @value2, GST_VALUE_LESS_THAN is returned. -If the values are equal, GST_VALUE_EQUAL is returned."> +If the values are equal, GST_VALUE_EQUAL is returned. - + comparison result + + a value to compare + another value to compare - + + Tries to deserialize a string into the type specified by the given GValue. +If the operation succeeds, TRUE is returned, FALSE otherwise. - + TRUE on success + - + + #GValue to fill with contents of deserialization + string to deserialize + Get the contents of a %GST_TYPE_MINI_OBJECT derived #GValue, +increasing its reference count. + mini object contents of @value + a valid #GValue of %GST_TYPE_MINI_OBJECT derived type - - + c:identifier="gst_value_fraction_multiply"> + Multiplies the two #GValue items containing a #GST_TYPE_FRACTION and sets + + FALSE in case of an error (like integer overflow), TRUE otherwise. + + a GValue initialized to #GST_TYPE_FRACTION + a GValue initialized to #GST_TYPE_FRACTION + a GValue initialized to #GST_TYPE_FRACTION - - + c:identifier="gst_value_fraction_subtract"> + Subtracts the @subtrahend from the @minuend and sets @dest to the result. + + FALSE in case of an error (like integer overflow), TRUE otherwise. + + a GValue initialized to #GST_TYPE_FRACTION + a GValue initialized to #GST_TYPE_FRACTION + a GValue initialized to #GST_TYPE_FRACTION - + + Gets the contents of @value. The reference count of the returned +#GstCaps will not be modified, therefore the caller must take one +before getting rid of the @value. + the contents of @value + a GValue initialized to GST_TYPE_CAPS - + + Gets the contents of @value. + the contents of @value + a GValue initialized to GST_TYPE_DATE + c:identifier="gst_value_get_double_range_max"> + Gets the maximum of the range specified by @value. - + the maxumum of the range + + a GValue initialized to GST_TYPE_DOUBLE_RANGE + c:identifier="gst_value_get_double_range_min"> + Gets the minimum of the range specified by @value. - + the minimum of the range + + a GValue initialized to GST_TYPE_DOUBLE_RANGE - + + Gets the #guint32 fourcc contained in @value. - + the #guint32 fourcc contained in @value. + + a GValue initialized to #GST_TYPE_FOURCC + c:identifier="gst_value_get_fraction_denominator"> + Gets the denominator of the fraction specified by @value. - + the denominator of the fraction. + + a GValue initialized to #GST_TYPE_FRACTION + c:identifier="gst_value_get_fraction_numerator"> + Gets the numerator of the fraction specified by @value. - + the numerator of the fraction. + + a GValue initialized to #GST_TYPE_FRACTION + c:identifier="gst_value_get_fraction_range_max"> + Gets the maximum of the range specified by @value. + the maximum of the range + a GValue initialized to GST_TYPE_FRACTION_RANGE + c:identifier="gst_value_get_fraction_range_min"> + Gets the minimum of the range specified by @value. + the minimum of the range + a GValue initialized to GST_TYPE_FRACTION_RANGE + + + + + + Gets the maximum of the range specified by @value. + + the maxumum of the range + + + + + a GValue initialized to GST_TYPE_INT64_RANGE + + + + + + Gets the minimum of the range specified by @value. + + the minimum of the range + + + + + a GValue initialized to GST_TYPE_INT64_RANGE + c:identifier="gst_value_get_int_range_max"> + Gets the maximum of the range specified by @value. - + the maxumum of the range + + a GValue initialized to GST_TYPE_INT_RANGE + c:identifier="gst_value_get_int_range_min"> + Gets the minimum of the range specified by @value. - + the minimum of the range + + a GValue initialized to GST_TYPE_INT_RANGE - + c:identifier="gst_value_get_mini_object"> + Get the contents of a %GST_TYPE_MINI_OBJECT derived #GValue. +Does not increase the refcount of the returned object. + + mini object contents of @value + a valid #GValue of %GST_TYPE_MINI_OBJECT derived type + Gets the contents of @value. + the contents of @value + a GValue initialized to GST_TYPE_STRUCTURE + c:identifier="gst_value_init_and_copy"> + Initialises the target value to be of the same type as source and then copies +the contents from source to target. - + + the target value + the source value - + Calculates the intersection of two values. If the values have a non-empty intersection, the value representing the intersection is placed in @dest. If the intersection is non-empty, @dest is -not modified."> +not modified. - + TRUE if the intersection is non-empty + - + + a uninitialized #GValue that will hold the calculated intersection value + a value to intersect + another value to intersect - + + Tests if the given GValue, if available in a GstStructure (or any other +(which means: multiple possible values, such as data lists or data +ranges) value. - + true if the value is "fixed". + + the #GValue to check + c:identifier="gst_value_list_append_value"> + Appends @append_value to the GstValueList in @value. + a #GValue of type #GST_TYPE_LIST + the value to append - + + Concatenates copies of @value1 and @value2 into a list. Values that are not +of type #GST_TYPE_LIST are treated as if they were lists of length 1. - + + an uninitialized #GValue to take the result + a #GValue + a #GValue + c:identifier="gst_value_list_get_size"> + Gets the number of values contained in @value. - + the number of values + + a #GValue of type #GST_TYPE_LIST - + + + + + + Gets the value that is a member of the list contained in @value and +has the index @index. + + the value at the given index + a #GValue of type #GST_TYPE_LIST - + index of value to get from the list + + + + + + Merges copies of @value1 and @value2. Values that are not +of type #GST_TYPE_LIST are treated as if they were lists of length 1. +The result will be put into @dest and will either be a list that will not +contain any duplicates, or a non-list type (if @value1 and @value2 +were equal). + + + + + + an uninitialized #GValue to take the result + + + + a #GValue + + + + a #GValue + + c:identifier="gst_value_list_prepend_value"> + Prepends @prepend_value to the GstValueList in @value. + a #GValue of type #GST_TYPE_LIST + the value to prepend - + + Registers functions to perform calculations on #GValue items of a given +type. Each type can only be added once. + structure containing functions to register + Registers a function that is called to calculate the intersection of the values having the types @type1 and @type2. Intersect functions should be registered at startup before any pipelines are started, as gst_value_register_intersect_func() is not thread-safe and cannot be used at the same time as gst_value_intersect() or -gst_value_can_intersect()."> +gst_value_can_intersect(). + the first type to intersect + the second type to intersect - + + the intersection function + Registers @func as a function capable of subtracting the values of Subtract functions should be registered at startup before any pipelines are started, as gst_value_register_subtract_func() is not thread-safe and -cannot be used at the same time as gst_value_subtract()."> +cannot be used at the same time as gst_value_subtract(). + type of the minuend + type of the subtrahend - + + function to use + Registers a union function that can create a union between #GValue items of the type @type1 and @type2. Union functions should be registered at startup before any pipelines are started, as gst_value_register_union_func() is not thread-safe and cannot -be used at the same time as gst_value_union() or gst_value_can_union()."> +be used at the same time as gst_value_union() or gst_value_can_union(). + a type to union + another type to union - + + a function that implments creating a union between the two types - + + tries to transform the given @value into a string representation that allows +getting back this string later on using gst_value_deserialize(). + the serialization for @value or NULL if none exists + a #GValue to serialize - + + Sets the contents of @value to @caps. A reference to the +provided @caps will be taken by the @value. + a GValue initialized to GST_TYPE_CAPS + the caps to set the value to - + + Sets the contents of @value to coorespond to @date. The actual +#GDate structure is copied before it is used. + a GValue initialized to GST_TYPE_DATE + the date to set the value to + c:identifier="gst_value_set_double_range"> + Sets @value to the range specified by @start and @end. + a GValue initialized to GST_TYPE_DOUBLE_RANGE - + the start of the range + - + the end of the range + - + + Sets @value to @fourcc. + a GValue initialized to #GST_TYPE_FOURCC - + the #guint32 fourcc to set + - + Sets @value to the fraction specified by @numerator over @denominator. The fraction gets reduced to the smallest numerator and denominator, -and if necessary the sign is moved to the numerator."> +and if necessary the sign is moved to the numerator. + a GValue initialized to #GST_TYPE_FRACTION - + the numerator of the fraction + - + the denominator of the fraction + + c:identifier="gst_value_set_fraction_range"> + Sets @value to the range specified by @start and @end. + a GValue initialized to GST_TYPE_FRACTION_RANGE + the start of the range (a GST_TYPE_FRACTION GValue) + the end of the range (a GST_TYPE_FRACTION GValue) + c:identifier="gst_value_set_fraction_range_full"> + Sets @value to the range specified by @numerator_start/@denominator_start +and @numerator_end/@denominator_end. + a GValue initialized to GST_TYPE_FRACTION_RANGE - + the numerator start of the range + - + the denominator start of the range + - + the numerator end of the range + - + the denominator end of the range + + + + + + Sets @value to the range specified by @start and @end. + + + + + + a GValue initialized to GST_TYPE_INT64_RANGE + + + + the start of the range + + + + the end of the range + + c:identifier="gst_value_set_int_range"> + Sets @value to the range specified by @start and @end. + a GValue initialized to GST_TYPE_INT_RANGE - + the start of the range + - + the end of the range + + c:identifier="gst_value_set_mini_object"> + Set the contents of a %GST_TYPE_MINI_OBJECT derived #GValue to +The caller retains ownership of the reference. + a valid #GValue of %GST_TYPE_MINI_OBJECT derived type + mini object value to set + Sets the contents of @value to @structure. The actual + a GValue initialized to GST_TYPE_STRUCTURE + the structure to set the value to - + + Subtracts @subtrahend from @minuend and stores the result in @dest. +Note that this means subtraction as in sets, not as in mathematics. - + %TRUE if the subtraction is not empty + - + + the destination value for the result if the subtraction is not empty + the value to subtract from + the value to subtract + c:identifier="gst_value_take_mini_object"> + Set the contents of a %GST_TYPE_MINI_OBJECT derived #GValue to +Takes over the ownership of the caller's reference to @mini_object; +the caller doesn't have to unref it any more. + a valid #GValue of %GST_TYPE_MINI_OBJECT derived type - + + mini object value to take - + + Creates a GValue corresponding to the union of @value1 and @value2. - + always returns %TRUE + - + + the destination value + a value to union + another value to union - + + Gets the version number of the GStreamer library. - - + + pointer to a guint to store the major version number + - - + + pointer to a guint to store the minor version number + - - + + pointer to a guint to store the micro version number + - - + + pointer to a guint to store the nano version number + - + + This function returns a string that is useful for describing this version +of GStreamer. + a newly allocated string describing this version diff --git a/unmaintained/gstreamer/authors.txt b/extra/gstreamer/authors.txt similarity index 100% rename from unmaintained/gstreamer/authors.txt rename to extra/gstreamer/authors.txt diff --git a/unmaintained/gstreamer/base/GstBase-0.10.gir b/extra/gstreamer/base/GstBase-0.10.gir similarity index 55% rename from unmaintained/gstreamer/base/GstBase-0.10.gir rename to extra/gstreamer/base/GstBase-0.10.gir index a4ebc0125b..db5e2bfe3d 100644 --- a/unmaintained/gstreamer/base/GstBase-0.10.gir +++ b/extra/gstreamer/base/GstBase-0.10.gir @@ -2,7 +2,7 @@ - @@ -11,7 +11,7 @@ and/or use gtk-doc annotations. --> - + @@ -25,183 +25,106 @@ and/or use gtk-doc annotations. --> + shared-library="libgstreamer-0.10.so.0,libgstbase-0.10.so.0" + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> - + The opaque #GstAdapter data structure. + + Creates a new #GstAdapter. Free with g_object_unref(). + a new #GstAdapter - + + Gets the maximum amount of bytes available, that is it returns the maximum +value that can be supplied to gst_adapter_peek() without that function +returning NULL. + + number of bytes available in @adapter + + + + + Gets the maximum number of bytes that are immediately available without +requiring any expensive operations (like copying the data into a +temporary buffer). +operations + + number of bytes that are available in @adapter without expensive + + + + + Removes all buffers from @adapter. - - - - - - - - - - - - - - - - - - - - - - - + Copies @size bytes of data starting at @offset out of the buffers contained in @GstAdapter into an array @dest provided by the caller. The array @dest should be large enough to contain @size bytes. The user should check that the adapter has (@offset + @size) bytes -available before calling this function." - version="0.10.12"> +available before calling this function. - - - + + the memory to copy into + + - + the bytes offset in the adapter to start from + - - + + the number of bytes to copy + - + + Flushes the first @flush bytes in the @adapter. The caller must ensure that +at least this many bytes are available. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + the number of bytes to flush + + Scan for pattern @pattern with applied mask @mask in the adapter data, starting from offset @offset. The bytes in @pattern and @mask are interpreted left-to-right, regardless of endianness. All four bytes of the pattern must be present in the adapter for it to match, even if the first or last bytes are masked out. It is an error to call this function without making sure that there is enough data (offset+size bytes) in the adapter. +This function calls gst_adapter_masked_scan_uint32_peek() passing NULL +for value. Example: <programlisting> // Assume the adapter contains 0x00 0x01 0x02 ... 0xfe 0xff @@ -219,23 +142,193 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 256); // -> returns 2 gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); // -> returns -1 -</programlisting>" - version="0.10.24"> +</programlisting> - + offset of the first match, or -1 if no match was found. + - + mask to apply to data before matching against @pattern + - + pattern to match (after mask is applied) + - + offset into the adapter data from which to start scanning, returns the last scanned position. + - + number of bytes to scan from offset + + + + + + Scan for pattern @pattern with applied mask @mask in the adapter data, +starting from offset @offset. If a match is found, the value that matched +is returned through @value, otherwise @value is left untouched. +The bytes in @pattern and @mask are interpreted left-to-right, regardless +of endianness. All four bytes of the pattern must be present in the +adapter for it to match, even if the first or last bytes are masked out. +It is an error to call this function without making sure that there is +enough data (offset+size bytes) in the adapter. + + offset of the first match, or -1 if no match was found. + + + + + mask to apply to data before matching against @pattern + + + + pattern to match (after mask is applied) + + + + offset into the adapter data from which to start scanning, returns the last scanned position. + + + + number of bytes to scan from offset + + + + pointer to uint32 to return matching data + + + + + + Gets the first @size bytes stored in the @adapter. The returned pointer is +valid until the next function is called on the adapter. +Note that setting the returned pointer as the data of a #GstBuffer is +incorrect for general-purpose plugins. The reason is that if a downstream +element stores the buffer so that it has access to it outside of the bounds +of its chain function, the buffer will have an invalid data pointer after +your element flushes the bytes. In that case you should use +gst_adapter_take(), which returns a freshly-allocated buffer that you can set +as #GstBuffer malloc_data or the potentially more performant +gst_adapter_take_buffer(). +Returns #NULL if @size bytes are not available. + + a pointer to the first + + + + + + + the number of bytes to peek + + + + + + Get the timestamp that was before the current byte in the adapter. When +position is returned. +The timestamp is reset to GST_CLOCK_TIME_NONE and the distance is set to 0 when +the adapter is first created or when it is cleared. This also means that before +the first byte with a timestamp is removed from the adapter, the timestamp +and distance returned are GST_CLOCK_TIME_NONE and 0 respectively. + + The previously seen timestamp. + + + + + pointer to location for distance, or NULL + + + + + + Adds the data from @buf to the data stored inside @adapter and takes +ownership of the buffer. + + + + + + a #GstBuffer to add to queue in the adapter + + + + + + Returns a freshly allocated buffer containing the first @nbytes bytes of the +Caller owns returned value. g_free after usage. +#NULL if @nbytes bytes are not available + + oven-fresh hot data, or + + + + + + + the number of bytes to take + + + + + + Returns a #GstBuffer containing the first @nbytes bytes of the +This function is potentially more performant than gst_adapter_take() +since it can reuse the memory in pushed buffers by subbuffering +or merging. +Caller owns returned value. gst_buffer_unref() after usage. +the adapter, or #NULL if @nbytes bytes are not available + + a #GstBuffer containing the first @nbytes of + + + + + the number of bytes to take + + + + + + Returns a #GList of buffers containing the first @nbytes bytes of the +When the caller can deal with individual buffers, this function is more +performant because no memory should be copied. +Caller owns returned list and contained buffers. gst_buffer_unref() each +buffer in the list before freeing the list after usage. +containing the first @nbytes of the adapter, or #NULL if @nbytes bytes +are not available + + a #GList of buffers + + + + + + + the number of bytes to take + @@ -243,32 +336,36 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); - + + + - + - + - + - + - + - + + + - + @@ -280,45 +377,52 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); - + - + + + + + + + - - - - - - + The opaque #GstBaseSink data structure. + - + - - + + + + + + + - + - + - + @@ -328,6 +432,31 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); + + + + + + + + + + + + + + + + + + + + + + + + + @@ -344,33 +473,8 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -380,7 +484,7 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); - + @@ -389,38 +493,8 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -429,270 +503,345 @@ gst_adapter_masked_scan_uint32 (adapter, 0xffff0000, 0x02030000, 0, 4); + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + If the @sink spawns its own thread for pulling buffers from upstream it should call this method after it has pulled a buffer. If the element needed to preroll, this function will perform the preroll and will then block until the element state is changed. This function should be called with the PREROLL_LOCK held. -Since 0.10.22 -continue. Any other return value should be returned from the render vmethod."> - +continue. Any other return value should be returned from the render vmethod. + + #GST_FLOW_OK if the preroll completed and processing can + the mini object that caused the preroll - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Get the number of bytes that the sink will pull when it is operating in pull +mode. - + the number of bytes @sink will pull in pull mode. + + + Get the last buffer that arrived in the sink and was used for preroll or for +rendering. This property can be used to generate thumbnails. +The #GstCaps on the buffer can be used to determine the type of the buffer. +This function returns NULL when no buffer has arrived in the sink yet +or when the sink is not in PAUSED or PLAYING. + + a #GstBuffer. gst_buffer_unref() after usage. + + + + + Get the currently configured latency. + + The configured latency. + + + + + Gets the max lateness value. See gst_base_sink_set_max_lateness for +more details. +before it is dropped and not rendered. A value of -1 means an +unlimited time. + + The maximum time in nanoseconds that a buffer can be late + + + + + Get the render delay of @sink. see gst_base_sink_set_render_delay() for more +information about the render delay. + + the render delay of @sink. + + + + + Checks if @sink is currently configured to synchronize against the +clock. + + TRUE if the sink is configured to synchronize against the clock. + + + + + Get the synchronisation offset of @sink. + + The synchronisation offset. + + + + + Checks if @sink is currently configured to perform asynchronous state +changes to PAUSED. +changes. + + TRUE if the sink is configured to perform asynchronous state + + + + + Checks if @sink is currently configured to store the last received buffer in +the last-buffer property. + + TRUE if the sink is configured to store the last received buffer. + + + + + Checks if @sink is currently configured to send Quality-of-Service events +upstream. + + TRUE if the sink is configured to perform Quality-of-Service. + + + + + Query the sink for the latency parameters. The latency will be queried from +the upstream elements. @live will be TRUE if @sink is configured to +synchronize against the clock. @upstream_live will be TRUE if an upstream +element is live. +If both @live and @upstream_live are TRUE, the sink will want to compensate +for the latency introduced by the upstream elements by setting the +This function is mostly used by subclasses. + + TRUE if the query succeeded. + + + + + if the sink is live + + + + if an upstream element is live + + + + the min latency of the upstream elements + + + + the max latency of the upstream elements + + + + + + Configures @sink to perform all state changes asynchronusly. When async is +disabled, the sink will immediatly go to PAUSED instead of waiting for a +preroll buffer. This feature is usefull if the sink does not synchronize +against the clock or when it is dealing with sparse streams. + + + + + + the new async value. + + + + + + Set the number of bytes that the sink will pull when it is operating in pull +mode. + + + + + + the blocksize in bytes + + + + + + Configures @sink to store the last received buffer in the last-buffer +property. + + + + + + the new enable-last-buffer value. + + + + + + Sets the new max lateness value to @max_lateness. This value is +used to decide if a buffer should be dropped or not based on the +buffer timestamp and the current clock time. A value of -1 means +an unlimited time. + + + + + + the new max lateness value. + + + + + + Configures @sink to send Quality-of-Service events upstream. + + + + + + the new qos value. + + + + + + Set the render delay in @sink to @delay. The render delay is the time +between actual rendering of a buffer and its synchronisation time. Some +devices might delay media rendering which can be compensated for with this +function. +After calling this function, this sink will report additional latency and +other sinks will adjust their latency to delay the rendering of their media. +This function is usually called by subclasses. + + + + + + the new delay + + + + + + Configures @sink to synchronize on the clock or not. When +possible. If @sync is TRUE, the timestamps of the incomming +buffers will be used to schedule the exact render time of its +contents. + + + + + + the new sync value. + + + + + + Adjust the synchronisation of @sink with @offset. A negative value will +render buffers earlier than their timestamp. A positive value will delay +rendering. This function can be used to fix playback of badly timestamped +buffers. + + + + + + the new offset + + + + + This function will block until @time is reached. It is usually called by subclasses that use their own internal synchronisation. If @time is not valid, no sycnhronisation is done and #GST_CLOCK_BADTIME is returned. Likewise, if synchronisation is disabled in the element or there @@ -703,68 +852,107 @@ receiving a buffer in the #GstBaseSinkClass.render() vmethod. The @time argument should be the running_time of when this method should return and is not adjusted with any latency or offset configured in the -sink. -Since 0.10.20"> - +sink. + + #GstClockReturn + the running_time to be reached - + + the jitter to be filled with time diff, or NULL + This function will block until @time is reached. It is usually called by subclasses that use their own internal synchronisation but want to let the EOS be handled by the base class. This function should only be called with the PREROLL_LOCK held, like when receiving an EOS event in the ::event vmethod. The @time argument should be the running_time of when the EOS should happen -and will be adjusted with any latency and offset configured in the sink. -Since 0.10.15"> - +and will be adjusted with any latency and offset configured in the sink. + + #GstFlowReturn + the running_time to be reached - + + the jitter to be filled with time diff, or NULL - - + + If the #GstBaseSinkClass.render() method performs its own synchronisation +against the clock it must unblock when going from PLAYING to the PAUSED state +and call this method before continuing to render the remaining data. +This function will block until a state change to PLAYING happens (in which +case this function returns #GST_FLOW_OK) or the processing must be stopped due +to a state change to READY or a FLUSH event (in which case this function +returns #GST_FLOW_WRONG_STATE). +This function should only be called with the PREROLL_LOCK held, like in the +render function. +continue. Any other return value should be returned from the render vmethod. + + #GST_FLOW_OK if the preroll completed and processing can + + + + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + + + + @@ -776,46 +964,46 @@ Since 0.10.15"> - + - + - + - + - + - + - + - + - + - + - + - + - + @@ -827,10 +1015,10 @@ Since 0.10.15"> - + - + @@ -838,15 +1026,15 @@ Since 0.10.15"> - + - + - + @@ -856,27 +1044,15 @@ Since 0.10.15"> + Subclasses can override any of the available virtual methods or not, as needed. At the minimum, the @render method should be overridden to -output/present buffers."> +output/present buffers. - + @@ -888,9 +1064,9 @@ output/present buffers."> - + - + @@ -903,8 +1079,8 @@ output/present buffers."> - - + + @@ -912,10 +1088,10 @@ output/present buffers."> - + - + @@ -927,7 +1103,7 @@ output/present buffers."> - + @@ -948,9 +1124,9 @@ output/present buffers."> - + - + @@ -960,9 +1136,9 @@ output/present buffers."> - + - + @@ -972,9 +1148,9 @@ output/present buffers."> - + - + @@ -984,9 +1160,9 @@ output/present buffers."> - + - + @@ -999,8 +1175,8 @@ output/present buffers."> - - + + @@ -1014,8 +1190,8 @@ output/present buffers."> - - + + @@ -1029,8 +1205,8 @@ output/present buffers."> - - + + @@ -1041,22 +1217,22 @@ output/present buffers."> - + - + - + - + @@ -1071,9 +1247,9 @@ output/present buffers."> - + - + @@ -1083,8 +1259,8 @@ output/present buffers."> - - + + @@ -1099,28 +1275,65 @@ output/present buffers."> - + - + - - - + The opaque #GstBaseSrc data structure. + + + - + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1128,25 +1341,20 @@ output/present buffers."> - - - + + + - + - - - - - - - - - - - + + + + + + @@ -1164,95 +1372,24 @@ output/present buffers."> - - - - - - - - - - - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + @@ -1263,163 +1400,229 @@ output/present buffers."> - - - - - - + - + - - + + - - + + - - - - - - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + Get the number of bytes that @src will push out with each buffer. + + the number of bytes pushed with each buffer. + + + + + Query if @src timestamps outgoing buffers based on the current running_time. + + %TRUE if the base class will automatically timestamp outgoing buffers. + + + + + Check if an element is in live mode. + + %TRUE if element is in live mode. + + + + + Prepare a new seamless segment for emission downstream. This function must +only be called by derived sub-classes, and only from the create() function, +as the stream-lock needs to be held. +The format for the new segment will be the current format of the source, as +configured with gst_base_src_set_format() + + %TRUE if preparation of the seamless segment succeeded. + + + + + The new start value for the segment + + + + Stop value for the new segment + + + + The position value for the new segent + + Query the source for the latency parameters. @live will be TRUE when @src is configured as a live source. @min_latency will be set to the difference between the running time and the timestamp of the first buffer. -This function is mostly used by subclasses." - version="0.10.13"> +This function is mostly used by subclasses. - + TRUE if the query succeeded. + - - + + if the source is live + - + + the min latency of the source - + + the max latency of the source + Set the number of bytes that @src will push out with each buffer. When - + the new blocksize in bytes + - - - - - + Configure @src to automatically timestamp outgoing buffers based on the +current running_time of the pipeline. This property is mostly useful for live +sources. - + enable or disable timestamping + - + + Sets the default format of the source. This will be the format used +for sending NEW_SEGMENT events and for performing seeks. +If a format of GST_FORMAT_BYTES is set, the element will be able to +operate in pull mode if the #GstBaseSrc.is_seekable() returns TRUE. +This function must only be called in states < %GST_STATE_PAUSED. - - - - - - + - - - - - - - - + + the format to use + - - + + If the element listens to a live source, @live should +be set to %TRUE. +A live source will not produce data in the PAUSED state and +will therefore not be able to participate in the PREROLL phase +of a pipeline. To signal this fact to the application and the +pipeline, the state change return value of the live source will +be GST_STATE_CHANGE_NO_PREROLL. + + + + + + new live-mode + + + + + + If the #GstBaseSrcClass.create() method performs its own synchronisation +against the clock it must unblock when going from PLAYING to the PAUSED state +and call this method before continuing to produce the remaining data. +This function will block until a state change to PLAYING happens (in which +case this function returns #GST_FLOW_OK) or the processing must be stopped due +to a state change to READY or a FLUSH event (in which case this function +returns #GST_FLOW_WRONG_STATE). +continue. Any other return value should be returned from the create vmethod. + + #GST_FLOW_OK if @src is PLAYING and processing can + + + + + - - + + - - + + - - + + @@ -1434,25 +1637,25 @@ configured with gst_base_src_set_format()" - + - + - + - + - + - + @@ -1464,27 +1667,27 @@ configured with gst_base_src_set_format()" - + - + - + - + - + - + - + @@ -1492,7 +1695,7 @@ configured with gst_base_src_set_format()" - + @@ -1502,31 +1705,15 @@ configured with gst_base_src_set_format()" + Subclasses can override any of the available virtual methods or not, as needed. At the minimum, the @create method should be overridden to produce -buffers." - version="0.10.13"> +buffers. - + @@ -1538,9 +1725,9 @@ buffers." - + - + @@ -1553,9 +1740,9 @@ buffers." - + - + @@ -1565,9 +1752,9 @@ buffers." - + - + @@ -1577,9 +1764,9 @@ buffers." - + - + @@ -1589,9 +1776,9 @@ buffers." - + - + @@ -1601,7 +1788,7 @@ buffers." - + @@ -1622,24 +1809,24 @@ buffers." - + - + - - + + - + - + @@ -1649,9 +1836,9 @@ buffers." - + - + @@ -1661,9 +1848,9 @@ buffers." - + - + @@ -1676,8 +1863,8 @@ buffers." - - + + @@ -1685,10 +1872,10 @@ buffers." - + - + @@ -1697,9 +1884,9 @@ buffers." - + - + @@ -1712,9 +1899,9 @@ buffers." - + - + @@ -1727,9 +1914,9 @@ buffers." - + - + @@ -1739,7 +1926,7 @@ buffers." - + @@ -1754,9 +1941,9 @@ buffers." - + - + @@ -1766,9 +1953,9 @@ buffers." - + - + @@ -1785,13 +1972,12 @@ buffers." - + - + + The #GstElement flags that a basesrc element may have. @@ -1799,19 +1985,20 @@ buffers." value="4194304" c:identifier="GST_BASE_SRC_FLAG_LAST"/> - + - - - + The opaque #GstBaseTransform data structure. + + + @@ -1822,6 +2009,26 @@ buffers." + + + + + + + + + + + + + + + + + + + + @@ -1838,46 +2045,41 @@ buffers." - + - + - - - - - - - - - - + - + - + + + + + + + - - + + - + @@ -1888,19 +2090,9 @@ buffers." - + - - - - - - - - - - - + @@ -1908,8 +2100,18 @@ buffers." + + + + + + + + + + - + @@ -1921,199 +2123,204 @@ buffers." - + - + - - - - - - - - - - - - - - - + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + - + - - + + + + + + + + + + + + + + + + + See if @trans is configured as a in_place transform. +MT safe. + + TRUE is the transform is configured in in_place mode. + + + c:identifier="gst_base_transform_is_passthrough"> + See if @trans is configured as a passthrough transform. +MT safe. - + TRUE is the transform is configured in passthrough mode. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Queries if the transform will handle QoS. +MT safe. - + TRUE if QoS is enabled. + + + + + Instructs @trans to renegotiate a new downstream transform on the next +buffer. This function is typically called after properties on the transform +were set that influence the output format. + + + If @gap_aware is %FALSE (the default), output buffers will have the %GST_BUFFER_FLAG_GAP flag unset. If set to %TRUE, the element must handle output buffers with this flag set correctly, i.e. it can assume that the buffer contains neutral data but must unset the flag if the output is no neutral data. -MT safe." - version="0.10.16"> +MT safe. - + New state + + + + + + Determines whether a non-writable buffer will be copied before passing +to the transform_ip function. +<itemizedlist> +<listitem>Always TRUE if no transform function is implemented.</listitem> +<listitem>Always FALSE if ONLY transform function is implemented.</listitem> +</itemizedlist> +MT safe. + + + + + + Boolean value indicating that we would like to operate on in_place buffers. + + + + + + Set passthrough mode for this filter by default. This is mostly +useful for filters that do not care about negotiation. +Always TRUE for filters which don't implement either a transform +or transform_ip method. +MT safe. + + + + + + boolean indicating passthrough mode. + + + + + + Enable or disable QoS handling in the transform. +MT safe. + + + + + + new state + + Instructs @trans to suggest new @caps upstream. A copy of @caps will be +taken. + caps to suggest - + buffer size to suggest + - + + Set the QoS parameters in the transform. This function is called internally +when a QOS event is received but subclasses can provide custom information +when needed. +MT safe. + + + the proportion + + + + the diff against the clock + + + + the timestamp of the buffer generating the QoS expressed in running_time. + + + - - + + @@ -2125,37 +2332,37 @@ were set that influence the output format." - + - + - + - + - + - + - + - + - + @@ -2168,50 +2375,22 @@ were set that influence the output format." - + + Subclasses can override any of the available virtual methods or not, as needed. At minimum either @transform or @transform_ip need to be overridden. If the element can overwrite the input data with the results (data is of the -same type and quantity) it should provide @transform_ip."> +same type and quantity) it should provide @transform_ip. - + @@ -2229,7 +2408,7 @@ same type and quantity) it should provide @transform_ip."> - + @@ -2250,9 +2429,9 @@ same type and quantity) it should provide @transform_ip."> - + - + @@ -2265,23 +2444,21 @@ same type and quantity) it should provide @transform_ip."> - + - - + + - + - + @@ -2290,16 +2467,16 @@ same type and quantity) it should provide @transform_ip."> - - + + - + - + @@ -2315,9 +2492,9 @@ same type and quantity) it should provide @transform_ip."> - + - + @@ -2327,9 +2504,9 @@ same type and quantity) it should provide @transform_ip."> - + - + @@ -2339,9 +2516,9 @@ same type and quantity) it should provide @transform_ip."> - + - + @@ -2354,8 +2531,8 @@ same type and quantity) it should provide @transform_ip."> - - + + @@ -2372,8 +2549,8 @@ same type and quantity) it should provide @transform_ip."> - - + + @@ -2387,11 +2564,11 @@ same type and quantity) it should provide @transform_ip."> - + - - + + @@ -2402,7 +2579,7 @@ same type and quantity) it should provide @transform_ip."> - + @@ -2414,9 +2591,9 @@ same type and quantity) it should provide @transform_ip."> - + - + @@ -2429,7 +2606,7 @@ same type and quantity) it should provide @transform_ip."> - + @@ -2443,1125 +2620,351 @@ same type and quantity) it should provide @transform_ip."> + + + + + + + + + + + + + + + + + + - - + + - + - + + A bit reader instance. - + - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - + + Frees a #GstBitReader instance, which was previously allocated by +gst_bit_reader_new() or gst_bit_reader_new_from_buffer(). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Read @nbits bits into @val and update the current position. - + %TRUE if successful, %FALSE otherwise. + - - + + Pointer to a #guint16 to store the result + - + number of bits to read + + Read @nbits bits into @val and update the current position. - + %TRUE if successful, %FALSE otherwise. + - - + + Pointer to a #guint32 to store the result + - + number of bits to read + + Read @nbits bits into @val and update the current position. - - - - - - - - - - - - - - + %TRUE if successful, %FALSE otherwise. + - - - + Pointer to a #guint64 to store the result + - + number of bits to read + + + + + + Read @nbits bits into @val and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint8 to store the result + + + + number of bits to read + + + + + + Returns the current position of a #GstBitReader instance in bits. + + The current position of @reader in bits. + + + + + Returns the remaining number of bits of a #GstBitReader instance. + + The remaining number of bits of @reader instance. + + + + + Returns the total number of bits of a #GstBitReader instance. + + The total number of bits of @reader instance. + + + + + Initializes a #GstBitReader instance to read from @data. This function +can be called on already initialized instances. + + + + + + data from which the bit reader should read + + + + + + Size of @data in bytes + + + + + + Initializes a #GstBitReader instance to read from @buffer. This function +can be called on already initialized instances. + + + + + + Buffer from which the #GstBitReader should read + + Read @nbits bits into @val but keep the current position. - + %TRUE if successful, %FALSE otherwise. + - - + + Pointer to a #guint16 to store the result + - + number of bits to read + + Read @nbits bits into @val but keep the current position. - + %TRUE if successful, %FALSE otherwise. + - - + + Pointer to a #guint32 to store the result + - + number of bits to read + + Read @nbits bits into @val but keep the current position. - + %TRUE if successful, %FALSE otherwise. + - - + + Pointer to a #guint64 to store the result + - + number of bits to read + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Read @nbits bits into @val but keep the current position. - - - - - - + %TRUE if successful, %FALSE otherwise. + - - - - + + Pointer to a #guint8 to store the result + - - - - - - - - - - - - + + number of bits to read + + Sets the new position of a #GstBitReader instance to @pos in bits. +otherwise. - + %TRUE if the position could be set successfully, %FALSE + - + The new position in bits + - + + Skips @nbits bits of the #GstBitReader instance. - - - - - - - - - - - - - - - - + %TRUE if @nbits bits could be skipped, %FALSE otherwise. + - - + + the number of bits to skip + - + Skips until the next byte. - + %TRUE if successful, %FALSE otherwise. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + A byte reader instance. + + + + + + + + + - - - - - - - - - - - - - Returns a newly-allocated copy of the current data position if at least @size bytes are left and -updates the current position." - version="0.10.22"> +updates the current position. Free with g_free() when no longer needed. - + %TRUE if successful, %FALSE otherwise. + - - + + Size in bytes + - - - - - - - - - - - - - - - - - - - - - - - - - - + + address of a #guint8 pointer variable in which to store the result + + + Returns a newly-allocated copy of the current data position if there is a NUL-terminated UTF-16 string in the data (this could be an empty string as well), and advances the current position. No input checking for valid UTF-16 is done. This function is endianness @@ -3569,20 +2972,27 @@ agnostic - you should not assume the UTF-16 characters are in host endianness. This function will fail if no NUL-terminator was found in in the data. byte alignment of the UTF-16 string. -string put into @str must be freed with g_free() when no longer needed." - version="0.10.24"> +string put into @str must be freed with g_free() when no longer needed. - + %TRUE if a string could be read, %FALSE otherwise. The + - - + + address of a #guint16 pointer varieble in which to store the result + + + + Returns a newly-allocated copy of the current data position if there is a NUL-terminated UTF-32 string in the data (this could be an empty string as well), and advances the current position. No input checking for valid UTF-32 is done. This function is endianness @@ -3590,97 +3000,529 @@ agnostic - you should not assume the UTF-32 characters are in host endianness. This function will fail if no NUL-terminator was found in in the data. byte alignment of the UTF-32 string. -string put into @str must be freed with g_free() when no longer needed." - version="0.10.24"> +string put into @str must be freed with g_free() when no longer needed. - + %TRUE if a string could be read, %FALSE otherwise. The + - - + + address of a #guint32 pointer varieble in which to store the result + + + - + FIXME:Reads (copies) a NUL-terminated string in the #GstByteReader instance, +advancing the current position to the byte after the string. This will work +for any NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. -This function will fail if no NUL-terminator was found in in the data." - version="0.10.24"> +This function will fail if no NUL-terminator was found in in the data. +string put into @str must be freed with g_free() when no longer needed. - + %TRUE if a string could be read into @str, %FALSE otherwise. The + + + + + address of a #gchar pointer varieble in which to store the result + + + + + + + + Frees a #GstByteReader instance, which was previously allocated by +gst_byte_reader_new() or gst_byte_reader_new_from_buffer(). + + - + + Returns a constant pointer to the current data +position if at least @size bytes are left and +updates the current position. - + %TRUE if successful, %FALSE otherwise. + + + + + Size in bytes + + + + address of a #guint8 pointer variable in which to store the result + + + + + + + + Read a 32 bit big endian floating point value into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gfloat to store the result + + + + + + Read a 32 bit little endian floating point value into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gfloat to store the result + + + + + + Read a 64 bit big endian floating point value into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gdouble to store the result + + + + + + Read a 64 bit little endian floating point value into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gdouble to store the result + + + + + + Read a signed 16 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint16 to store the result + + + + + + Read a signed 16 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint16 to store the result + + + + + + Read a signed 24 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 24 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 32 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 32 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 64 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint64 to store the result + + + + + + Read a signed 64 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint64 to store the result + + + + + + Read a signed 8 bit integer into @val and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint8 to store the result + + + + + + Returns the current position of a #GstByteReader instance in bytes. + + The current position of @reader in bytes. + - + + Returns the remaining number of bytes of a #GstByteReader instance. - + The remaining number of bytes of @reader instance. + + + + + Returns the total number of bytes of a #GstByteReader instance. + + The total number of bytes of @reader instance. + + Returns a constant pointer to the current data position if there is a NUL-terminated string in the data (this could be just a NUL terminator), advancing the current position to the byte after the string. This will work for any NUL-terminated string with a character width of 8 bits, so ASCII, UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. -This function will fail if no NUL-terminator was found in in the data." - version="0.10.24"> +This function will fail if no NUL-terminator was found in in the data. - + %TRUE if a string could be found, %FALSE otherwise. + - + + address of a #gchar pointer varieble in which to store the result - + + Read an unsigned 16 bit big endian integer into @val +and update the current position. - + %TRUE if successful, %FALSE otherwise. + - - - + + Pointer to a #guint16 to store the result + + + + + + Read an unsigned 16 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint16 to store the result + + + + + + Read an unsigned 24 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 24 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 32 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 32 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 64 bit big endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint64 to store the result + + + + + + Read an unsigned 64 bit little endian integer into @val +and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint64 to store the result + + + + + + Read an unsigned 8 bit integer into @val and update the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint8 to store the result + + + + + + Initializes a #GstByteReader instance to read from @data. This function +can be called on already initialized instances. + + + + + + data from which the #GstByteReader should read + + + + Size of @data in bytes + + + + + + Initializes a #GstByteReader instance to read from @buffer. This function +can be called on already initialized instances. + + + + + + Buffer from which the #GstByteReader should read + + + Scan for pattern @pattern with applied mask @mask in the byte reader data, starting from offset @offset relative to the current position. The bytes in @pattern and @mask are interpreted left-to-right, regardless of endianness. All four bytes of the pattern must be present in the @@ -3705,616 +3547,1098 @@ gst_byte_reader_masked_scan_uint32 (reader, 0xffff0000, 0x02030000, 0, 256); // -> returns 2 gst_byte_reader_masked_scan_uint32 (reader, 0xffff0000, 0x02030000, 0, 4); // -> returns -1 -</programlisting>" - version="0.10.24"> +</programlisting> - + offset of the first match, or -1 if no match was found. + - + mask to apply to data before matching against @pattern + - + pattern to match (after mask is applied) + - + offset from which to start scanning, relative to the current position + - + number of bytes to scan from offset + + + Returns a constant pointer to the current data +position if at least @size bytes are left and +keeps the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Size in bytes + + + + address of a #guint8 pointer variable in which to store the result + + + + + + + + Read a 32 bit big endian floating point value into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gfloat to store the result + + + + + + Read a 32 bit little endian floating point value into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gfloat to store the result + + + + + + Read a 64 bit big endian floating point value into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gdouble to store the result + + + + + + Read a 64 bit little endian floating point value into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gdouble to store the result + + + + + + Read a signed 16 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint16 to store the result + + + + + + Read a signed 16 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint16 to store the result + + + + + + Read a signed 24 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 24 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 32 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 32 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint32 to store the result + + + + + + Read a signed 64 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint64 to store the result + + + + + + Read a signed 64 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint64 to store the result + + + + + + Read a signed 8 bit integer into @val but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #gint8 to store the result + + + + + + Returns a constant pointer to the current data position if there is +a NUL-terminated string in the data (this could be just a NUL terminator). +The current position will be maintained. This will work for any +NUL-terminated string with a character width of 8 bits, so ASCII, +UTF-8, ISO-8859-N etc. +No input checking for valid UTF-8 is done. +This function will fail if no NUL-terminator was found in in the data. + + %TRUE if a string could be skipped, %FALSE otherwise. + + + + + address of a #gchar pointer varieble in which to store the result + + + + + + + + Read an unsigned 16 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint16 to store the result + + + + + + Read an unsigned 16 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint16 to store the result + + + + + + Read an unsigned 24 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 24 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 32 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 32 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint32 to store the result + + + + + + Read an unsigned 64 bit big endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint64 to store the result + + + + + + Read an unsigned 64 bit little endian integer into @val +but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint64 to store the result + + + + + + Read an unsigned 8 bit integer into @val but keep the current position. + + %TRUE if successful, %FALSE otherwise. + + + + + Pointer to a #guint8 to store the result + + + + + + Sets the new position of a #GstByteReader instance to @pos in bytes. +otherwise. + + %TRUE if the position could be set successfully, %FALSE + + + + + The new position in bytes + + + + + + Skips @nbytes bytes of the #GstByteReader instance. + + %TRUE if @nbytes bytes could be skipped, %FALSE otherwise. + + + + + the number of bytes to skip + + + + + + Skips a NUL-terminated UTF-16 string in the #GstByteReader instance, +advancing the current position to the byte after the string. +No input checking for valid UTF-16 is done. +This function will fail if no NUL-terminator was found in in the data. + + %TRUE if a string could be skipped, %FALSE otherwise. + + + + + Skips a NUL-terminated UTF-32 string in the #GstByteReader instance, +advancing the current position to the byte after the string. +No input checking for valid UTF-32 is done. +This function will fail if no NUL-terminator was found in in the data. + + %TRUE if a string could be skipped, %FALSE otherwise. + + + + + Skips a NUL-terminated string in the #GstByteReader instance, advancing +the current position to the byte after the string. This will work for +any NUL-terminated string with a character width of 8 bits, so ASCII, +UTF-8, ISO-8859-N etc. No input checking for valid UTF-8 is done. +This function will fail if no NUL-terminator was found in in the data. + + %TRUE if a string could be skipped, %FALSE otherwise. + + + - + + A byte writer instance. - + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Checks if enough free space from the current write cursor is +available and reallocates if necessary. - + %TRUE if at least @size bytes are still available + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Number of bytes that should be available + + Writes @size bytes containing @value to @writer. - + %TRUE if the value could be written + - + Value to be writen + - + Number of bytes to be writen + - + Frees @writer and all memory allocated by it. - + + + + + Frees @writer and all memory allocated by it except +the current data, which is returned as #GstBuffer. +after usage. + + the current data as buffer. gst_buffer_unref() + + + + + Frees @writer and all memory allocated by it except +the current data, which is returned. + + the current data. g_free() after usage. + + + + + Returns the remaining size of data that can still be written. If +-1 is returned the remaining size is only limited by system resources. + + the remaining size of data that can still be written + + + + + Initializes @writer to an empty instance + + + + + + Initializes @writer with the given +buffer. If @initialized is %TRUE it is possible to +read the complete buffer from the #GstByteWriter from the beginning. +<note>@buffer must be writable</note> + + + + + + Buffer used for writing + + + + If %TRUE the complete data can be read from the beginning + + + + + + Initializes @writer with the given +memory area. If @initialized is %TRUE it is possible to +read @size bytes from the #GstByteWriter from the beginning. + + - + Memory area for writing + + + + + + Size of @data in bytes + + + + If %TRUE the complete data can be read from the beginning + + + + + + Initializes @writer with the given initial data size. + + + + + + Initial size of data + + + + If %TRUE the data can't be reallocated + + + + + + Writes @size bytes of @data to @writer. + + %TRUE if the value could be written + + + + + Data to write + + + + + + Size of @data in bytes + + + + + + Writes a big endian 32 bit float to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a little endian 32 bit float to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a big endian 64 bit float to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a little endian 64 bit float to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed big endian 16 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed little endian 16 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed big endian 24 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed little endian 24 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed big endian 32 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed little endian 32 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed big endian 64 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed little endian 64 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a signed 8 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + Writes a NUL-terminated UTF16 string to @writer (including the terminator). - + %TRUE if the value could be written + - - + + UTF16 string to write + + + + Writes a NUL-terminated UTF32 string to @writer (including the terminator). - + %TRUE if the value could be written + - - + + UTF32 string to write + + + + + Writes a NUL-terminated UTF8 string to @writer (including the terminator). + + %TRUE if the value could be written + + + + + UTF8 string to write + + + + + + + + Writes a unsigned big endian 16 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned little endian 16 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned big endian 24 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned little endian 24 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned big endian 32 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned little endian 32 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned big endian 64 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned little endian 64 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Writes a unsigned 8 bit integer to @writer. + + %TRUE if the value could be written + + + + + Value to write + + + + + + Resets @writer and frees the data if it's +owned by @writer. + + + + + + Resets @writer and returns the current data as buffer. +after usage. + + the current data as buffer. gst_buffer_unref() + + + + + Resets @writer and returns the current data. + + the current data. g_free() after usage. + + + - + + Structure used by the collect_pads. @@ -4325,7 +4649,7 @@ available and reallocates if necessary." - + @@ -4333,101 +4657,63 @@ available and reallocates if necessary." - + - + - + - + - + + A function that will be called when the #GstCollectData will be freed. +It is passed the pointer to the structure and should free any custom +memory and resources allocated for it. + the #GstCollectData that will be freed - + Collectpads object. +Note that @data is only reliable for iterating the list of #GstCollectData +when inside the #GstCollectPadsFunction callback. + + Create a new instance of #GstCollectPads. +MT safe. + a new #GstCollectPads, or NULL in case of an error. - - - - - - - - - - - - - - - - - - - - - - - - - - + Add a pad to the collection of collect pads. The pad has to be a sinkpad. The refcount of the pad is incremented. Use gst_collect_pads_remove_pad() to remove the pad from the collection again. @@ -4438,26 +4724,30 @@ You specify a size for the returned #GstCollectData structure so that you can use it to store additional information. The pad will be automatically activated in push mode when @pads is started. -This function calls gst_collect_pads_add_pad() passing a value of NULL +This function calls gst_collect_pads_add_pad_full() passing a value of NULL for destroy_notify. if wrong parameters are supplied. -MT safe."> - +MT safe. + + a new #GstCollectData to identify the new pad. Or NULL + the pad to add - + the size of the returned #GstCollectData structure + + Add a pad to the collection of collect pads. The pad has to be a sinkpad. The refcount of the pad is incremented. Use gst_collect_pads_remove_pad() to remove the pad from the collection again. @@ -4470,243 +4760,310 @@ allocated for it. The pad will be automatically activated in push mode when @pads is started. if wrong parameters are supplied. -MT safe." - version="0.10.12"> - +MT safe. + + a new #GstCollectData to identify the new pad. Or NULL + the pad to add - + the size of the returned #GstCollectData structure + - + + function to be called before the returned #GstCollectData structure is freed - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Query how much bytes can be read from each queued buffer. This means that the result of this call is the maximum number of bytes that can be read from each of the pads. This function should be called with @pads LOCK held, such as in the callback. returns 0 if a pad has no queued buffer. -MT safe."> +MT safe. - + The maximum number of bytes queued on all pads. This function + - + Collect data on all pads. This function is usually called +from a #GstTask function in an element. +This function is currently not implemented. +MT safe. + + #GstFlowReturn of the operation. + + + + + Collect data with @offset and @length on all pads. This function +is typically called in the getrange function of an element. +This function is currently not implemented. +MT safe. + + #GstFlowReturn of the operation. + + + + + the offset to collect + + + + the length to collect + + + + + + Flush @size bytes from the pad @data. +This function should be called with @pads LOCK held, such as +in the callback. +is 0 if the pad was end-of-stream. +MT safe. + + The number of bytes flushed. This can be less than @size and + + + + + the data to use + + + + the number of bytes to flush + + + + + + Check if a pad is active. +This function is currently not implemented. +MT safe. + + %TRUE if the pad is active. + + + + + the pad to check + + + + + + Peek at the buffer currently queued in @data. This function +should be called with the @pads LOCK held, such as in the callback +handler. +should unref the buffer after usage. +MT safe. + + The buffer in @data or NULL if no buffer is queued. + + + + + the data to use + + + + + + Pop the buffer currently queued in @data. This function +should be called with the @pads LOCK held, such as in the callback +handler. +queued. You should unref the buffer after usage. +MT safe. + + The buffer in @data or NULL if no buffer was + + + + + the data to use + + + + + + Get a pointer in @bytes where @size bytes can be read from the given pad @data. This function should be called with @pads LOCK held, such as in the callback. memory pointed to by @bytes. This can be less than @size and is 0 if the pad is end-of-stream. -MT safe."> +MT safe. - + The number of bytes available for consumption in the + + the data to use - - + + a pointer to a byte array + + + - - + + the number of bytes to read + + Get a buffer of @size bytes from the given pad @data. +This function should be called with @pads LOCK held, such as in the callback. +that requested. A return of NULL signals that the pad is end-of-stream. +Unref the buffer with gst_buffer_unref() after use. +MT safe. + a #GstBuffer. The size of the buffer can be less + the data to use - + the number of bytes to read + + + Remove a pad from the collection of collect pads. This function will also +free the #GstCollectData and all the resources that were allocated with +gst_collect_pads_add_pad(). +The pad will be deactivated automatically when @pads is stopped. +MT safe. + + %TRUE if the pad could be removed. + + + + + the pad to remove + + + + + + Install a clipping function that is called right after a buffer is received +on a pad managed by @pads. See #GstCollectDataClipFunction for more info. + + + + + + clip function to install + + + + user data to pass to @clip_func + + + + + + Change the flushing state of all the pads in the collection. No pad +is able to accept anymore data when @flushing is %TRUE. Calling this +function with @flushing %FALSE makes @pads accept data again. +MT safe. + + + + + + desired state of the pads + + + + + + Set the callback function and user data that will be called when +all the pads added to the collection have buffers queued. +MT safe. + + + + + + the function to set + + + + user data passed to the function + + + + + + Starts the processing of data in the collect_pads. +MT safe. + + + + + + Stops the processing of data in the collect_pads. this function +will also unblock any blocking operations. +MT safe. + + + + + Get a buffer of @size bytes from the given pad @data. Flushes the amount of read bytes. This function should be called with @pads LOCK held, such as in the callback. -A return of NULL signals that the pad is end-of-stream. +that requested. A return of NULL signals that the pad is end-of-stream. Unref the buffer after use. -MT safe." - version="0.10.18"> +MT safe. + a #GstBuffer. The size of the buffer can be less + the data to use - - - - - - - - - - - - - - + the number of bytes to read + @@ -4714,10 +5071,12 @@ MT safe."> - + + + - + @@ -4726,19 +5085,19 @@ MT safe."> - + - + - + - + - + @@ -4746,10 +5105,12 @@ MT safe."> - + + + - + @@ -4757,7 +5118,7 @@ MT safe."> - + @@ -4770,226 +5131,257 @@ MT safe."> - + + A function that will be called when @buffer is received on the pad managed by @data in the collecpad object @pads. The function should use the segment of @data and the negotiated media type on -the pad to perform clipping of @buffer. +the pad to perform clipping of @buffer. This function takes ownership of @buffer. -the buffer has been clipped completely." - version="0.10.26"> - +the buffer has been clipped completely. + + a #GstBuffer that contains the clipped data of @buffer or NULL when + a #GstCollectPads + a #GstCollectData + a #GstBuffer - + user data + - - + + A function that will be called when all pads have received data. + + #GST_FLOW_OK for success + the #GstCollectPads that triggered the callback - + user data passed to gst_collect_pads_set_function() + - + - + Opaque #GstDataQueue structure. + + a new #GstDataQueue. - + + the callback used to tell if the element considers the queue full or not. - + a #gpointer that will be given in the @checkfull callback. + + version="0.10.26" + introspectable="0"> + Creates a new #GstDataQueue. The difference with @gst_data_queue_new is that it will +not emit the 'full' and 'empty' signals, but instead calling directly @fullcallback +or @emptycallback. + a new #GstDataQueue. - + + the callback used to tell if the element considers the queue full or not. - + + the callback which will be called when the queue is considered full. + the callback which will be called when the queue is considered empty. - + a #gpointer that will be given in the @checkfull callback. + - + + Pop and unref the head-most #GstMiniObject with the given #GType. - + TRUE if an element was removed. + - - - - - - - - - - - - + + The #GType of the item to drop. + + Flushes all the contents of the @queue. Any call to #gst_data_queue_push and #gst_data_queue_pop will be released. -MT safe."> +MT safe. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + version="0.10.11"> + Get the current level of the queue. + the location to store the result + + Queries if there are any items in the @queue. +MT safe. + + #TRUE if @queue is empty. + + + + + Queries if @queue is full. This check will be done using the +#GstDataQueueCheckFullFunction registered with @queue. +MT safe. + + #TRUE if @queue is full. + + + + version="0.10.11"> + Inform the queue that the limits for the fullness check have changed and that +any blocking gst_data_queue_push() should be unblocked to recheck the limts. - - + + Retrieves the first @item available on the @queue. If the queue is currently +empty, the call will block until at least one item is available, OR the +MT safe. + + #TRUE if an @item was successfully retrieved from the @queue. + + + + + pointer to store the returned #GstDataQueueItem. + + + + + + Pushes a #GstDataQueueItem (or a structure that begins with the same fields) +on the @queue. If the @queue is full, the call will block until space is +available, OR the @queue is set to flushing state. +MT safe. +Note that this function has slightly different semantics than gst_pad_push() +the #GstMiniObject contained in @item if the push was successful. If FALSE +is returned, the caller is responsible for freeing @item and its contents. + + #TRUE if the @item was successfully pushed on the @queue. + + + + + a #GstDataQueueItem. + + + + + + Sets the queue to flushing state if @flushing is #TRUE. If set to flushing +state, any incoming data on the @queue will be discarded. Any call currently +blocking on #gst_data_queue_push or #gst_data_queue_pop will return straight +away with a return value of #FALSE. While the @queue is in flushing state, +all calls to those two functions will return #FALSE. +MT Safe. + + + + + + a #gboolean stating if the queue will be flushing or not. + + + + + + - - + + - - + + @@ -5005,7 +5397,7 @@ any blocking gst_data_queue_push() should be unblocked to recheck the limts."> c:type="GstDataQueueCheckFullFunction"/> - + @@ -5017,7 +5409,7 @@ any blocking gst_data_queue_push() should be unblocked to recheck the limts."> - + @@ -5026,52 +5418,69 @@ any blocking gst_data_queue_push() should be unblocked to recheck the limts."> - - - - - - + + + + + + + + + + + + + + + + Reports that the queue became empty (empty). A queue is empty if the total amount of visible items inside it (num-visible, time, size) is lower than the boundary values which can be set through the GObject -properties."> - - +properties. + + - + Reports that the queue became full (full). A queue is full if the total amount of data inside it (num-visible, time, size) is higher than the boundary values which can be set through the GObject -properties."> - - +properties. + + + version="0.10.11"> + The prototype of the function used to inform the queue that it should be +considered as full. - + #TRUE if the queue should be considered full. + + a #GstDataQueue. - + The number of visible items currently in the queue. + - + The amount of bytes currently in the queue. + - + The accumulated duration of the items currently in the queue. + - + The #gpointer registered when the #GstDataQueue was created. + @@ -5082,7 +5491,7 @@ considered as full."> - + @@ -5094,7 +5503,7 @@ considered as full."> - + @@ -5107,7 +5516,7 @@ considered as full."> - + @@ -5120,7 +5529,7 @@ considered as full."> - + @@ -5133,55 +5542,51 @@ considered as full."> - + - + + Structure used by #GstDataQueue. You can supply a different structure, as +long as the top of the structure is identical to this structure. - + - + - + - + + Structure describing the size of a queue. - + - + - + + The opaque #GstPushSrc data structure. - + @@ -5195,7 +5600,7 @@ long as the top of the structure is identical to this structure."> - + @@ -5206,8 +5611,8 @@ long as the top of the structure is identical to this structure."> - - + + @@ -5222,61 +5627,218 @@ long as the top of the structure is identical to this structure."> - + - - - - - - + This function will be called by gst_type_find_helper_get_range() when typefinding functions request to peek at the data of a stream at certain offsets. If this function returns GST_FLOW_OK, the result buffer will be stored in @buffer. The contents of @buffer is invalid for any other return value. -This function is supposed to behave exactly like a #GstPadGetRangeFunction."> - +This function is supposed to behave exactly like a #GstPadGetRangeFunction. + + GST_FLOW_OK for success + a #GstObject that will handle the getrange request - + the offset of the range + - + the length of the range + + a memory location to hold the result buffer - + + Create a new #GstBitReader instance, which will read from @data. + a new #GstBitReader instance + + + + + Data from which the #GstBitReader should read + + + + Size of @data in bytes + + + + + + Create a new #GstBitReader instance, which will read from the +#GstBuffer @buffer. + + a new #GstBitReader instance + + + + + Buffer from which the #GstBitReader should read + + + + + + Create a new #GstByteReader instance, which will read from @data. + + a new #GstByteReader instance + + + + + data from which the #GstByteReader should read + + + + + + Size of @data in bytes + + + + + + Create a new #GstByteReader instance, which will read from the +#GstBuffer @buffer. + + a new #GstByteReader instance + + + + + Buffer from which the #GstByteReader should read + + + + + + Creates a new, empty #GstByteWriter instance + + a new, empty #GstByteWriter instance + + + + + Creates a new #GstByteWriter instance with the given +buffer. If @initialized is %TRUE it is possible to +read the complete buffer from the #GstByteWriter from the beginning. +<note>@buffer must be writable</note> + + a new #GstByteWriter instance + + + + + Buffer used for writing + + + + If %TRUE the complete data can be read from the beginning + + + + + + Creates a new #GstByteWriter instance with the given +memory area. If @initialized is %TRUE it is possible to +read @size bytes from the #GstByteWriter from the beginning. + + a new #GstByteWriter instance + + + + + Memory area for writing + + + + Size of @data in bytes + + + + If %TRUE the complete data can be read from the beginning + + + + + + Creates a new #GstByteWriter instance with the given +initial data size. + + a new #GstByteWriter instance + + + + + Initial size of data + + + + If %TRUE the data can't be reallocated + + + + + + Tries to find what type of data is flowing from the given source #GstPad. +Returns #NULL if no #GstCaps matches the data stream. + + the #GstCaps corresponding to the data stream. + A source #GstPad - + The length in bytes + + Tries to find what type of data is contained in the given #GstBuffer, the assumption being that the buffer represents the beginning of the stream or file. All available typefinders will be called on the data in order of rank. If @@ -5285,18 +5847,27 @@ typefinding is stopped immediately and the found caps will be returned right away. Otherwise, all available typefind functions will the tried, and the caps with the highest probability will be returned, or #NULL if the content of the buffer could not be identified. -be found. The caller should free the caps returned with gst_caps_unref()."> +if no type could be found. The caller should free the caps returned +with gst_caps_unref(). + the #GstCaps corresponding to the data, or #NULL + object doing the typefinding, or NULL (used for logging) + a #GstBuffer with data to typefind - + + location to store the probability of the found caps, or #NULL @@ -5304,28 +5875,31 @@ be found. The caller should free the caps returned with gst_caps_unref()."> + Tries to find the best #GstCaps associated with @extension. All available typefinders will be checked against the extension in order of rank. The caps of the first typefinder that can handle @extension will be returned. -be found. The caller should free the caps returned with gst_caps_unref()." - version="0.10.23"> +#NULL if no type could be found. The caller should free the caps +returned with gst_caps_unref(). + the #GstCaps corresponding to @extension, or - + + object doing the typefinding, or NULL (used for logging) + an extension + Utility function to do pull-based typefinding. Unlike gst_type_find_helper() however, this function will use the specified function @func to obtain the data needed by the typefind functions, rather than operating on a given source pad. This is useful mostly for elements like tag demuxers which @@ -5333,22 +5907,31 @@ strip off data at the beginning and/or end of a file and want to typefind the stripped data stream before adding their own source pad (the specified callback can then call the upstream peer pad with offsets adjusted for the tag size, for example). -Returns #NULL if no #GstCaps matches the data stream."> +Returns #NULL if no #GstCaps matches the data stream. + the #GstCaps corresponding to the data stream. + A #GstObject that will be passed as first argument to @func + A generic #GstTypeFindHelperGetRangeFunction that will be used to access data at random offsets when doing the typefinding - + The length in bytes + - + + location to store the probability of the found caps, or #NULL @@ -5356,8 +5939,8 @@ Returns #NULL if no #GstCaps matches the data stream."> + Utility function to do pull-based typefinding. Unlike gst_type_find_helper() however, this function will use the specified function @func to obtain the data needed by the typefind functions, rather than operating on a given source pad. This is useful mostly for elements like tag demuxers which @@ -5368,26 +5951,35 @@ tag size, for example). When @extension is not NULL, this function will first try the typefind functions for the given extension, which might speed up the typefinding in many cases. -Returns #NULL if no #GstCaps matches the data stream." - version="0.10.26"> +Returns #NULL if no #GstCaps matches the data stream. + the #GstCaps corresponding to the data stream. + A #GstObject that will be passed as first argument to @func + A generic #GstTypeFindHelperGetRangeFunction that will be used to access data at random offsets when doing the typefinding - + The length in bytes + + extension of the media - + + location to store the probability of the found caps, or #NULL diff --git a/unmaintained/gstreamer/base/base.factor b/extra/gstreamer/base/base.factor similarity index 100% rename from unmaintained/gstreamer/base/base.factor rename to extra/gstreamer/base/base.factor diff --git a/unmaintained/gstreamer/base/ffi/ffi.factor b/extra/gstreamer/base/ffi/ffi.factor similarity index 66% rename from unmaintained/gstreamer/base/ffi/ffi.factor rename to extra/gstreamer/base/ffi/ffi.factor index 1f15ecf3e4..3508186d1e 100644 --- a/unmaintained/gstreamer/base/ffi/ffi.factor +++ b/extra/gstreamer/base/ffi/ffi.factor @@ -1,9 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection glib.ffi gstreamer.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gstreamer.base.ffi +<< +"gstreamer.ffi" require +>> + +LIBRARY: gstreamer.base + << "gstreamer.base" { { [ os winnt? ] [ drop ] } diff --git a/unmaintained/gstreamer/controller/GstController-0.10.gir b/extra/gstreamer/controller/GstController-0.10.gir similarity index 55% rename from unmaintained/gstreamer/controller/GstController-0.10.gir rename to extra/gstreamer/controller/GstController-0.10.gir index 137e69a1b4..d7174f1f5d 100644 --- a/unmaintained/gstreamer/controller/GstController-0.10.gir +++ b/extra/gstreamer/controller/GstController-0.10.gir @@ -2,7 +2,7 @@ - @@ -11,69 +11,77 @@ and/or use gtk-doc annotations. --> - + + shared-library="libgstreamer-0.10.so.0,libgstcontroller-0.10.so.0" + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> - + The instance structure of #GstControlSource. + + Binds a #GstControlSource to a specific property. This must be called only once for a +#GstControlSource. - + %TRUE if the #GstControlSource was bound correctly, %FALSE otherwise. + + + + + #GParamSpec for the property for which this #GstControlSource should generate values. + + + + + + Gets the value for this #GstControlSource at a given timestamp. + + FALSE if the value couldn't be returned, TRUE otherwise. + + the time for which the value should be returned + the value + Gets an array of values for one element property. All fields of @value_array must be filled correctly. Especially the of values. -The type of the values in the array is the same as the property's type."> +The type of the values in the array is the same as the property's type. - + %TRUE if the given array could be filled, %FALSE otherwise + + the time that should be processed + array to put control-values in - - - - - - - - - - @@ -85,17 +93,17 @@ The type of the values in the array is the same as the property's type."> c:type="GstControlSourceGetValueArray"/> - + - + - + @@ -108,8 +116,8 @@ The type of the values in the array is the same as the property's type."> + glib:is-gtype-struct-for="ControlSource"> + The class structure of #GstControlSource. @@ -118,13 +126,13 @@ The type of the values in the array is the same as the property's type."> - + - + @@ -141,7 +149,7 @@ The type of the values in the array is the same as the property's type."> - + @@ -156,35 +164,24 @@ The type of the values in the array is the same as the property's type."> - - - - - - - - - - - - - + The instance structure of GstController + introspectable="0"> + Creates a new GstController for the given object's properties + the new controller. + the object of which some properties should be controlled @@ -193,312 +190,414 @@ The type of the values in the array is the same as the property's type."> - - - + + Creates a new GstController for the given object's properties + + the new controller. + - - + + the object of which some properties should be controlled + + + + list of property names that should be controlled + + + + + + + + Creates a new GstController for the given object's properties + + the new controller. + + + + + the object of which some properties should be controlled + + + + %NULL terminated list of property names that should be controlled + + + + + + Initializes the use of the controller library. Suggested to be called right +after gst_init(). + + the %TRUE for success. + + + + + pointer to the commandline argument count + + pointer to the commandline argument values - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the value for the given controller-handled property at the requested +time. +property isn't handled by the controller + + the GValue of the property at the given time, or %NULL if the + + the name of the property to get - - + + the time the control-change should be read from + - + + Returns a read-only copy of the list of #GstTimedValue for the given property. +Free the list after done with it. +<note><para>This doesn't modify the controlled GObject property!</para></note> +directly. - + a copy of the list, or %NULL if the property isn't handled by the controller + + + + the name of the property to get the list for - - - + Gets the corresponding #GstControlSource for the property. This should be unreferenced again after use. -controlled by this controller or no #GstControlSource was assigned yet." - version="0.10.14"> - +controlled by this controller or no #GstControlSource was assigned yet. + + the #GstControlSource for @property_name or NULL if the property is not + name of the property for which the #GstControlSource should be get - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Function to be able to get an array of values for one element property. All fields of @value_array must be filled correctly. Especially the of values. -The type of the values in the array is the same as the property's type. -<note><para>This doesn't modify the controlled GObject property!</para></note>"> +The type of the values in the array is the same as the property's type. +<note><para>This doesn't modify the controlled GObject property!</para></note> - + %TRUE if the given array could be filled, %FALSE otherwise + + the time that should be processed + array to put control-values in + + Function to be able to get an array of values for one or more given element +properties. +All fields of the %GstValueArray in the list must be filled correctly. +Especially the GstValueArray->values arrays must be big enough to keep +the requested amount of values. +The types of the values in the array are the same as the property's type. +<note><para>This doesn't modify the controlled GObject properties!</para></note> + + %TRUE if the given array(s) could be filled, %FALSE otherwise + + + + + the time that should be processed + + + + list to return the control-values in + + + + + + + + Removes the given object properties from the controller + + %FALSE if one of the given property isn't handled by the controller, %TRUE otherwise + + + + + + + + + + + Removes the given object properties from the controller + + %FALSE if one of the given property isn't handled by the controller, %TRUE otherwise + + + + + #GList of property names that should be removed + + + + + + + + Removes the given object properties from the controller + + %FALSE if one of the given property isn't handled by the controller, %TRUE otherwise + + + + + %NULL terminated list of property names that should be removed + + + + - - + Set the value of given controller-handled property at a certain time. +directly. + + FALSE if the values couldn't be set (ex : properties not handled by controller), TRUE otherwise + + the name of the property to set + the time the control-change is schedules for + the control-value + + Sets the #GstControlSource for @property_name. If there already was a #GstControlSource +for this property it will be unreferenced. +couldn't be bound to the property, %TRUE if everything worked as expected. + + %FALSE if the given property isn't handled by the controller or the new #GstControlSource + + + + + name of the property for which the #GstControlSource should be set + + + + the #GstControlSource that should be used for the property + + + + + + This function is used to disable all properties of the #GstController +for some time, i.e. gst_controller_sync_values() will do nothing. + + + + + + boolean that specifies whether to disable the controller or not. + + + + - - + Sets multiple timed values at once. +directly. + + %FALSE if the values couldn't be set (ex : properties not handled by controller), %TRUE otherwise + + the name of the property to set - + a list with #GstTimedValue items + + + + + + + + Sets the given interpolation mode on the given property. +<note><para>User interpolation is not yet available and quadratic interpolation +is deprecated and maps to cubic interpolation.</para></note> +directly. + + %TRUE if the property is handled by the controller, %FALSE otherwise + + + + + the name of the property for which to change the interpolation + + + + interpolation mode + + + + + + This function is used to disable the #GstController on a property for +some time, i.e. gst_controller_sync_values() will do nothing for the +property. + + + + + + property to disable + + + + boolean that specifies whether to disable the controller or not. + + + + + + Returns a suggestion for timestamps where buffers should be split +to get best controller results. +if no control-rate was set. + + Returns the suggested timestamp or %GST_CLOCK_TIME_NONE + + + + + Sets the properties of the element, according to the controller that (maybe) +handles them and for the given timestamp. +If this function fails, it is most likely the application developers fault. +Most probably the control sources are not setup correctly. +properties, %FALSE otherwise + + %TRUE if the controller values could be applied to the object + + + + + the time that should be processed + - - + Used to remove the value of given controller-handled property at a certain +time. +directly. + + %FALSE if the values couldn't be unset (ex : properties not handled by controller), %TRUE otherwise + + the name of the property to unset + the time the control-change should be removed from + Used to remove all time-stamped values of given controller-handled property +directly. +by controller), %TRUE otherwise - + %FALSE if the values couldn't be unset (ex : properties not handled + + the name of the property to unset - - - - - - - - - - - - - - - - - - - - - - - - - + + - + + + @@ -511,7 +610,7 @@ directly." - + @@ -523,16 +622,16 @@ directly." - + - + - + + The various interpolation modes available. @@ -543,109 +642,126 @@ The various interpolation modes available." + The instance structure of #GstControlSource. + c:identifier="gst_interpolation_control_source_new"> + This returns a new, unbound #GstInterpolationControlSource. + a new, unbound #GstInterpolationControlSource. - - - + + Returns a read-only copy of the list of #GstTimedValue for the given property. +Free the list after done with it. + + a copy of the list, or %NULL if the property isn't handled by the controller + + + - - - - - - + + Returns the number of control points that are set. - + the number of control points that are set. + + + + + Set the value of given controller-handled property at a certain time. + + FALSE if the values couldn't be set, TRUE otherwise. + + the time the control-change is scheduled for + the control-value + c:identifier="gst_interpolation_control_source_set_from_list"> + Sets multiple timed values at once. - + FALSE if the values couldn't be set, TRUE otherwise. + - + a list with #GstTimedValue items + + + + + + + + Sets the given interpolation mode. +<note><para>User interpolation is not yet available and quadratic interpolation +is deprecated and maps to cubic interpolation.</para></note> + + %TRUE if the interpolation mode could be set, %FALSE otherwise + + + + + interpolation mode + + c:identifier="gst_interpolation_control_source_unset"> + Used to remove the value of given controller-handled property at a certain +time. - + FALSE if the value couldn't be unset (i.e. not found, TRUE otherwise. + + the time the control-change should be removed from + c:identifier="gst_interpolation_control_source_unset_all"> + Used to remove all time-stamped values of given controller-handled property - - - - - - - - - - - + - + - + - + @@ -657,55 +773,57 @@ Free the list after done with it."> - + + c:type="GstInterpolationControlSourcePrivate" + disguised="1"> - + The instance structure of #GstControlSource. + + This returns a new, unbound #GstLFOControlSource. + a new, unbound #GstLFOControlSource. - - + + - - + + - - + + - - + + - - + + - + - + - + - + @@ -717,17 +835,19 @@ Free the list after done with it."> - + - + + The various waveform modes available. c:identifier="GST_LFO_WAVEFORM_TRIANGLE" glib:nick="triangle"/> - + + Structure for saving a timestamp and a value. @@ -759,35 +878,37 @@ Free the list after done with it."> - + + Structure to receive multiple values at once. - + - + + Convenience function for GObject Creates a GstController that allows you to dynamically control one, or more, GObject properties. If the given GObject already has a GstController, it adds the given properties to the existing controller and returns that controller. -one or more of the given properties aren't available, or cannot be controlled, for the given element." - version="0.9"> - +one or more of the given properties aren't available, or cannot be controlled, for the given element. + + The GstController with which the user can control the given properties dynamically or NULL if + the object of which some properties should be controlled @@ -798,201 +919,235 @@ one or more of the given properties aren't available, or cannot be controll + Obtain the control-rate for this @object. Audio processing #GstElement objects will use this rate to sub-divide their processing loop and call gst_object_sync_values() inbetween. The length of the processing segment should be up to @control-rate nanoseconds. If the @object is not under property control, this will return %GST_CLOCK_TIME_NONE. This allows the element to avoid the sub-dividing. The control-rate is not expected to change if the element is in -%GST_STATE_PAUSED or %GST_STATE_PLAYING." - version="0.10.10"> - +%GST_STATE_PAUSED or %GST_STATE_PLAYING. + + the control rate in nanoseconds + the object that has controlled properties + Gets the corresponding #GstControlSource for the property. This should be unreferenced again after use. -controlled by this controller or no #GstControlSource was assigned yet." - version="0.10.14"> - +controlled by this controller or no #GstControlSource was assigned yet. + + the #GstControlSource for @property_name or NULL if the property is not + the object + name of the property for which the #GstControlSource should be get - + version="0.9" + introspectable="0"> + Gets the controller for the given GObject + + the controller handling some of the given element's properties, %NULL if no controller + the object that has controlled properties - - + Function to be able to get an array of values for one element properties +If the GstValueArray->values array is NULL, it will be created by the function. +The type of the values in the array are the same as the property's type. +The g_object_* functions are just convenience functions for GObject + + %TRUE if the given array(s) could be filled, %FALSE otherwise + + the object that has controlled properties + the time that should be processed + array to put control-values in + Function to be able to get an array of values for one or more given element properties. If the GstValueArray->values array in list nodes is NULL, it will be created by the function. -The type of the values in the array are the same as the property's type. -The g_object_* functions are just convenience functions for GObject" - version="0.9"> - - +The type of the values in the array are the same as the property's type. +The g_object_* functions are just convenience functions for GObject + + %TRUE if the given array(s) could be filled, %FALSE otherwise + + the object that has controlled properties + the time that should be processed - + list to return the control-values in + + + + Change the control-rate for this @object. Audio processing #GstElement objects will use this rate to sub-divide their processing loop and call gst_object_sync_values() inbetween. The length of the processing segment should be up to @control-rate nanoseconds. The control-rate should not change if the element is in %GST_STATE_PAUSED or -%GST_STATE_PLAYING." - version="0.10.10"> +%GST_STATE_PLAYING. + the object that has controlled properties + the new control-rate in nanoseconds. + Sets the #GstControlSource for @property_name. If there already was a #GstControlSource +for this property it will be unreferenced. +couldn't be bound to the property, %TRUE if everything worked as expected. - + %FALSE if the given property isn't handled by the controller or the new #GstControlSource + + the controller object + name of the property for which the #GstControlSource should be set + the #GstControlSource that should be used for the property + Sets the controller on the given GObject - + %FALSE if the GObject already has an controller, %TRUE otherwise + + the object that should get the controller + the controller object to plug in - + Convenience function for GObject + + same thing as gst_controller_suggest_next_sync() + the object that has controlled properties + Convenience function for GObject - + same thing as gst_controller_sync_values() + + the object that has controlled properties + the time that should be processed + version="0.9" + introspectable="0"> + Convenience function for GObject +Removes the given element's properties from it's controller +controller, %TRUE otherwise - + %FALSE if one of the given property names isn't handled by the + + the object of which some properties should not be controlled anymore diff --git a/unmaintained/gstreamer/controller/controller.factor b/extra/gstreamer/controller/controller.factor similarity index 100% rename from unmaintained/gstreamer/controller/controller.factor rename to extra/gstreamer/controller/controller.factor diff --git a/unmaintained/gstreamer/controller/ffi/ffi.factor b/extra/gstreamer/controller/ffi/ffi.factor similarity index 67% rename from unmaintained/gstreamer/controller/ffi/ffi.factor rename to extra/gstreamer/controller/ffi/ffi.factor index ea5de2f3a1..9ecb291786 100644 --- a/unmaintained/gstreamer/controller/ffi/ffi.factor +++ b/extra/gstreamer/controller/ffi/ffi.factor @@ -1,10 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.c-types alien.libraries combinators kernel -system -gobject-introspection glib.ffi gobject.ffi gstreamer.ffi ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gstreamer.controller.ffi +<< +"gstreamer.ffi" require +>> + +LIBRARY: gstreamer.controller + << "gstreamer.controller" { { [ os winnt? ] [ drop ] } diff --git a/unmaintained/gstreamer/riff/ffi/ffi.factor b/extra/gstreamer/ffi/ffi.factor similarity index 52% rename from unmaintained/gstreamer/riff/ffi/ffi.factor rename to extra/gstreamer/ffi/ffi.factor index ac31e7d0c5..57c6a169c8 100644 --- a/unmaintained/gstreamer/riff/ffi/ffi.factor +++ b/extra/gstreamer/ffi/ffi.factor @@ -1,11 +1,17 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.syntax alien.libraries combinators kernel -system -gobject-introspection glib.ffi gmodule.ffi gobject.ffi ; -EXCLUDE: alien.c-types => pointer ; +USING: alien alien.c-types alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gstreamer.ffi +<< +"glib.ffi" require +"gobject.ffi" require +"gmodule.ffi" require +>> + +LIBRARY: gstreamer + << "gstreamer" { { [ os winnt? ] [ drop ] } @@ -14,14 +20,19 @@ IN: gstreamer.ffi } cond >> -TYPEDEF: gpointer GstClockID -TYPEDEF: guint64 GstClockTime -TYPEDEF: gint64 GstClockTimeDiff + + GIR: vocab:gstreamer/Gst-0.10.gir diff --git a/unmaintained/gstreamer/gstreamer.factor b/extra/gstreamer/gstreamer.factor similarity index 100% rename from unmaintained/gstreamer/gstreamer.factor rename to extra/gstreamer/gstreamer.factor diff --git a/extra/gstreamer/net/GstNet-0.10.gir b/extra/gstreamer/net/GstNet-0.10.gir new file mode 100644 index 0000000000..dde8261b33 --- /dev/null +++ b/extra/gstreamer/net/GstNet-0.10.gir @@ -0,0 +1,299 @@ + + + + + + + + + + + + + + + + Opaque #GstNetClientClock structure. + + Create a new #GstNetClientClock that will report the time +provided by the #GstNetTimeProvider on @remote_address and +clock. + + a new #GstClock that receives a time from the remote + + + + + a name for the clock + + + + the address of the remote clock provider + + + + the port of the remote clock provider + + + + initial time of the clock + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Content of a #GstNetTimePacket. + + + + + + + + Sends a #GstNetTimePacket over a socket. Essentially a thin wrapper around +sendto(2) and gst_net_time_packet_serialize(). +MT safe. + + The return value of sendto(2). + + + + + a file descriptor created by socket(2) + + + + a pointer to a sockaddr to hold the address of the sender + + + + the size of the data pointed to by @addr + + + + + + Serialized a #GstNetTimePacket into a newly-allocated sequence of +#GST_NET_TIME_PACKET_SIZE bytes, in network byte order. The value returned is +suitable for passing to write(2) or sendto(2) for communication over the +network. +MT safe. Caller owns return value (g_free to free). + + A newly allocated sequence of #GST_NET_TIME_PACKET_SIZE bytes. + + + + + + Opaque #GstNetTimeProvider structure. + + Allows network clients to get the current time of @clock. + + the new #GstNetTimeProvider, or NULL on error + + + + + a #GstClock to export over the network + + + + an address to bind on as a dotted quad (xxx.xxx.xxx.xxx), or NULL to bind to all addresses + + + + a port to bind on, or 0 to let the kernel choose + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Creates a new #GstNetTimePacket from a buffer received over the network. The +caller is responsible for ensuring that @buffer is at least +#GST_NET_TIME_PACKET_SIZE bytes long. +If @buffer is #NULL, the local and remote times will be set to +#GST_CLOCK_TIME_NONE. +MT safe. Caller owns return value (g_free to free). + + The new #GstNetTimePacket. + + + + + a buffer from which to construct the packet, or NULL + + + + + + Receives a #GstNetTimePacket over a socket. Handles interrupted system calls, +but otherwise returns NULL on error. See recvfrom(2) for more information on +how to interpret @sockaddr. +MT safe. Caller owns return value (g_free to free). + + The new #GstNetTimePacket. + + + + + a file descriptor created by socket(2) + + + + a pointer to a sockaddr to hold the address of the sender + + + + a pointer to the size of the data pointed to by @addr + + + + + + diff --git a/unmaintained/gstreamer/net/ffi/ffi.factor b/extra/gstreamer/net/ffi/ffi.factor similarity index 66% rename from unmaintained/gstreamer/net/ffi/ffi.factor rename to extra/gstreamer/net/ffi/ffi.factor index fbd5148ff4..d1a0a14a59 100644 --- a/unmaintained/gstreamer/net/ffi/ffi.factor +++ b/extra/gstreamer/net/ffi/ffi.factor @@ -1,10 +1,15 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. -USING: alien alien.libraries combinators kernel system -gobject-introspection glib.ffi gstreamer.ffi ; -FROM: unix.types => socklen_t ; +USING: alien alien.libraries alien.syntax combinators +gobject-introspection kernel system vocabs.loader ; IN: gstreamer.net.ffi +<< +"gstreamer.ffi" require +>> + +LIBRARY: gstreamer.net + << "gstreamer.net" { { [ os winnt? ] [ drop ] } @@ -13,7 +18,5 @@ IN: gstreamer.net.ffi } cond >> -REPLACE-C-TYPE: any gpointer - GIR: vocab:gstreamer/net/GstNet-0.10.gir diff --git a/unmaintained/gstreamer/net/net.factor b/extra/gstreamer/net/net.factor similarity index 100% rename from unmaintained/gstreamer/net/net.factor rename to extra/gstreamer/net/net.factor diff --git a/unmaintained/gstreamer/summary.txt b/extra/gstreamer/summary.txt similarity index 100% rename from unmaintained/gstreamer/summary.txt rename to extra/gstreamer/summary.txt diff --git a/unmaintained/gstreamer/tags.txt b/extra/gstreamer/tags.txt similarity index 100% rename from unmaintained/gstreamer/tags.txt rename to extra/gstreamer/tags.txt diff --git a/unmaintained/gstreamer/fft/GstFft-0.10.gir b/unmaintained/gstreamer/fft/GstFft-0.10.gir deleted file mode 100644 index 578dc59d8b..0000000000 --- a/unmaintained/gstreamer/fft/GstFft-0.10.gir +++ /dev/null @@ -1,462 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/net/GstNet-0.10.gir b/unmaintained/gstreamer/net/GstNet-0.10.gir deleted file mode 100644 index eb3a4b7e87..0000000000 --- a/unmaintained/gstreamer/net/GstNet-0.10.gir +++ /dev/null @@ -1,279 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir b/unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir deleted file mode 100644 index c9748b3f1e..0000000000 --- a/unmaintained/gstreamer/pbutils/GstPbutils-0.10.gir +++ /dev/null @@ -1,665 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/app/GstApp-0.10.gir b/unmaintained/gstreamer/plugins/app/GstApp-0.10.gir similarity index 53% rename from unmaintained/gstreamer/app/GstApp-0.10.gir rename to unmaintained/gstreamer/plugins/app/GstApp-0.10.gir index 40ccd7ed0e..32af8f8d0c 100644 --- a/unmaintained/gstreamer/app/GstApp-0.10.gir +++ b/unmaintained/gstreamer/plugins/app/GstApp-0.10.gir @@ -2,7 +2,7 @@ - @@ -12,48 +12,59 @@ and/or use gtk-doc annotations. --> - - + - - - - - - - - - - - + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> + + - + - + - + - + - + - - - + + + + + + + + + + + + @@ -63,126 +74,110 @@ and/or use gtk-doc annotations. --> - + - - - - - - - - - - - + Get the configured caps on @appsink. + + the #GstCaps accepted by the sink. gst_caps_unref() after usage. + + Check if @appsink will drop old buffers when the maximum amount of queued +buffers is reached. +filled. + + %TRUE if @appsink is dropping old buffers when the queue is + + + + + Check if appsink will emit the "new-preroll" and "new-buffer" signals. +signals. + + %TRUE if @appsink is emiting the "new-preroll" and "new-buffer" + + + + + Get the maximum amount of buffers that can be queued in @appsink. + + The maximum amount of buffers that can be queued. + + + + Check if @appsink is EOS, which is when no more buffers can be pulled because an EOS event was received. This function also returns %TRUE when the appsink is not in the PAUSED or -PLAYING state." - version="0.10.22"> +PLAYING state. - + %TRUE if no more buffers can be pulled and the appsink is EOS. + - - - - - - - - - - - - - + + This function blocks until a buffer or EOS becomes available or the appsink +element is set to the READY/NULL state. +This function will only return buffers when the appsink is in the PLAYING +state. All rendered buffers will be put in a queue so that the application +can pull buffers at its own rate. Note that when the application does not +pull buffers fast enough, the queued buffers could consume a lot of memory, +especially when dealing with raw video frames. +If an EOS event was received before any buffers, this function returns +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. + + a #GstBuffer or NULL when the appsink is stopped or EOS. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + This function blocks until a buffer list or EOS becomes available or the +appsink element is set to the READY/NULL state. +This function will only return buffer lists when the appsink is in the +PLAYING state. All rendered buffer lists will be put in a queue so that +the application can pull buffer lists at its own rate. Note that when +the application does not pull buffer lists fast enough, the queued buffer +lists could consume a lot of memory, especially when dealing with raw +video frames. +If an EOS event was received before any buffer lists, this function returns +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. + + a #GstBufferList or NULL when the appsink is stopped or EOS. + + Get the last preroll buffer in @appsink. This was the buffer that caused the appsink to preroll in the PAUSED state. This buffer can be pulled many times and remains available to the application even after EOS. This function is typically used when dealing with a pipeline in the PAUSED @@ -191,83 +186,118 @@ after the seek position. Note that the preroll buffer will also be returned as the first buffer when calling gst_app_sink_pull_buffer(). If an EOS event was received before any buffers, this function returns -%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. This function blocks until a preroll buffer or EOS is received or the appsink -element is set to the READY/NULL state." - version="0.10.22"> - +element is set to the READY/NULL state. + + a #GstBuffer or NULL when the appsink is stopped or EOS. - - - - - - - - - - + Set callbacks which will be executed for each new preroll, new buffer and eos. This is an alternative to using the signals, it has lower overhead and is thus less expensive, but also less flexible. If callbacks are installed, no signals will be emited for performance -reasons." - version="0.10.23"> +reasons. + the callbacks - + a user_data argument for the callbacks + - + + a destroy notify function - - + + Set the capabilities on the appsink element. This function takes +a copy of the caps structure. After calling this method, the sink will only +accept caps that match @caps. If @caps is non-fixed, you must check the caps +on the buffers to get the actual used caps. + + + + + + caps to set + + + + + + Instruct @appsink to drop old buffers when the maximum amount of queued +buffers is reached. + + + + + + the new state + + + + + + Make appsink emit the "new-preroll" and "new-buffer" signals. This option is +by default disabled because signal emission is expensive and unneeded when +the application prefers to operate in pull mode. + + + + + + the new state + + + + + + Set the maximum amount of buffers that can be queued in @appsink. After this +amount of buffers are queued in appsink, any more buffers will block upstream +elements until a buffer is pulled from @appsink. + + + + + + the maximum number of buffers to queue + + + + + + - - + + - - + + - - + + - - + + @@ -277,138 +307,176 @@ reasons." - + - - - + + Signal that the end-of-stream has been reached. This signal is emited from +the steaming thread. + + - + Signal that a new buffer is available. This signal is emited from the steaming thread and only when the -"emit-signals" property is %TRUE. -The new buffer can be retrieved with the "pull-buffer" action +"emit-signals" property is %TRUE. +The new buffer can be retrieved with the "pull-buffer" action signal or gst_app_sink_pull_buffer() either from this signal callback or from any other thread. -Note that this signal is only emited when the "emit-signals" property is -set to %TRUE, which it is not by default for performance reasons."> - - +Note that this signal is only emited when the "emit-signals" property is +set to %TRUE, which it is not by default for performance reasons. + + - + Signal that a new bufferlist is available. This signal is emited from the steaming thread and only when the -"emit-signals" property is %TRUE. -The new buffer can be retrieved with the "pull-buffer-list" action -signal or gst_app_sink_pull_buffe_listr() either from this signal callback +"emit-signals" property is %TRUE. +The new buffer can be retrieved with the "pull-buffer-list" action +signal or gst_app_sink_pull_buffer_list() either from this signal callback or from any other thread. -Note that this signal is only emited when the "emit-signals" property is -set to %TRUE, which it is not by default for performance reasons."> - - +Note that this signal is only emited when the "emit-signals" property is +set to %TRUE, which it is not by default for performance reasons. + + - + Signal that a new preroll buffer is available. This signal is emited from the steaming thread and only when the -"emit-signals" property is %TRUE. -The new preroll buffer can be retrieved with the "pull-preroll" action +"emit-signals" property is %TRUE. +The new preroll buffer can be retrieved with the "pull-preroll" action signal or gst_app_sink_pull_preroll() either from this signal callback or from any other thread. -Note that this signal is only emited when the "emit-signals" property is -set to %TRUE, which it is not by default for performance reasons."> - - +Note that this signal is only emited when the "emit-signals" property is +set to %TRUE, which it is not by default for performance reasons. + + - + This function blocks until a buffer or EOS becomes available or the appsink +element is set to the READY/NULL state. This function will only return buffers when the appsink is in the PLAYING state. All rendered buffers will be put in a queue so that the application -can pull buffers at its own rate. +can pull buffers at its own rate. Note that when the application does not pull buffers fast enough, the queued buffers could consume a lot of memory, especially when dealing with -raw video frames. It's possible to control the behaviour of the queue with -the "drop" and "max-buffers" properties. +raw video frames. It's possible to control the behaviour of the queue with +the "drop" and "max-buffers" properties. If an EOS event was received before any buffers, this function returns -%NULL. Use gst_app_sink_is_eos () to check for the EOS condition."> - - +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. + + a #GstBuffer or NULL when the appsink is stopped or EOS. + - + This function blocks until a buffer list or EOS becomes available or the appsink +element is set to the READY/NULL state. This function will only return bufferlists when the appsink is in the PLAYING state. All rendered bufferlists will be put in a queue so that the application -can pull bufferlists at its own rate. +can pull bufferlists at its own rate. Note that when the application does not pull bufferlists fast enough, the queued bufferlists could consume a lot of memory, especially when dealing with -raw video frames. It's possible to control the behaviour of the queue with -the "drop" and "max-buffers" properties. +raw video frames. It's possible to control the behaviour of the queue with +the "drop" and "max-buffers" properties. If an EOS event was received before any buffers, this function returns -%NULL. Use gst_app_sink_is_eos () to check for the EOS condition."> - - +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. + + a #GstBufferList or NULL when the appsink is stopped or EOS. + - + Get the last preroll buffer in @appsink. This was the buffer that caused the appsink to preroll in the PAUSED state. This buffer can be pulled many times and remains available to the application even after EOS. This function is typically used when dealing with a pipeline in the PAUSED state. Calling this function after doing a seek will give the buffer right after the seek position. Note that the preroll buffer will also be returned as the first buffer -when calling gst_app_sink_pull_buffer() or the "pull-buffer" action signal. +when calling gst_app_sink_pull_buffer() or the "pull-buffer" action signal. If an EOS event was received before any buffers, this function returns -%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. +%NULL. Use gst_app_sink_is_eos () to check for the EOS condition. This function blocks until a preroll buffer or EOS is received or the appsink -element is set to the READY/NULL state."> - - +element is set to the READY/NULL state. + + a #GstBuffer or NULL when the appsink is stopped or EOS. + + A set of callbacks that can be installed on the appsink with +gst_app_sink_set_callbacks(). - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + @@ -419,7 +487,7 @@ gst_app_sink_set_callbacks()." - + @@ -431,7 +499,7 @@ gst_app_sink_set_callbacks()." - + @@ -443,7 +511,7 @@ gst_app_sink_set_callbacks()." - + @@ -454,9 +522,9 @@ gst_app_sink_set_callbacks()." - - - + + + @@ -466,9 +534,9 @@ gst_app_sink_set_callbacks()." - - - + + + @@ -478,9 +546,9 @@ gst_app_sink_set_callbacks()." - - - + + + @@ -490,9 +558,9 @@ gst_app_sink_set_callbacks()." - - - + + + @@ -504,254 +572,278 @@ gst_app_sink_set_callbacks()." - + - + - + Indicates to the appsrc element that the last buffer queued in the +element is the last buffer of the stream. +#GST_FLOW_WRONG_STATE when @appsrc is not PAUSED or PLAYING. - + #GST_FLOW_OK when the EOS was successfuly queued. + - - - - - - + Get the configured caps on @appsrc. + + the #GstCaps produced by the source. gst_caps_unref() after usage. - + + Check if appsrc will emit the "new-preroll" and "new-buffer" signals. +signals. - - - - - - - - - - - + %TRUE if @appsrc is emiting the "new-preroll" and "new-buffer" + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Retrieve the min and max latencies in @min and @max respectively. - + the min latency + - + the min latency + - + Get the maximum amount of bytes that can be queued in @appsrc. - + The maximum amount of bytes that can be queued. + - - - - - - - - - + + Get the size of the stream in bytes. A value of -1 means that the size is +not known. - + the size of the stream previously set with gst_app_src_set_size(); + - - - - - - + + Get the stream type. Control the stream type of @appsrc +with gst_app_src_set_stream_type(). - + the stream type. + + Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function takes ownership of the buffer. When the block property is TRUE, this function can block until free space becomes available in the queue. #GST_FLOW_WRONG_STATE when @appsrc is not PAUSED or PLAYING. -#GST_FLOW_UNEXPECTED when EOS occured." - version="0.10.22"> - +#GST_FLOW_UNEXPECTED when EOS occured. + + #GST_FLOW_OK when the buffer was successfuly queued. + a #GstBuffer to push - - - - - + Set callbacks which will be executed when data is needed, enough data has been collected or when a seek should be performed. This is an alternative to using the signals, it has lower overhead and is thus less expensive, but also less flexible. If callbacks are installed, no signals will be emited for performance -reasons." - version="0.10.23"> +reasons. + the callbacks - + a user_data argument for the callbacks + - + + a destroy notify function - - + + Set the capabilities on the appsrc element. This function takes +a copy of the caps structure. After calling this method, the source will +only produce caps that match @caps. @caps must be fixed and the caps on the +buffers must match the caps or left NULL. + + + + + + caps to set + + + + + + Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is +by default disabled because signal emission is expensive and unneeded when +the application prefers to operate in pull mode. + + + + + + the new state + + + + + + Configure the @min and @max latency in @src. If @min is set to -1, the +default latency calculations for pseudo-live sources will be used. + + + + + + the min latency + + + + the min latency + + + + + + Set the maximum amount of bytes that can be queued in @appsrc. +After the maximum amount of bytes are queued, @appsrc will emit the +"enough-data" signal. + + + + + + the maximum number of bytes to queue + + + + + + Set the size of the stream in bytes. A value of -1 means that the size is +not known. + + + + + + the size to set + + + + + + Set the stream type on @appsrc. For seekable streams, the "seek" signal must +be connected to. +A stream_type stream + + + + + + the new state + + + + + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -761,90 +853,130 @@ reasons." - + - - - + + Notify @appsrc that no more buffer are available. + + - + Signal that the source has enough data. It is recommended that the application stops calling push-buffer until the need-data signal is -emited again to avoid excessive buffer queueing."> - - +emited again to avoid excessive buffer queueing. + + - + Signal that the source needs more data. In the callback or from another thread you should call push-buffer or end-of-stream. pushed into @appsrc. You can call push-buffer multiple times until the enough-data signal is -fired."> - - +fired. + + - - + + the amount of bytes needed. + - + Adds a buffer to the queue of buffers that the appsrc element will push to its source pad. This function does not take ownership of the buffer so the buffer needs to be unreffed after calling this function. When the block property is TRUE, this function can block until free space -becomes available in the queue."> - - +becomes available in the queue. + + - - + + a buffer to push + - + Seek to the given offset. The next push-buffer should produce buffers from the new @offset. -This callback is only called for seekable stream types."> - - +This callback is only called for seekable stream types. + + %TRUE if the seek succeeded. + - - + + the offset to seek to + + A set of callbacks that can be installed on the appsrc with +gst_app_src_set_callbacks(). - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + @@ -855,7 +987,7 @@ gst_app_src_set_callbacks()." - + @@ -864,13 +996,13 @@ gst_app_src_set_callbacks()." - + - + @@ -882,23 +1014,23 @@ gst_app_src_set_callbacks()." - + - + - + - - + + @@ -912,8 +1044,8 @@ gst_app_src_set_callbacks()." - - + + @@ -925,27 +1057,29 @@ gst_app_src_set_callbacks()." - + - + + The stream type. + c:identifier="GST_APP_STREAM_TYPE_STREAM" + glib:nick="stream"/> + c:identifier="GST_APP_STREAM_TYPE_SEEKABLE" + glib:nick="seekable"/> + c:identifier="GST_APP_STREAM_TYPE_RANDOM_ACCESS" + glib:nick="random-access"/> diff --git a/unmaintained/gstreamer/app/app.factor b/unmaintained/gstreamer/plugins/app/app.factor similarity index 100% rename from unmaintained/gstreamer/app/app.factor rename to unmaintained/gstreamer/plugins/app/app.factor diff --git a/unmaintained/gstreamer/app/ffi/ffi.factor b/unmaintained/gstreamer/plugins/app/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/app/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/app/ffi/ffi.factor diff --git a/unmaintained/gstreamer/audio/GstAudio-0.10.gir b/unmaintained/gstreamer/plugins/audio/GstAudio-0.10.gir similarity index 59% rename from unmaintained/gstreamer/audio/GstAudio-0.10.gir rename to unmaintained/gstreamer/plugins/audio/GstAudio-0.10.gir index 73d9983fe0..17f9ff34bc 100644 --- a/unmaintained/gstreamer/audio/GstAudio-0.10.gir +++ b/unmaintained/gstreamer/plugins/audio/GstAudio-0.10.gir @@ -2,7 +2,7 @@ - @@ -13,9 +13,7 @@ and/or use gtk-doc annotations. --> - - - + @@ -30,10 +28,28 @@ and/or use gtk-doc annotations. --> + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> + + + + + + + + + + + + + + + @@ -99,69 +115,139 @@ any other channel position" glib:nick="num"/> + Opaque #GstAudioClock. + Create a new #GstAudioClock instance. Whenever the clock time should be calculated it will call @func with @user_data. When @func returns -#GST_CLOCK_TIME_NONE, the clock will return the last reported time."> +#GST_CLOCK_TIME_NONE, the clock will return the last reported time. - + a new #GstAudioClock casted to a #GstClock. + + the name of the clock - + + a function - + user data + - + Create a new #GstAudioClock instance. Whenever the clock time should be +calculated it will call @func with @user_data. When @func returns +#GST_CLOCK_TIME_NONE, the clock will return the last reported time. + + a new #GstAudioClock casted to a #GstClock. + + + + + the name of the clock + + + + a function + + + + user data + + + + #GDestroyNotify for @user_data + + + + + + Adjust @time with the internal offset of the audio clock. + + @time adjusted with the internal offset. + + + + + a #GstAudioClock + + + + a #GstClockTime + + + + + + Report the time as returned by the #GstAudioClockGetTimeFunc without applying +any offsets. + + the time as reported by the time function of the audio clock + + + + + a #GstAudioClock + + + + + + Invalidate the clock function. Call this function when the provided +#GstAudioClockGetTimeFunc cannot be called anymore, for example, when the +user_data becomes invalid. +After calling this function, @clock will return the last returned time for +the rest of its lifetime. + + + + + + a #GstAudioClock + + + + + + Inform @clock that future calls to #GstAudioClockGetTimeFunc will return values starting from @time. The clock will update an internal offset to make sure that future calls to internal_time will return an increasing result as required by -the #GstClock object."> +the #GstClock object. - - - - - - - - - - - - - - - + a #GstClockTime @@ -173,7 +259,7 @@ any offsets." - + @@ -183,10 +269,13 @@ any offsets." + + + - + @@ -199,32 +288,34 @@ any offsets." - + - + This function will be called whenever the current clock time needs to be calculated. If this function returns #GST_CLOCK_TIME_NONE, the last reported time will be returned by the clock. -be used."> - +be used. + + the current time or #GST_CLOCK_TIME_NONE if the previous time should + the #GstAudioClock - + user data + + Do not use anymore. + Base class for audio filters with the same format for input and output. - + @@ -263,25 +355,25 @@ be used."> - + + In addition to the @setup virtual function, you should also override the +GstBaseTransform::transform and/or GstBaseTransform::transform_ip virtual +function. - + - + @@ -295,58 +387,72 @@ function." - + + Convenience function to add pad templates to this element class, with +This function is usually used from within a GObject base_init function. + what formats the filter can handle, as #GstCaps - + Function that will be called by gst_audio_default_registry_mixer_filter() so the caller can decide which mixer elements should be kept and returned. When the mixer element is passed to the callback function, it is opened and in READY state. If you decide to keep the element, you need to set it -back to NULL state yourself (unless you want to keep it opened of course)."> +back to NULL state yourself (unless you want to keep it opened of course). - + TRUE if the element should be kept, FALSE otherwise. + + a #GstElement implementing the #GstMixer interface - + user data + + Opaque #GstAudioSink. + + + + + + + + + + - + - + @@ -354,39 +460,29 @@ back to NULL state yourself (unless you want to keep it opened of course)."> - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + @@ -395,24 +491,21 @@ back to NULL state yourself (unless you want to keep it opened of course)."> - + + glib:is-gtype-struct-for="AudioSink"> + #GstAudioSink class. Override the vmethods to implement functionality. - + - + @@ -422,9 +515,9 @@ samples from the device. - + - + @@ -437,9 +530,9 @@ samples from the device. - + - + @@ -449,9 +542,9 @@ samples from the device. - + - + @@ -461,27 +554,27 @@ samples from the device. - + - + - + - + - + - + @@ -491,7 +584,7 @@ samples from the device. - + @@ -504,25 +597,36 @@ samples from the device. - + + Base class for simple audio sources. + + + + + + + + + + - + - + @@ -530,39 +634,29 @@ samples from the device. - - - - - - - - - - - + - + - + - - - - - + + + + + @@ -571,22 +665,22 @@ samples from the device. - + + glib:is-gtype-struct-for="AudioSrc"> + #GstAudioSrc class. Override the vmethod to implement +functionality. - + - + @@ -596,9 +690,9 @@ functionality."> - + - + @@ -611,9 +705,9 @@ functionality."> - + - + @@ -623,9 +717,9 @@ functionality."> - + - + @@ -635,27 +729,27 @@ functionality."> - + - + - + - + - + - + @@ -665,7 +759,7 @@ functionality."> - + @@ -678,96 +772,130 @@ functionality."> - + - - + Opaque #GstBaseAudioSink. + + Create and return the #GstRingBuffer for @sink. This function will call the +::create_ringbuffer vmethod and will set @sink as the parent of the returned +buffer (see gst_object_set_parent()). + + The new ringbuffer of @sink. + Create and return the #GstRingBuffer for @sink. This function will call the ::create_ringbuffer vmethod and will set @sink as the parent of the returned -buffer (see gst_object_set_parent())."> - +buffer (see gst_object_set_parent()). + + The new ringbuffer of @sink. + + + + + + + Queries whether @sink will provide a clock or not. See also +gst_base_audio_sink_set_provide_clock. + + %TRUE if @sink will provide a clock. + + + + + Get the current slave method used by @sink. + + The current slave method used by @sink. + + + + + Controls the sink's drift tolerance. + + + + + + the new drift tolerance in microseconds + + + + + Controls whether @sink will provide a clock or not. If @provide is %TRUE, +gst_element_provide_clock() will return a clock that reflects the datarate +of @sink. If @provide is %FALSE, gst_element_provide_clock() will return NULL. - + new state + - - - - - + Controls how clock slaving will be performed in @sink. + the new slave method - - - - - - - + + - - + + - - + + - - + + - - + + - - + + @@ -776,16 +904,16 @@ gst_base_audio_sink_set_provide_clock." - + - + - + - + @@ -795,21 +923,22 @@ gst_base_audio_sink_set_provide_clock." - + + glib:is-gtype-struct-for="BaseAudioSink"> + #GstBaseAudioSink class. Override the vmethod to implement +functionality. - - - + + + + The new ringbuffer of @sink. @@ -821,19 +950,20 @@ functionality."> - + - + + Different possible clock slaving algorithms used when the internal audio +clock is not selected as the pipeline master clock. - - + Opaque #GstBaseAudioSrc. + + Create and return the #GstRingBuffer for @src. This function will call the +::create_ringbuffer vmethod and will set @src as the parent of the returned +buffer (see gst_object_set_parent()). + + The new ringbuffer of @src. + Create and return the #GstRingBuffer for @src. This function will call the ::create_ringbuffer vmethod and will set @src as the parent of the returned -buffer (see gst_object_set_parent())."> - +buffer (see gst_object_set_parent()). + + The new ringbuffer of @src. + + Queries whether @src will provide a clock or not. See also +gst_base_audio_src_set_provide_clock. + + %TRUE if @src will provide a clock. + + + + + Get the current slave method used by @src. + + The current slave method used by @src. + + + + Controls whether @src will provide a clock or not. If @provide is %TRUE, +gst_element_provide_clock() will return a clock that reflects the datarate +of @src. If @provide is %FALSE, gst_element_provide_clock() will return NULL. - + new state + - - - - - + Controls how clock slaving will be performed in @src. + the new slave method - - - - - - + transfer-ownership="none"> + Actual configured size of audio buffer in microseconds. + - + transfer-ownership="none"> + Actual configured audio latency in microseconds. + - - + + - - + + - - + + - - + + @@ -951,7 +1095,7 @@ gst_base_audio_src_set_provide_clock." - + @@ -961,21 +1105,22 @@ gst_base_audio_src_set_provide_clock." - + + glib:is-gtype-struct-for="BaseAudioSrc"> + #GstBaseAudioSrc class. Override the vmethod to implement +functionality. - - - + + + + The new ringbuffer of @src. @@ -987,20 +1132,20 @@ functionality."> - + - + + Different possible clock slaving algorithms when the internal audio clock was +not selected as the pipeline clock. - + + The format of the samples in the ringbuffer. - - - - - - - - - - - - - - - - + The ringbuffer base class structure. + + Print debug info about the buffer sized in @spec to the debug log. - + + the spec to debug - - - + c:identifier="gst_ring_buffer_debug_spec_caps"> + Print debug info about the parsed caps in @spec to the debug log. + the spec to debug - + + Parse @caps into @spec. - + TRUE if the caps could be parsed. + + a spec + + a #GstCaps + + - - - - - + Allocate the resources for the ringbuffer. This function fills +in the data pointer of the ring buffer with a valid #GstBuffer +to which samples can be written. +MT safe. - + TRUE if the device could be acquired, FALSE on error. + + the specs of the buffer - + + Activate @buf to start or stop pulling data. +MT safe. +FALSE on error. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + TRUE if the device could be activated in the requested mode, + - - - - - - - - - - - - - - - - - - - - - - - - - + the new mode + + Fill the ringbuffer with silence. +MT safe. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Close the audio device associated with the ring buffer. The ring buffer should already have been released via gst_ring_buffer_release(). -MT safe."> +MT safe. - + TRUE if the device could be closed, FALSE on error. + - - + + - - - - - - + - - + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Get the number of samples queued in the audio device. This is usually less than the segment size but can be bigger when the implementation uses another internal buffer between the audio device. @@ -1536,193 +1487,437 @@ For playback ringbuffers this is the amount of samples transfered from the ringbuffer to the device but still not played. For capture ringbuffers this is the amount of samples in the device that are not yet transfered to the ringbuffer. -MT safe."> +MT safe. - + The number of samples queued in the audio device. + - - + + + Open the audio device associated with the ring buffer. Does not perform any +setup on the device. You must open the device before acquiring the ring +buffer. +MT safe. - + TRUE if the device could be opened, FALSE on error. + - - + + + Pause processing samples from the ringbuffer. +MT safe. - + TRUE if the device could be paused, FALSE on error. + + + + + Free the resources of the ringbuffer. +MT safe. + + TRUE if the device could be released, FALSE on error. + + + + + + + + + + Start processing samples from the ringbuffer. +MT safe. + + TRUE if the device could be started, FALSE on error. + + + + + Stop processing samples from the ringbuffer. +MT safe. + + TRUE if the device could be stopped, FALSE on error. + + + + + Allocate the resources for the ringbuffer. This function fills +in the data pointer of the ring buffer with a valid #GstBuffer +to which samples can be written. +MT safe. + + TRUE if the device could be acquired, FALSE on error. + - - + + the specs of the buffer + - - - - - - - - - - - - - - - - - - - - - - - - + Activate @buf to start or stop pulling data. MT safe. -number of samples written can be less than @out_samples when @buf was interrupted -with a flush or stop." - version="0.10.11."> +FALSE on error. - + TRUE if the device could be activated in the requested mode, + - - - - - - - - - - - - - - - - + + the new mode + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Subclasses should call this function to notify the fact that +MT safe. - + the number of segments written + + + Clear the given segment of the buffer with silence samples. +This function is used by subclasses. +MT safe. + + + + + + the segment to clear + + + + + + Fill the ringbuffer with silence. +MT safe. + + + + + + Close the audio device associated with the ring buffer. The ring buffer +should already have been released via gst_ring_buffer_release(). +MT safe. + + TRUE if the device could be closed, FALSE on error. + + + + + Same as gst_ring_buffer_commit_full() but with a in_samples and out_samples +equal to @len, ignoring accum. +error. +MT safe. + + The number of samples written to the ringbuffer or -1 on + + + + + the sample position of the data + + + + the data to commit + + + + the number of samples in the data to commit + + + + + + Commit @in_samples samples pointed to by @data to the ringbuffer @buf. +samples in @data. For negative rates, @out_samples must be negative and +When @out_samples is positive, the first sample will be written at position @sample +in the ringbuffer. When @out_samples is negative, the last sample will be written to +although it is recommended for optimal performance. +set to 0 when this function is first called. In case the commit operation is +interrupted, one can resume the processing by passing the previously returned +MT safe. +number of samples written can be less than @out_samples when @buf was interrupted +with a flush or stop. + + The number of samples written to the ringbuffer or -1 on error. The + + + + + the sample position of the data + + + + the data to commit + + + + the number of samples in the data to commit + + + + the number of samples to write to the ringbuffer + + + + accumulator for rate conversion. + + + + + + Convert @src_val in @src_fmt to the equivalent value in @dest_fmt. The result +will be put in @dest_val. + + TRUE if the conversion succeeded. + + + + + the source format + + + + the source value + + + + the destination format + + + + a location to store the converted value + + + + + + Get the number of samples queued in the audio device. This is +usually less than the segment size but can be bigger when the +implementation uses another internal buffer between the audio +device. +For playback ringbuffers this is the amount of samples transfered from the +ringbuffer to the device but still not played. +For capture ringbuffers this is the amount of samples in the device that are +not yet transfered to the ringbuffer. +MT safe. + + The number of samples queued in the audio device. + + + + + Checks the status of the device associated with the ring buffer. +MT safe. + + TRUE if the device was open, FALSE if it was closed. + + + + + Check if the ringbuffer is acquired and ready to use. +MT safe. + + TRUE if the ringbuffer is acquired, FALSE on error. + + + + + Check if @buf is activated. +MT safe. + + TRUE if the device is active. + + + + Tell the ringbuffer that it is allowed to start playback when +the ringbuffer is filled with samples. +MT safe. - + the new value + + + Open the audio device associated with the ring buffer. Does not perform any +setup on the device. You must open the device before acquiring the ring +buffer. +MT safe. + + TRUE if the device could be opened, FALSE on error. + + + + + Pause processing samples from the ringbuffer. +MT safe. + + TRUE if the device could be paused, FALSE on error. + + + + + Returns a pointer to memory where the data from segment @segment +can be found. This function is mostly used by subclasses. +MT safe. + + FALSE if the buffer is not started. + + + + + the segment to read + + + + the pointer to the memory where samples can be read + + + + the number of bytes to read + + + + + + Read @len samples from the ringbuffer into the memory pointed +to by @data. +The first sample should be read from position @sample in +the ringbuffer. +although it is recommended. +error. +MT safe. + + The number of samples read from the ringbuffer or -1 on + + + + + the sample position of the data + + + + where the data should be read + + + + the number of samples in data to read + + + + + + Free the resources of the ringbuffer. +MT safe. + + TRUE if the device could be released, FALSE on error. + + + + + Get the number of samples that were processed by the ringbuffer +since it was last started. This does not include the number of samples not +yet processed (see gst_ring_buffer_delay()). +MT safe. + + The number of samples processed by the ringbuffer. + + + + + Sets the given callback function on the buffer. This function +will be called every time a segment has been written to a device. +MT safe. + + + + + + the callback to set + + + + user data passed to the callback + + + + + + Set the ringbuffer to flushing mode or normal mode. +MT safe. + + + + + + the new mode + + + + + + Make sure that the next sample written to the device is +accounted for as being the @sample sample written to the +device. This value will be used in reporting the current +sample position of the ringbuffer. +This function will also clear the buffer with silence. +MT safe. + + + + + + the sample number to set + + + + + + Start processing samples from the ringbuffer. +MT safe. + + TRUE if the device could be started, FALSE on error. + + + + + Stop processing samples from the ringbuffer. +MT safe. + + TRUE if the device could be stopped, FALSE on error. + + + @@ -1730,10 +1925,10 @@ MT safe." - + - + @@ -1745,84 +1940,85 @@ MT safe." - + - + - + - + - + - + - + - + - + - + - + - + + This function is set with gst_ring_buffer_set_callback() and is +called to fill the memory at @data with @len bytes of samples. + a #GstRingBuffer - - - + target to fill + - + amount to fill + - + user data + + glib:is-gtype-struct-for="RingBuffer"> + The vmethods that subclasses can override to implement the ringbuffer. - + - + TRUE if the device could be opened, FALSE on error. + @@ -1832,24 +2028,27 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be acquired, FALSE on error. + + the specs of the buffer - + - + TRUE if the device could be released, FALSE on error. + @@ -1859,9 +2058,10 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be closed, FALSE on error. + @@ -1871,9 +2071,10 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be started, FALSE on error. + @@ -1883,9 +2084,10 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be paused, FALSE on error. + @@ -1895,9 +2097,9 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + @@ -1907,9 +2109,10 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be stopped, FALSE on error. + @@ -1919,9 +2122,10 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + The number of samples queued in the audio device. + @@ -1931,51 +2135,51 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + - + TRUE if the device could be activated in the requested mode, + - + the new mode + - + - + - - + + - - - + - + - + - - + + - + @@ -1988,15 +2192,15 @@ The vmethods that subclasses can override to implement the ringbuffer."> - + + The state of a segment in the ringbuffer. c:identifier="GST_SEGSTATE_PARTIAL" glib:nick="partial"/> - + + The structure containing the format specification of the ringbuffer. @@ -2028,57 +2230,57 @@ The structure containing the format specification of the ringbuffer."> - + - + - + - + - + - + - + - + - + - + - + - + - + - + + The state of the ringbuffer. c:identifier="GST_RING_BUFFER_STATE_STARTED" glib:nick="started"/> - + Clip the the buffer to the given %GstSegment. +After calling this function the caller does not own a reference to otherwise the clipped buffer is returned. If the buffer has no timestamp, it is assumed to be inside the segment and -is not clipped" - version="0.10.14"> - +is not clipped + + %NULL if the buffer is completely outside the configured segment, + The buffer to clip. + Segment in %GST_FORMAT_TIME or %GST_FORMAT_DEFAULT to which the buffer should be clipped. - + sample rate. + - + size of one audio frame in bytes. + - + This functions checks if the given channel positions are valid. Channel positions are valid if: <itemizedlist> <listitem><para>No channel positions appears twice or all positions are %GST_AUDIO_CHANNEL_POSITION_NONE. </para></listitem> <listitem><para>Either all or none of the channel positions are %GST_AUDIO_CHANNEL_POSITION_NONE. </para></listitem> -<listitem><para>%GST_AUDIO_CHANNEL_POSITION_FRONT_MONO and %GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT or %GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT don't appear together in the given positions. +<listitem><para>%GST_AUDIO_CHANNEL_POSITION_FRONT_MONO and %GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT or %GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT don't appear together in the given positions. </para></listitem> </itemizedlist> -and %FALSE otherwise." - version="0.10.20"> +and %FALSE otherwise. - + %TRUE if the given channel positions are valid + + An array of #GstAudioChannelPosition. - + The number of elements in @pos. + - + Utility function to find audio mixer elements. Will traverse the default plugin registry in order of plugin rank and find usable audio mixer elements. The caller may optionally fine-tune the selection by specifying a filter function. element in the list by setting it to NULL state and calling gst_object_unref(). After that the list itself should be freed -using g_list_free()." - version="0.10.2"> - - +using g_list_free(). + + a #GList of audio mixer #GstElement<!-- -->s. You must free each + + + - + + filter function, or #NULL - + set to #TRUE if you only want the first suitable mixer element + - + user data to pass to the filter function + - - + + Calculate length in nanoseconds of audio buffer @buf based on capabilities of + + the length. + the #GstPad to get the caps from + the #GstBuffer - + Custom fixate function. Elements that implement some sort of channel conversion algorithm should use this function for fixating on GstAudioChannelPosition properties. It will take care of equal channel positioning (left/right). Caller g_free()s @@ -2195,163 +2415,177 @@ the return value. The input properties may be (and are supposed to be) unfixed. Note that this function is mostly a hack because we currently have no way to add default fixation functions for new GTypes. -set of #GstAudioChannelPosition values."> - +set of #GstAudioChannelPosition values. + + fixed values that the caller could use as a fixed + a #GstStructure containing a (possibly unfixed) "channel-positions" field. - + + Calculate byte size of an audio frame. - + the byte size, or 0 if there was an error + + the #GstPad to get the caps from - + + Calculate length of buffer in frames. - + 0 if there's an error, or the number of frames if everything's ok + + the #GstPad to get the caps from + the #GstBuffer - + Retrieves a number of (fixed!) audio channel positions from the provided #GstStructure and returns it as a newly allocated array. The caller should g_free () this array. The caller should also check that the members in this #GstStructure are -indeed "fixed" before calling this function. +indeed "fixed" before calling this function. positions as provided in the given #GstStructure. Returns -NULL on error."> - +NULL on error. + + a newly allocated array containing the channel + A #GstStructure to retrieve channel positions from. - + + Check if the buffer size is a whole multiple of the frame size. - + %TRUE if buffer size is multiple. + + the #GstPad to get the caps from + the #GstBuffer - + Sets a (possibly non-fixed) list of possible audio channel positions (given in pos) on the given caps. Each of the structures of the caps, after this function has been called, -will contain a "channel-positions" field with an array. +will contain a "channel-positions" field with an array. Each value in the array will contain each of the values given in the pos array. Note that the size of the caps might be -increased by this, since each structure with a "channel- -positions" field needs to have a fixed "channels" field. -The input caps is not required to have this."> +increased by this, since each structure with a "channel- +positions" field needs to have a fixed "channels" field. +The input caps is not required to have this. + #GstCaps to set the list of channel positions on. + the array containing one or more possible audio channel positions that we should add in each value of the array in the given structure. - + the number of values in pos. + - + Adds a "channel-positions" field to the given #GstStructure, which will represent the channel positions as given in the -provided #GstAudioChannelPosition array."> +provided #GstAudioChannelPosition array. + A #GstStructure to set channel positions on. + an array of channel positions. The number of members in this array should be equal to the (fixed!) number of the "channels" field in the given #GstStructure. - + Sets a (possibly non-fixed) list of possible audio channel positions (given in pos) on the given structure. The structure, after this function has been called, will contain -a "channel-positions" field with an array of the size of -the "channels" field value in the given structure (note +a "channel-positions" field with an array of the size of +the "channels" field value in the given structure (note that this means that the channels field in the provided structure should be fixed!). Each value in the array will -contain each of the values given in the pos array."> +contain each of the values given in the pos array. + #GstStructure to set the list of channel positions on. + the array containing one or more possible audio channel positions that we should add in each value of the array in the given structure. - + the number of values in pos. + - + Do not use anymore. + a #GstStructure + a set of #GstAudioFieldFlag diff --git a/unmaintained/gstreamer/audio/audio.factor b/unmaintained/gstreamer/plugins/audio/audio.factor similarity index 100% rename from unmaintained/gstreamer/audio/audio.factor rename to unmaintained/gstreamer/plugins/audio/audio.factor diff --git a/unmaintained/gstreamer/audio/ffi/ffi.factor b/unmaintained/gstreamer/plugins/audio/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/audio/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/audio/ffi/ffi.factor diff --git a/unmaintained/gstreamer/plugins/fft/GstFft-0.10.gir b/unmaintained/gstreamer/plugins/fft/GstFft-0.10.gir new file mode 100644 index 0000000000..8bb49f3c47 --- /dev/null +++ b/unmaintained/gstreamer/plugins/fft/GstFft-0.10.gir @@ -0,0 +1,480 @@ + + + + + + + + + + + + + + + + + Instance structure for #GstFFTF32. + + + + + + + + + + + + + + + + This performs the FFT on @timedata and puts the result in @freqdata. +allocating the #GstFFTF32 instance with gst_fft_f32_new(). +domain samples. + + + + + + Buffer of the samples in the time domain + + + + Target buffer for the samples in the frequency domain + + + + + + This frees the memory allocated for @self. + + + + + + This performs the inverse FFT on @freqdata and puts the result in @timedata. +while allocating the #GstFFTF32 instance with gst_fft_f32_new(). + + + + + + Buffer of the samples in the frequency domain + + + + Target buffer for the samples in the time domain + + + + + + This calls the window function @window on the @timedata sample buffer. + + + + + + Time domain samples + + + + Window function to apply + + + + + + + Data type for complex numbers composed of +32 bit float. + + + + + + + + + Instance structure for #GstFFTF64. + + + + + + + + + + + + + + + + This performs the FFT on @timedata and puts the result in @freqdata. +allocating the #GstFFTF64 instance with gst_fft_f64_new(). +domain samples. + + + + + + Buffer of the samples in the time domain + + + + Target buffer for the samples in the frequency domain + + + + + + This frees the memory allocated for @self. + + + + + + This performs the inverse FFT on @freqdata and puts the result in @timedata. +while allocating the #GstFFTF64 instance with gst_fft_f64_new(). + + + + + + Buffer of the samples in the frequency domain + + + + Target buffer for the samples in the time domain + + + + + + This calls the window function @window on the @timedata sample buffer. + + + + + + Time domain samples + + + + Window function to apply + + + + + + + Data type for complex numbers composed of +64 bit float. + + + + + + + + + Instance structure for #GstFFTS16. + + + + + + + + + + + + + + + + This performs the FFT on @timedata and puts the result in @freqdata. +allocating the #GstFFTS16 instance with gst_fft_s16_new(). +domain samples. + + + + + + Buffer of the samples in the time domain + + + + Target buffer for the samples in the frequency domain + + + + + + This frees the memory allocated for @self. + + + + + + This performs the inverse FFT on @freqdata and puts the result in @timedata. +while allocating the #GstFFTS16 instance with gst_fft_s16_new(). + + + + + + Buffer of the samples in the frequency domain + + + + Target buffer for the samples in the time domain + + + + + + This calls the window function @window on the @timedata sample buffer. + + + + + + Time domain samples + + + + Window function to apply + + + + + + + Data type for complex numbers composed of +signed 16 bit integers. + + + + + + + + + Instance structure for #GstFFTS32. + + + + + + + + + + + + + + + + This performs the FFT on @timedata and puts the result in @freqdata. +allocating the #GstFFTS32 instance with gst_fft_s32_new(). +domain samples. + + + + + + Buffer of the samples in the time domain + + + + Target buffer for the samples in the frequency domain + + + + + + This frees the memory allocated for @self. + + + + + + This performs the inverse FFT on @freqdata and puts the result in @timedata. +while allocating the #GstFFTS32 instance with gst_fft_s32_new(). + + + + + + Buffer of the samples in the frequency domain + + + + Target buffer for the samples in the time domain + + + + + + This calls the window function @window on the @timedata sample buffer. + + + + + + Time domain samples + + + + Window function to apply + + + + + + + Data type for complex numbers composed of +signed 32 bit integers. + + + + + + + + + The various window functions available. + + + + + + + + This returns a new #GstFFTF32 instance with the given parameters. It makes +sense to keep one instance for several calls for speed reasons. +2, 3 and 5. To get the next number with this characteristics use +gst_fft_next_fast_length(). + + a new #GstFFTF32 instance. + + + + + Length of the FFT in the time domain + + + + %TRUE if the #GstFFTF32 instance should be used for the inverse FFT + + + + + + This returns a new #GstFFTF64 instance with the given parameters. It makes +sense to keep one instance for several calls for speed reasons. +2, 3 and 5. To get the next number with this characteristics use +gst_fft_next_fast_length(). + + a new #GstFFTF64 instance. + + + + + Length of the FFT in the time domain + + + + %TRUE if the #GstFFTF64 instance should be used for the inverse FFT + + + + + + Returns the next number to @n that is entirely a product +of 2, 3 and 5. Using this as the @len parameter for +the different GstFFT types will provide the best performance. + + the next fast FFT length. + + + + + Number for which the next fast length should be returned + + + + + + This returns a new #GstFFTS16 instance with the given parameters. It makes +sense to keep one instance for several calls for speed reasons. +2, 3 and 5. To get the next number with this characteristics use +gst_fft_next_fast_length(). + + a new #GstFFTS16 instance. + + + + + Length of the FFT in the time domain + + + + %TRUE if the #GstFFTS16 instance should be used for the inverse FFT + + + + + + This returns a new #GstFFTS32 instance with the given parameters. It makes +sense to keep one instance for several calls for speed reasons. +2, 3 and 5. To get the next number with this characteristics use +gst_fft_next_fast_length(). + + a new #GstFFTS32 instance. + + + + + Length of the FFT in the time domain + + + + %TRUE if the #GstFFTS32 instance should be used for the inverse FFT + + + + + + diff --git a/unmaintained/gstreamer/fft/ffi/ffi.factor b/unmaintained/gstreamer/plugins/fft/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/fft/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/fft/ffi/ffi.factor diff --git a/unmaintained/gstreamer/fft/fft.factor b/unmaintained/gstreamer/plugins/fft/fft.factor similarity index 100% rename from unmaintained/gstreamer/fft/fft.factor rename to unmaintained/gstreamer/plugins/fft/fft.factor diff --git a/unmaintained/gstreamer/interfaces/GstInterfaces-0.10.gir b/unmaintained/gstreamer/plugins/interfaces/GstInterfaces-0.10.gir similarity index 57% rename from unmaintained/gstreamer/interfaces/GstInterfaces-0.10.gir rename to unmaintained/gstreamer/plugins/interfaces/GstInterfaces-0.10.gir index 06591faf88..7387a8153b 100644 --- a/unmaintained/gstreamer/interfaces/GstInterfaces-0.10.gir +++ b/unmaintained/gstreamer/plugins/interfaces/GstInterfaces-0.10.gir @@ -2,7 +2,7 @@ - @@ -11,7 +11,7 @@ and/or use gtk-doc annotations. --> - + @@ -29,126 +29,110 @@ and/or use gtk-doc annotations. --> + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> - + glib:get-type="gst_color_balance_get_type"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - + Get the #GstColorBalanceType of this implementation. + + A the #GstColorBalanceType. - + + Retrieve the current value of the indicated channel, between min_value +and max_value. +#GstColorBalanceChannel::max_value members of the +#GstColorBalanceChannel object. + + The current value of the channel. + + + + + A #GstColorBalanceChannel instance + + + + + + Retrieve a list of the available channels. +The list is owned by the #GstColorBalance instance and must not +be freed. + + A GList containing pointers to #GstColorBalanceChannel objects. + + + + + + + Sets the current value of the channel to the passed value, which must +be between min_value and max_value. +#GstColorBalanceChannel::max_value members of the +#GstColorBalanceChannel object. + A #GstColorBalanceChannel instance - + The new value for the channel. + - - + + A helper function called by implementations of the GstColorBalance +interface. It fires the #GstColorBalance::value-changed signal on the +instance, and the #GstColorBalanceChannel::value-changed signal on the +channel object. + - + A #GstColorBalanceChannel whose value has changed + - + The new value of the channel + + + + + + Fired when the value of the indicated channel has changed. + + + + + + The #GstColorBalanceChannel + + + + The new value + - + - + - - - + + Fired when the value of the indicated channel has changed. + + - - + + The new value + @@ -185,7 +170,7 @@ channel object."> - + @@ -195,30 +180,30 @@ channel object."> c:type="GstColorBalanceChannel*"/> - + - + - - + + - + - + - + + + @@ -228,7 +213,7 @@ channel object."> - + @@ -241,15 +226,15 @@ channel object."> c:type="GstColorBalanceChannel*"/> - + - + - + @@ -263,7 +248,7 @@ channel object."> - + @@ -276,27 +261,25 @@ channel object."> c:type="GstColorBalanceChannel*"/> - + - + - + + An enumeration indicating whether an element implements color balancing +operations in software or in dedicated hardware. In general, dedicated +hardware implementations (such as those provided by xvimagesink) are +preferred. - + glib:get-type="gst_mixer_get_type"> - + + + Get the set of supported flags for this mixer implementation. - + A set of or-ed GstMixerFlags for supported features. + - - + + + Get the #GstMixerType of this mixer implementation. - + A the #GstMixerType. + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + Get the current value of a name/value option in the mixer. + current value of the name/value option. + The #GstMixerOptions that we operate on. - - - - + + + Get the current volume(s) on the given track. + + - - + the GstMixerTrack to get the volume from. + + + + a pre-allocated array of integers (of size track->num_channels) to store the current volume of each channel in the given track in. + + + + + + Returns a list of available tracks for this mixer/element. Note that it is allowed for sink (output) elements to only provide the output tracks in this list. Likewise, for sources (inputs), it is allowed to only provide input elements in this list. The list is owned by the #GstMixer instance and must not be freed -or modified."> +or modified. - + A #GList consisting of zero or more #GstMixerTracks. + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + This function is called by the mixer implementation to produce a notification message on the bus indicating that the list of available mixer tracks for a given mixer object has changed. Applications should rebuild their interface when they receive this message. This function only works for GstElements that are implementing the -GstMixer interface, and the element needs to have been provided a bus." - version="0.10.18"> +GstMixer interface, and the element needs to have been provided a bus. + + This function is called by the mixer implementation to produce +a notification message on the bus indicating that the given track +has changed mute state. +This function only works for GstElements that are implementing the +GstMixer interface, and the element needs to have been provided a bus. + + + + + + the GstMixerTrack that has change mute state. + + + + the new state of the mute flag on the track + + + + + + This function is called by the mixer implementation to produce +a notification message on the bus indicating that the given options +object has changed state. +This function only works for GstElements that are implementing the +GstMixer interface, and the element needs to have been provided a bus. + + + + + + the GstMixerOptions that has changed value. + + + + the new value of the GstMixerOptions. + + + + + This function is called by the mixer implementation to produce a notification message on the bus indicating that the list of possible options of a given options object has changed. The new options are not contained in the message on purpose. Applications @@ -609,98 +419,194 @@ should call gst_mixer_option_get_values() on @opts to make @opts update its internal state and obtain the new list of values. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus -for this to work." - version="0.10.18"> +for this to work. + the GstMixerOptions whose list of values has changed - - - - - - - - - - - - + + This function is called by the mixer implementation to produce +a notification message on the bus indicating that the given track +has changed recording state. +This function only works for GstElements that are implementing the +GstMixer interface, and the element needs to have been provided a bus. + + + + the GstMixerTrack that has changed recording state. + + + + the new state of the record flag on the track + + + + + + Mutes or unmutes the given channel. To find out whether a +track is currently muted, use GST_MIXER_TRACK_HAS_FLAG (). + + + + + + the #GstMixerTrack to operate on. + + + + a boolean value indicating whether to turn on or off muting. + + + + + + Sets a name/value option in the mixer to the requested value. + + + + + + The #GstMixerOptions that we operate on. + + + + The requested new option value. + + + + + + Enables or disables recording on the given track. Note that +this is only possible on input tracks, not on output tracks +(see GST_MIXER_TRACK_HAS_FLAG () and the GST_MIXER_TRACK_INPUT +flag). + + + + + + the #GstMixerTrack to operate on. + + + + a boolean value that indicates whether to turn on or off recording. + + + + + + Sets the volume on each channel in a track. Short note about +the mixer/element, such as 'Line-in' or 'Microphone'. A +channel is said to be a mono-stream inside this track. A +stereo track thus contains two channels. + + + + + + The #GstMixerTrack to set the volume on. + + + + an array of integers (of size track->num_channels) that gives the wanted volume for each channel in this track. + + + + + + This function is called by the mixer implementation to produce +a notification message on the bus indicating that the volume(s) for the +given track have changed. +This function only works for GstElements that are implementing the +GstMixer interface, and the element needs to have been provided a bus. + + + + + + the GstMixerTrack that has changed. + + + + Array of volume values, one per channel on the mixer track. + + + + + + + + - + - + - - + + - + - + - - + + - + - + - - + + - + - + - - + + - + - + - + + + @@ -710,7 +616,7 @@ for this to work." - + @@ -721,16 +627,14 @@ for this to work." - - + + - + @@ -741,16 +645,14 @@ for this to work." - - + + - + @@ -762,13 +664,13 @@ for this to work." - + - + @@ -780,13 +682,13 @@ for this to work." - + - + @@ -798,13 +700,13 @@ for this to work." - + - + @@ -816,13 +718,13 @@ for this to work." - + - + @@ -833,16 +735,14 @@ for this to work." - - + + - + @@ -853,14 +753,14 @@ for this to work." - + - + @@ -875,7 +775,7 @@ for this to work." - + @@ -886,15 +786,15 @@ for this to work." - + - - + + @@ -904,22 +804,19 @@ for this to work." - + - + + Flags indicating which optional features are supported by a mixer +implementation. + An enumeration for the type of a GstMixer message received on the bus - - - + + Get the values for the mixer option. +option. You must not free or modify the list or its contents, it belongs +to the @mixer_options object. + + A list of strings with all the possible values for the mixer + + + + Get the values for the mixer option. option. You must not free or modify the list or its contents, it belongs -to the @mixer_options object."> - - +to the @mixer_options object. + + A list of strings with all the possible values for the mixer + + + - + + + - + @@ -1013,10 +922,13 @@ to the @mixer_options object."> - - - - + + + + A list of strings with all the possible values for the mixer + + + @@ -1027,36 +939,43 @@ to the @mixer_options object."> - + - - + + - - + + - - + + - - + + - - + + - - + + - - + + @@ -1068,13 +987,13 @@ to the @mixer_options object."> - + - + - + - + + Mixer track flags. + + Sends the indicated command to the navigation interface. + + + + + + The command to issue + + + + @@ -1181,77 +1112,56 @@ Mixer track flags." + c:identifier="gst_navigation_send_key_event"> + The type of the key event. Recognised values are "key-press" and "key-release" + Character representation of the key. This is typically as produced by XKeysymToString. + Sends a mouse event to the navigation interface. Mouse event coordinates are sent relative to the display space of the related output area. This is usually the size in pixels of the window associated with the element -implementing the #GstNavigation interface."> +implementing the #GstNavigation interface. + The type of mouse event, as a text string. Recognised values are "mouse-button-press", "mouse-button-release" and "mouse-move". - + The button number of the button being pressed or released. Pass 0 for mouse-move events. + - + The x coordinate of the mouse event. + - - - - - - - - - - - + The y coordinate of the mouse event. + + A set of commands that may be issued to an element providing the #GstNavigation interface. The available commands can be queried via the gst_navigation_query_new_commands() query. For convenience in handling DVD navigation, the MENU commands are aliased as: @@ -1261,11 +1171,7 @@ GST_NAVIGATION_COMMAND_DVD_ROOT_MENU = @GST_NAVIGATION_COMMAND_MENU3 GST_NAVIGATION_COMMAND_DVD_SUBPICTURE_MENU = @GST_NAVIGATION_COMMAND_MENU4 GST_NAVIGATION_COMMAND_DVD_AUDIO_MENU = @GST_NAVIGATION_COMMAND_MENU5 GST_NAVIGATION_COMMAND_DVD_ANGLE_MENU = @GST_NAVIGATION_COMMAND_MENU6 -GST_NAVIGATION_COMMAND_DVD_CHAPTER_MENU = @GST_NAVIGATION_COMMAND_MENU7" - version="0.10.23" - glib:type-name="GstNavigationCommand" - glib:get-type="gst_navigation_command_get_type" - c:type="GstNavigationCommand"> +GST_NAVIGATION_COMMAND_DVD_CHAPTER_MENU = @GST_NAVIGATION_COMMAND_MENU7 + Enum values for the various events that an element implementing the +GstNavigation interface might send up the pipeline. - + @@ -1396,23 +1292,17 @@ GstNavigation interface might send up the pipeline." - + + A set of notifications that may be received on the bus when navigation +related status changes. + Opaque #GstPropertyProbe data structure. + Get a list of properties for which probing is supported. +by this element. - + the list of properties for which probing is supported + + + - - - + + + - + + + + + + + + + + + + + + @@ -1477,20 +1386,7 @@ related status changes." - - - - - - - - - - - - - - + @@ -1498,148 +1394,165 @@ related status changes." + c:identifier="gst_property_probe_get_properties"> + Get a list of properties for which probing is supported. +by this element. - + the list of properties for which probing is supported + + + + c:identifier="gst_property_probe_get_property"> + Get #GParamSpec for a property for which probing is supported. + the #GParamSpec of %NULL. + name of the property. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Gets the possible (probed) values for the given property, +requires the property to have been probed before. + A list of valid values for the given property. + the #GParamSpec property identifier. + c:identifier="gst_property_probe_get_values_name"> + Same as gst_property_probe_get_values (). + A list of valid values for the given property. + the name of the property to get values for. + + + + + + Checks whether a property needs a probe. This might be because +the property wasn't initialized before, or because host setup +changed. This might be, for example, because a new device was +added, and thus device probing needs to be refreshed to display +the new device. + + TRUE if the property needs a new probe, FALSE if not. + + + + + a #GParamSpec that identifies the property to check. + + + + + + Same as gst_property_probe_needs_probe (). + + TRUE if the property needs a new probe, FALSE if not. + + + + + the name of the property to check. + Check whether the given property requires a new probe. If so, fo the probe. After that, retrieve a value list. Meant as a -utility function that wraps the above functions."> +utility function that wraps the above functions. + the list of valid values for this property. + The #GParamSpec property identifier. + c:identifier="gst_property_probe_probe_and_get_values_name"> + Same as gst_property_probe_probe_and_get_values (). + the list of valid values for this property. + the name of the property to get values for. + + + + + + Runs a probe on the property specified by @pspec + + + + + + #GParamSpec of the property. + + + + + + Runs a probe on the property specified by @name. + + + + + + name of the property. - - + + - + + glib:is-gtype-struct-for="PropertyProbe"> + #GstPropertyProbe interface. - + @@ -1654,9 +1567,12 @@ utility function that wraps the above functions."> - + - + the list of properties for which probing is supported + + + @@ -1666,16 +1582,16 @@ utility function that wraps the above functions."> - + - + - + @@ -1684,7 +1600,7 @@ utility function that wraps the above functions."> - + @@ -1693,7 +1609,7 @@ utility function that wraps the above functions."> - + @@ -1702,7 +1618,7 @@ utility function that wraps the above functions."> - + @@ -1711,7 +1627,7 @@ utility function that wraps the above functions."> - + @@ -1721,38 +1637,34 @@ utility function that wraps the above functions."> - + - - + Returns %TRUE if the stream is muted + - - - - - - - - - + The current stream volume as linear factor + + #GstStreamVolumeFormat which should be returned @@ -1765,33 +1677,44 @@ utility function that wraps the above functions."> - + Mute state that should be set + - - + + + + #GstStreamVolumeFormat of @val + + + + Linear volume factor that should be set + + + - - + + - - + + + Different representations of a stream volume. gst_stream_volume_convert() +allows to convert between the different representations. +Formulas to convert from a linear to a cubic or dB volume are +cbrt(val) and 20 * log10 (val). - + - + glib:get-type="gst_tuner_get_type"> - - - - - - + + + Called by elements implementing the #GstTuner interface when the +current channel changes. Fires the #GstTuner::channel-changed signal. + A #GstTunerChannel instance - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + introspectable="0"> + Look up a #GstTunerChannel by name. +is available. + + A #GstTunerChannel, or NULL if no channel with the provided name - + + A string containing the name of a #GstTunerChannel - - - - - - - - - - - - - + + Look up a #GstTunerNorm by name. +is available. + + A #GstTunerNorm, or NULL if no norm with the provided name + - + A string containing the name of a #GstTunerNorm + + Called by elements implementing the #GstTuner interface when the configured frequency changes. Fires the #GstTuner::frequency-changed signal on the tuner, and the #GstTunerChannel::frequency-changed signal -on the channel."> +on the channel. + The current #GstTunerChannel - + The new frequency setting + - + + Retrieve the current channel from the tuner. + + the current channel of the tuner object. + + + + + Retrieve the current frequency from the given channel. As for +gst_tuner_set_frequency(), the #GstTunerChannel must support frequency +operations, as indicated by the GST_TUNER_CHANNEL_FREQUENCY flag. - + The current frequency, or 0 on error. + + The #GstTunerChannel to retrieve the frequency from. - - - - - - + + Get the current video norm from the given tuner object for the +currently selected channel. + + the current norm. + - - - - - - - - - + + + Retrieve a #GList of #GstTunerChannels available +(e.g. 'composite', 's-video', ...) from the given tuner object. +owned by the GstTuner and must not be freed. + + A list of channels available on this tuner. The list is + + + - - - - - - - - - - - + + + Retrieve a GList of available #GstTunerNorm settings for the currently +tuned channel on the given tuner object. +tuner object. The list is owned by the GstTuner and must not +be freed. + + A list of norms available on the current channel for this + + + + + + + Called by elements implementing the #GstTuner interface when the +current norm changes. Fires the #GstTuner::norm-changed signal. + - + A #GstTunerNorm instance + - - - + + + Tunes the object to the given channel, which should be one of the +channels returned by gst_tuner_list_channels(). + - + the channel to tune to. + + + + + + Sets a tuning frequency on the given tuner/channel. Note that this +requires the given channel to be a "tuning" channel, which can be +checked using GST_TUNER_CHANNEL_HAS_FLAG (), with the proper flag +being GST_TUNER_CHANNEL_FREQUENCY. +The frequency is in Hz, with minimum steps indicated by the +frequency_multiplicator provided in the #GstTunerChannel. The +valid range is provided in the min_frequency and max_frequency properties +of the #GstTunerChannel. + + + + + + The #GstTunerChannel to set the frequency on. + + + + The frequency to tune in to. + + + + + + Changes the video norm on this tuner to the given norm, which should be +one of the norms returned by gst_tuner_list_norms(). + + + + + + the norm to use for the current channel. + + + + + + Called by elements implementing the #GstTuner interface when the +incoming signal strength changes. Fires the #GstTuner::signal-changed +signal on the tuner and the #GstTunerChannel::signal-changed signal on +the channel. + + + + + + The current #GstTunerChannel + - + The new signal strength + + + + + + Get the strength of the signal on this channel. Note that this +requires the current channel to be a "tuning" channel, i.e. a +channel on which frequency can be set. This can be checked using +GST_TUNER_CHANNEL_HAS_FLAG (), and the appropriate flag to check +for is GST_TUNER_CHANNEL_FREQUENCY. +The valid range of the signal strength is indicated in the +min_signal and max_signal properties of the #GstTunerChannel. + + Signal strength, or 0 on error. + + + + + the #GstTunerChannel to get the signal strength from. + + + + + + Reports that the current #GstTunerChannel has changed. + + + + + + The new configured channel. + + + + + + Reports that the current frequency has changed. + + + + + + + + + + + + + + Reports that the current #GstTunerNorm has changed. + + + + + + The new configured norm. + + + + + + Reports that the signal strength has changed. + + + + + + The current #GstTunerChannel + + + + The new signal strength (an integer) + - + - + - + - + - + - - - + + Reports that the current frequency has changed. + + - - + + The new frequency (an unsigned long) + - - - + + Reports that the signal strength has changed. + + - - + + The new signal strength (an integer) + @@ -2210,7 +2087,7 @@ the channel."> - + @@ -2219,13 +2096,13 @@ the channel."> - + - + @@ -2234,24 +2111,23 @@ the channel."> - + - + + An enumeration for flags indicating the available capabilities +of a #GstTunerChannel. - - + + - + - + + + @@ -2288,7 +2164,7 @@ of a #GstTunerChannel." - + @@ -2302,9 +2178,9 @@ of a #GstTunerChannel." - - - + + + @@ -2315,9 +2191,11 @@ of a #GstTunerChannel." - + - + + + @@ -2327,7 +2205,7 @@ of a #GstTunerChannel." - + @@ -2341,9 +2219,9 @@ of a #GstTunerChannel." - - - + + + @@ -2354,7 +2232,7 @@ of a #GstTunerChannel." - + @@ -2366,15 +2244,15 @@ of a #GstTunerChannel." - + - + - + @@ -2387,9 +2265,9 @@ of a #GstTunerChannel." - + - + @@ -2402,7 +2280,7 @@ of a #GstTunerChannel." - + @@ -2417,7 +2295,7 @@ of a #GstTunerChannel." - + @@ -2432,7 +2310,7 @@ of a #GstTunerChannel." - + @@ -2444,13 +2322,13 @@ of a #GstTunerChannel." - + - + @@ -2462,20 +2340,20 @@ of a #GstTunerChannel." - + - + - + - + - + Opaque #GstVideoOrientation data structure. - + + + Get the horizontal centering offset from the given object. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + %TRUE in case the element supports centering + - + return location for the result + - + + Get the horizontal flipping state (%TRUE for flipped) from the given object. - + %TRUE in case the element supports flipping + + + + + return location for the result + + + + + + Get the vertical centering offset from the given object. + + %TRUE in case the element supports centering + - + return location for the result + - + + Get the vertical flipping state (%TRUE for flipped) from the given object. - + %TRUE in case the element supports flipping + - - + + return location for the result + - - + + + Set the horizontal centering offset for the given object. - + %TRUE in case the element supports centering + - - + + centering offset + - + + + Set the horizontal flipping state (%TRUE for flipped) for the given object. + + %TRUE in case the element supports flipping + + + + + use flipping + + + + + + Set the vertical centering offset for the given object. + + %TRUE in case the element supports centering + + + + + centering offset + + + + + + Set the vertical flipping state (%TRUE for flipped) for the given object. + + %TRUE in case the element supports flipping + + + + + use flipping + + + + + Get the horizontal centering offset from the given object. - + %TRUE in case the element supports centering + - - + + return location for the result + + + + + + Get the horizontal flipping state (%TRUE for flipped) from the given object. + + %TRUE in case the element supports flipping + + + + + return location for the result + + Get the vertical centering offset from the given object. - + %TRUE in case the element supports centering + - - + + return location for the result + - + Get the vertical flipping state (%TRUE for flipped) from the given object. - + %TRUE in case the element supports flipping + - - - - - - - - - - - + return location for the result + + Set the horizontal centering offset for the given object. - + %TRUE in case the element supports centering + - + centering offset + + + + + + Set the horizontal flipping state (%TRUE for flipped) for the given object. + + %TRUE in case the element supports flipping + + + + + use flipping + + Set the vertical centering offset for the given object. - + %TRUE in case the element supports centering + - + centering offset + + + + + + Set the vertical flipping state (%TRUE for flipped) for the given object. + + %TRUE in case the element supports flipping + + + + + use flipping + + glib:is-gtype-struct-for="VideoOrientation"> + #GstVideoOrientationInterface interface. - + - + %TRUE in case the element supports flipping + - - + + return location for the result + - + - + %TRUE in case the element supports flipping + - - + + return location for the result + - + - + %TRUE in case the element supports centering + - - + + return location for the result + - + - + %TRUE in case the element supports centering + - - + + return location for the result + - + - + %TRUE in case the element supports flipping + - + use flipping + - + - + %TRUE in case the element supports flipping + - + use flipping + - + - + %TRUE in case the element supports centering + - + centering offset + - + - + %TRUE in case the element supports centering + - + centering offset + - + - + - + glib:get-type="gst_x_overlay_get_type"> + Opaque #GstXOverlay data structure. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - + + #GstXOverlay interface + - + @@ -2993,13 +2795,13 @@ This function should only be used by video overlay plugin developers."> - + - + @@ -3011,7 +2813,7 @@ This function should only be used by video overlay plugin developers."> - + @@ -3020,13 +2822,13 @@ This function should only be used by video overlay plugin developers."> - + - + @@ -3035,492 +2837,696 @@ This function should only be used by video overlay plugin developers."> - + - + - + - + - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Check a bus message to see if it is a GstMixer notification message and return the GstMixerMessageType identifying which type of notification it is. -if the message is not a GstMixer notification." - version="0.10.14"> - +if the message is not a GstMixer notification. + + The type of the GstMixerMessage, or GST_MIXER_MESSAGE_INVALID + A GstMessage to inspect. + Extracts the contents of a mute-toggled bus message. Reads the GstMixerTrack that has changed, and the new value of the mute flag. -The GstMixerTrack remains valid until the message is freed." - version="0.10.14"> +The GstMixerTrack remains valid until the message is freed. + A mute-toggled change notification message. + Pointer to hold a GstMixerTrack object, or NULL. - - + + A pointer to a gboolean variable, or NULL. + + Extracts the GstMixerOptions and new value from a option-changed bus notification +message. +The options and value returned remain valid until the message is freed. + A volume-changed change notification message. + Pointer to hold a GstMixerOptions object, or NULL. - - - + Result location to receive the new options value, or NULL. + + Extracts the GstMixerOptions whose value list has changed from an options-list-changed bus notification message. The options object returned remains valid until the message is freed. You -do not need to unref it." - version="0.10.18"> +do not need to unref it. + A volume-changed change notification message. + Pointer to hold a GstMixerOptions object, or NULL. + Extracts the contents of a record-toggled bus message. Reads +the GstMixerTrack that has changed, and the new value of the +recording flag. +The GstMixerTrack remains valid until the message is freed. + A record-toggled change notification message. + Pointer to hold a GstMixerTrack object, or NULL. - - + + A pointer to a gboolean variable, or NULL. + + Parses a volume-changed notification message and extracts the track object it refers to, as well as an array of volumes and the size of the volumes array. The track object remains valid until the message is freed. The caller must free the array returned in the volumes parameter using g_free -when they are done with it." - version="0.10.14"> +when they are done with it. + A volume-changed change notification message. + Pointer to hold a GstMixerTrack object, or NULL. - - + + A pointer to receive an array of gint values, or NULL. + - - + + Result location to receive the number of channels, or NULL. + - + Inspect a #GstEvent and return the #GstNavigationEventType of the event, or +#GST_NAVIGATION_EVENT_INVALID if the event is not a #GstNavigation event. + + A #GstEvent to inspect. + Inspect a #GstNavigation command event and retrieve the enum value of the +associated command. - + TRUE if the navigation command could be extracted, otherwise FALSE. + + A #GstEvent to inspect. + Pointer to GstNavigationCommand to receive the type of the navigation event. - + + A #GstEvent to inspect. - - - + A pointer to a location to receive the string identifying the key press. The returned string is owned by the event, and valid only until the event is unreffed. + + Retrieve the details of either a #GstNavigation mouse button press event or a mouse button release event. Determine which type the event is using gst_navigation_event_get_type() to retrieve the #GstNavigationEventType. -otherwise FALSE." - version="0.10.23"> +otherwise FALSE. - + TRUE if the button number and both coordinates could be extracted, + + A #GstEvent to inspect. - - + + Pointer to a gint that will receive the button number associated with the event. + - - + + Pointer to a gdouble to receive the x coordinate of the mouse button event. + - - + + Pointer to a gdouble to receive the y coordinate of the mouse button event. + + Inspect a #GstNavigation mouse movement event and extract the coordinates +of the event. - + TRUE if both coordinates could be extracted, otherwise FALSE. + + A #GstEvent to inspect. - - + + Pointer to a gdouble to receive the x coordinate of the mouse movement. + - - + + Pointer to a gdouble to receive the y coordinate of the mouse movement. + + Check a bus message to see if it is a #GstNavigation event, and return the #GstNavigationMessageType identifying the type of the message if so. #GST_NAVIGATION_MESSAGE_INVALID if the message is not a #GstNavigation -notification." - version="0.10.23"> - +notification. + + The type of the #GstNavigationMessage, or + A #GstMessage to inspect. + Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_ANGLES_CHANGED for notifying an application that the current angle, or current number of angles available in a -multiangle video has changed." - version="0.10.23"> - +multiangle video has changed. + + The new #GstMessage. + A #GstObject to set as source of the new message. - + The currently selected angle. + - + The number of viewing angles now available. + - + version="0.10.23" + introspectable="0"> + Creates a new #GstNavigation message with type +#GST_NAVIGATION_MESSAGE_COMMANDS_CHANGED + + The new #GstMessage. + A #GstObject to set as source of the new message. - + version="0.10.23" + introspectable="0"> + Creates a new #GstNavigation message with type +#GST_NAVIGATION_MESSAGE_MOUSE_OVER. + + The new #GstMessage. + A #GstObject to set as source of the new message. - + %TRUE if the mouse has entered a clickable area of the display. %FALSE if it over a non-clickable area. + + Parse a #GstNavigation message of type GST_NAVIGATION_MESSAGE_ANGLES_CHANGED +and extract the @cur_angle and @n_angles parameters. - + %TRUE if the message could be successfully parsed. %FALSE if not. + + A #GstMessage to inspect. - - + + A pointer to a #guint to receive the new current angle number, or NULL + - - + + A pointer to a #guint to receive the new angle count, or NULL. + + Parse a #GstNavigation message of type #GST_NAVIGATION_MESSAGE_MOUSE_OVER +and extract the active/inactive flag. If the mouse over event is marked +active, it indicates that the mouse is over a clickable area. - + %TRUE if the message could be successfully parsed. %FALSE if not. + + A #GstMessage to inspect. - - + + A pointer to a gboolean to receive the active/inactive state, or NULL. + - + Inspect a #GstQuery and return the #GstNavigationQueryType associated with +it if it is a #GstNavigation query. +#GST_NAVIGATION_QUERY_INVALID + + The #GstNavigationQueryType of the query, or + The query to inspect + Create a new #GstNavigation angles query. When executed, it will query the pipeline for the set of currently available angles, which may be -greater than one in a multiangle video." - version="0.10.23"> - +greater than one in a multiangle video. + + The new query. - + version="0.10.23" + introspectable="0"> + Create a new #GstNavigation commands query. When executed, it will +query the pipeline for the set of currently available commands. + + The new query. + Parse the current angle number in the #GstNavigation angles @query into the +#guint pointed to by the @cur_angle variable, and the number of available +angles into the #guint pointed to by the @n_angles variable. - + %TRUE if the query could be successfully parsed. %FALSE if not. + + a #GstQuery - - + + Pointer to a #guint into which to store the currently selected angle value from the query, or NULL + - - + + Pointer to a #guint into which to store the number of angles value from the query, or NULL + + Parse the number of commands in the #GstNavigation commands @query. - + %TRUE if the query could be successfully parsed. %FALSE if not. + + a #GstQuery - - + + the number of commands in this query. + + Parse the #GstNavigation command query and retrieve the @nth command from +it into @cmd. If the list contains less elements than @nth, @cmd will be +set to #GST_NAVIGATION_COMMAND_INVALID. - + %TRUE if the query could be successfully parsed. %FALSE if not. + + a #GstQuery - + the nth command to retrieve. + + a pointer to store the nth command into. + Set the #GstNavigation angles query result field in @query. + a #GstQuery - + the current viewing angle to set. + - + the number of viewing angles to set. + + version="0.10.23" + introspectable="0"> + Set the #GstNavigation command query result fields in @query. The number +of commands passed must be equal to @n_commands. + a #GstQuery - + the number of commands to set. + @@ -3530,20 +3536,23 @@ of commands passed must be equal to @n_commands." + Set the #GstNavigation command query result fields in @query. The number +of commands passed must be equal to @n_commands. + a #GstQuery - + the number of commands to set. + + An array containing @n_cmds @GstNavigationCommand values. @@ -3552,17 +3561,192 @@ of commands passed must be equal to @n_commands." c:identifier="gst_stream_volume_convert_volume" version="0.10.25"> - + the converted volume + + #GstStreamVolumeFormat to convert from + #GstStreamVolumeFormat to convert to - + Volume in @from format that should be converted + + + + + + Tell an overlay that it has been exposed. This will redraw the current frame +in the drawable even if the pipeline is PAUSED. + + + + + + a #GstXOverlay to expose. + + + + + + This will post a "have-xwindow-id" element message on the bus. +This function should only be used by video overlay plugin developers. + + + + + + a #GstXOverlay which got a window + + + + a platform-specific handle referencing the window + + + + + + This will post a "have-xwindow-id" element message on the bus. +This function should only be used by video overlay plugin developers. + + + + + + a #GstXOverlay which got a XWindow. + + + + a #XID referencing the XWindow. + + + + + + Tell an overlay that it should handle events from the window system. These +events are forwared upstream as navigation events. In some window system, +events are not propagated in the window hierarchy if a client is listening +for them. This method allows you to disable events handling completely +from the XOverlay. + + + + + + a #GstXOverlay to expose. + + + + a #gboolean indicating if events should be handled or not. + + + + + + This will post a "prepare-xwindow-id" element message on the bus +to give applications an opportunity to call +gst_x_overlay_set_xwindow_id() before a plugin creates its own +window. +This function should only be used by video overlay plugin developers. + + + + + + a #GstXOverlay which does not yet have an XWindow. + + + + + + Configure a subregion as a video target within the window set by +gst_x_overlay_set_window_handle(). If this is not used or not supported +the video will fill the area of the window set as the overlay to 100%. +By specifying the rectangle, the video can be overlayed to a specific region +of that window only. After setting the new rectangle one should call +gst_x_overlay_expose() to force a redraw. To unset the region pass -1 for +the @width and @height parameters. +This method is needed for non fullscreen video overlay in UI toolkits that +do not support subwindows. + + %FALSE if not supported by the sink. + + + + + a #GstXOverlay + + + + the horizontal offset of the render area inside the window + + + + the vertical offset of the render area inside the window + + + + the width of the render area inside the window + + + + the height of the render area inside the window + + + + + + This will call the video overlay's set_window_handle method. You +should use this method to tell to a XOverlay to display video output to a +specific XWindow. Passing 0 as the xwindow_id will tell the overlay to +stop using that window and create an internal one. + + + + + + a #GstXOverlay to set the XWindow on. + + + + + + + + + This will call the video overlay's set_xwindow_id method. You should +use this method to tell to a XOverlay to display video output to a +specific XWindow. Passing 0 as the xwindow_id will tell the overlay to +stop using that window and create an internal one. + + + + + + a #GstXOverlay to set the XWindow on. + + + + a #XID referencing the XWindow. + diff --git a/unmaintained/gstreamer/interfaces/ffi/ffi.factor b/unmaintained/gstreamer/plugins/interfaces/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/interfaces/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/interfaces/ffi/ffi.factor diff --git a/unmaintained/gstreamer/interfaces/interfaces.factor b/unmaintained/gstreamer/plugins/interfaces/interfaces.factor similarity index 100% rename from unmaintained/gstreamer/interfaces/interfaces.factor rename to unmaintained/gstreamer/plugins/interfaces/interfaces.factor diff --git a/unmaintained/gstreamer/netbuffer/GstNetbuffer-0.10.gir b/unmaintained/gstreamer/plugins/netbuffer/GstNetbuffer-0.10.gir similarity index 51% rename from unmaintained/gstreamer/netbuffer/GstNetbuffer-0.10.gir rename to unmaintained/gstreamer/plugins/netbuffer/GstNetbuffer-0.10.gir index 4095f0d032..c9f1f5b1c9 100644 --- a/unmaintained/gstreamer/netbuffer/GstNetbuffer-0.10.gir +++ b/unmaintained/gstreamer/plugins/netbuffer/GstNetbuffer-0.10.gir @@ -2,7 +2,7 @@ - @@ -11,257 +11,296 @@ and/or use gtk-doc annotations. --> - + - + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> + + An opaque network address as used in #GstNetBuffer. - + - + - + - + - - + + buffer for use in network sources and sinks. +It contains the source or destination address of the buffer. + + Create a new network buffer. + + a new #GstNetBuffer. + + + + - + - + - + - + - - - + + + - + - + - + + The Address type used in #GstNetAddress. + Compare two #GstNetAddress structures - + TRUE if they are identical, FALSE otherwise + + The first #GstNetAddress + The second #GstNetAddress + Get just the address bytes stored in @naddr into @address. +Note that @port is expressed in network byte order, use g_ntohs() to convert +it to host order. IP4 addresses are also stored in network byte order. - + number of bytes actually copied + + a network address - + a location to store the result. + - - + + a location to store the port. + + Get the IPv4 address stored in @naddr into @address. This function requires that the address type of @naddr is of type #GST_NET_TYPE_IP4. Note that @port and @address are expressed in network byte order, use -g_ntohs() and g_ntohl() to convert them to host order."> +g_ntohs() and g_ntohl() to convert them to host order. - + TRUE if the address could be retrieved. + + a network address - - + + a location to store the address. + - - + + a location to store the port. + + Get the IPv6 address stored in @naddr into @address. If @naddr is of type GST_NET_TYPE_IP4, the transitional IP6 address is returned. Note that @port is expressed in network byte order, use g_ntohs() to convert -it to host order."> +it to host order. - + TRUE if the address could be retrieved. + + a network address - + a location to store the result. + - - + + a location to store the port. + - + c:identifier="gst_netaddress_get_net_type"> + Get the type of address stored in @naddr. + + the network type stored in @naddr. + a network address + Set just the address bytes stored in @naddr into @address. Note that @port must be expressed in network byte order, use g_htons() to convert it to network byte order order. IP4 address bytes must also be -stored in network byte order." - version="0.10.22"> +stored in network byte order. - + number of bytes actually copied + + a network address + the address type (IPv4 or IPV6) - + a location to store the result. + - + a location to store the port. + + Set @naddr with the IPv4 @address and @port pair. Note that @port and @address must be expressed in network byte order, -use g_htons() and g_htonl() to convert them to network byte order."> +use g_htons() and g_htonl() to convert them to network byte order. + a network address - + an IPv4 network address. + - + a port number to set. + + Set @naddr with the IPv6 @address and @port pair. Note that @port must be expressed in network byte order, use g_htons() to convert -it to network byte order."> +it to network byte order. + a network address - + an IPv6 network address. + - + a port number to set. + + Copies a string representation of @naddr into @dest. Up to @len bytes are +copied. +enough - + the number of bytes which would be produced if the buffer was large + + a #GstNetAddress - + + destination - + len of @dest + - - - - - diff --git a/unmaintained/gstreamer/netbuffer/ffi/ffi.factor b/unmaintained/gstreamer/plugins/netbuffer/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/netbuffer/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/netbuffer/ffi/ffi.factor diff --git a/unmaintained/gstreamer/netbuffer/netbuffer.factor b/unmaintained/gstreamer/plugins/netbuffer/netbuffer.factor similarity index 100% rename from unmaintained/gstreamer/netbuffer/netbuffer.factor rename to unmaintained/gstreamer/plugins/netbuffer/netbuffer.factor diff --git a/unmaintained/gstreamer/plugins/pbutils/GstPbutils-0.10.gir b/unmaintained/gstreamer/plugins/pbutils/GstPbutils-0.10.gir new file mode 100644 index 0000000000..99d8f89eba --- /dev/null +++ b/unmaintained/gstreamer/plugins/pbutils/GstPbutils-0.10.gir @@ -0,0 +1,2336 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The #GstDiscoverer structure. + + Creates a new #GstDiscoverer with the provided timeout. +If an error occurred when creating the discoverer, @err will be set +accordingly and %NULL will be returned. If @err is set, the caller must +free it when no longer needed using g_error_free(). + + The new #GstDiscoverer. + + + + + timeout per file, in nanoseconds. Allowed are values between one second (#GST_SECOND) and one hour (3600 * #GST_SECOND) + + + + + + Synchronously discovers the given @uri. +A copy of @uri will be made internally, so the caller can safely g_free() +afterwards. +error occurred. + + the result of the scanning. Can be %NULL if an + + + + + The URI to run on. + + + + + + Appends the given @uri to the list of URIs to discoverer. The actual +discovery of the @uri will only take place if gst_discoverer_start() has +been called. +A copy of @uri will be made internally, so the caller can safely g_free() +afterwards. +uris, else %FALSE + + %TRUE if the @uri was succesfully appended to the list of pending + + + + + the URI to add. + + + + + + Allow asynchronous discovering of URIs to take place. +A #GMainLoop must be available for #GstDiscoverer to properly work in +asynchronous mode. + + + + + + Stop the discovery of any pending URIs and clears the list of +pending URIS (if any). + + + + + + + + + + + + + + + + + + + + Will be emitted when all information on a URI could be discovered. + + + + + + the results #GstDiscovererInfo + + + + #GError, which will be non-NULL if an error occurred during discovery + + + + + + Will be emitted when all pending URIs have been processed. + + + + + + Will be emitted when the discover starts analyzing the pending URIs + + + + + + + #GstDiscovererStreamInfo specific to audio streams. + + + the average or nominal bitrate of the stream in bits/second. + + + + + + the number of channels in the stream. + + + + + + the number of bits used per sample in each channel. + + + + + + the maximum bitrate of the stream in bits/second. + + + + + + the sample rate of the stream in Hertz. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + #GstDiscovererStreamInfo specific to container streams. + + #GstDiscovererStreamInfo this container stream offers. +Free with gst_discoverer_stream_info_list_free() after usage. + + the list of + + + + + + + + Structure containing the information of a URI analyzed by #GstDiscoverer. + + + + + + + Finds all the #GstDiscovererAudioInfo contained in @info +matching #GstDiscovererStreamInfo. The caller should free it with +gst_discoverer_stream_info_list_free(). + + A #GList of + + + + + + + Finds all the #GstDiscovererContainerInfo contained in @info +matching #GstDiscovererStreamInfo. The caller should free it with +gst_discoverer_stream_info_list_free(). + + A #GList of + + + + + + + + the duration of the URI in #GstClockTime (nanoseconds). + + + + + (for example: information about missing plugins). If you wish to use the +#GstStructure after the life-time of @info, you will need to copy it. + + Miscellaneous information stored as a #GstStructure + + + + + + the result of the discovery as a #GstDiscovererResult. + + + + + + the wheter the URI is seekable. + + + + + #GstDiscovererStreamInfo. +This structure can be traversed to see the original hierarchy. Unref with +gst_discoverer_stream_info_unref() after usage. + + the structure (or topology) of the URI as a + + + + + all streams contained in the #info. Free after usage +with gst_discoverer_stream_info_list_free(). + + the list of + + + + + + + Finds the #GstDiscovererStreamInfo contained in @info that match the +given @streamtype. +matching #GstDiscovererStreamInfo. The caller should free it with +gst_discoverer_stream_info_list_free(). + + A #GList of + + + + + + + a #GType derived from #GstDiscovererStreamInfo + + + + + + the tags after the life-time of @info, you will need to copy them. + + all tags contained in the %URI. If you wish to use + + + + + Copy it if you wish to use it after the life-time of @info. + + the URI to which this information corresponds to. + + + + + Finds all the #GstDiscovererVideoInfo contained in @info +matching #GstDiscovererStreamInfo. The caller should free it with +gst_discoverer_stream_info_list_free(). + + A #GList of + + + + + + + + + + Result values for the discovery process. + + + + + + + + + Base structure for information concerning a media stream. Depending on the +stream type, one can find more media-specific information in +#GstDiscovererAudioInfo, #GstDiscovererVideoInfo, and +#GstDiscovererContainerInfo. +The #GstDiscovererStreamInfo represents the topology of the stream. Siblings +can be iterated over with gst_discoverer_stream_info_get_next() and +gst_discoverer_stream_info_get_previous(). Children (sub-streams) of a +stream can be accessed using the #GstDiscovererContainerInfo API. +As a simple example, if you run #GstDiscoverer on an AVI file with one audio +and one video stream, you will get a #GstDiscovererContainerInfo +corresponding to the AVI container, which in turn will have a +#GstDiscovererAudioInfo sub-stream and a #GstDiscovererVideoInfo sub-stream +for the audio and video streams respectively. + + Decrements the reference count of all contained #GstDiscovererStreamInfo +and fress the #GList. + + + + + + a #GList of #GstDiscovererStreamInfo + + + + + + + + #gst_caps_unref after usage. + + the #GstCaps of the stream. Unref with + + + + + example codec version, profile, etc..). If you wish to use the #GstStructure +after the life-time of @info you will need to copy it. + + additional information regarding the stream (for + + + + + for final streams. +Unref with #gst_discoverer_stream_info_unref after usage. + + the next #GstDiscovererStreamInfo in a chain. %NULL + + + + + %NULL for starting points. Unref with #gst_discoverer_stream_info_unref +after usage. + + the previous #GstDiscovererStreamInfo in a chain. + + + + + "container",...). + + a human readable name for the stream type of the given @info (ex : "audio", + + + + + use the tags after the life-time of @info you will need to copy them. + + the tags contained in this stream. If you wish to + + + + + + #GstDiscovererStreamInfo specific to video streams (this includes images). + + + the average or nominal bitrate of the video stream in bits/second. + + + + + + the depth in bits of the video stream. + + + + + + the framerate of the video stream (denominator). + + + + + + the framerate of the video stream (numerator). + + + + + + the height of the video stream in pixels. + + + + + + the maximum bitrate of the video stream in bits/second. + + + + + + the Pixel Aspect Ratio (PAR) of the video stream (denominator). + + + + + + the Pixel Aspect Ratio (PAR) of the video stream (numerator). + + + + + + the width of the video stream in pixels. + + + + + one frame). + + #TRUE if the video stream corresponds to an image (i.e. only contains + + + + + + %TRUE if the stream is interlaced, else %FALSE. + + + + + + + + + + + + + + + + + + Variant of #GstEncodingProfile for audio streams. + + Creates a new #GstEncodingAudioProfile +All provided allocatable arguments will be internally copied, so can be +safely freed/unreferenced after calling this method. + + the newly created #GstEncodingAudioProfile. + + + + + the #GstCaps + + + + the preset(s) to use on the encoder, can be #NULL + + + + the #GstCaps used to restrict the input to the encoder, can be NULL. See gst_encoding_profile_get_restriction() for more details. + + + + the number of time this stream must be used. 0 means any number of times (including never) + + + + + + + Encoding profiles for containers. Keeps track of a list of #GstEncodingProfile + + Creates a new #GstEncodingContainerProfile. + + The newly created #GstEncodingContainerProfile. + + + + + The name of the container profile, can be %NULL + + + + The description of the container profile, can be %NULL + + + + The format to use for this profile + + + + The preset to use for this profile + + + + + + Add a #GstEncodingProfile to the list of profiles handled by @container. +No copy of @profile will be made, if you wish to use it elsewhere after this +method you should increment its reference count. + + %TRUE if the @stream was properly added, else %FALSE. + + + + + the #GstEncodingProfile to add. + + + + + + Checks if @container contains a #GstEncodingProfile identical to +to @profile, else %FALSE. + + %TRUE if @container contains a #GstEncodingProfile identical + + + + + a #GstEncodingProfile + + + + + + + + + + + + + + The opaque base class object for all encoding profiles. This contains generic +information like name, description, format and preset. + + Find the #GstEncodingProfile with the specified name and category. + + The matching #GstEncodingProfile or %NULL. + + + + + The name of the target + + + + The name of the profile + + + + The target category. Can be %NULL + + + + + + + the description of the profile, can be %NULL. + + + + + + the #GstCaps corresponding to the media format used in the profile. + + + + + Computes the full output caps that this @profile will be able to consume. +when you are done with the caps. + + The full caps the given @profile can consume. Call gst_caps_unref() + + + + + + the name of the profile, can be %NULL. + + + + + container profile. If 0, it is not a mandatory stream. + + The number of times the profile is used in its parent + + + + + + the name of the #GstPreset to be used in the profile. + + + + + that will be used in the profile. The fields present in restriction caps are +properties of the raw stream (that is before encoding), such as height and +width for video and depth and sampling rate for audio. Does not apply to +#GstEncodingContainerProfile (since there is no corresponding raw stream). +Can be %NULL. + + The restriction #GstCaps to apply before the encoder + + + + + + the human-readable name of the type of @profile. + + + + + Checks whether the two #GstEncodingProfile are equal + + %TRUE if @a and @b are equal, else %FALSE. + + + + + a #GstEncodingProfile + + + + + + Set @description as the given description for the @profile. A copy of @description will be made +internally. + + + + + + the description to set on the profile + + + + + + Sets the media format used in the profile. + + + + + + the media format to use in the profile. + + + + + + Set @name as the given name for the @profile. A copy of @name will be made +internally. + + + + + + the name to set on the profile + + + + + + Set the number of time the profile is used in its parent +container profile. If 0, it is not a mandatory stream + + + + + + the number of time the profile can be used + + + + + + Sets the preset to use for the profile. + + + + + + the element preset to use + + + + + + Set the restriction #GstCaps to apply before the encoder +that will be used in the profile. See gst_encoding_profile_set_restriction() +for more about restrictions. Does not apply to #GstEncodingContainerProfile. + + + + + + the restriction to apply + + + + + + + Collection of #GstEncodingProfile for a specific target or use-case. +When being stored/loaded, targets come from a specific category, like +#GST_ENCODING_CATEGORY_DEVICE. + + Creates a new #GstEncodingTarget. +The name and category can only consist of lowercase ASCII letters for the +first character, followed by either lowercase ASCII letters, digits or +hyphens ('-'). +The @category <emphasis>should</emphasis> be one of the existing +well-defined categories, like #GST_ENCODING_CATEGORY_DEVICE, but it +<emphasis>can</emphasis> be a application or user specific category if +needed. +there was an error. + + The newly created #GstEncodingTarget or %NULL if + + + + + The name of the target. + + + + The name of the category to which this @target belongs. For example: #GST_ENCODING_CATEGORY_DEVICE. + + + + A description of #GstEncodingTarget in the current locale. + + + + A #GList of #GstEncodingProfile. + + + + + + + + Searches for the #GstEncodingTarget with the given name, loads it +and returns it. +If the category name is specified only targets from that category will be +searched for. + + The #GstEncodingTarget if available, else %NULL. + + + + + the name of the #GstEncodingTarget to load. + + + + the name of the target category, like #GST_ENCODING_CATEGORY_DEVICE. Can be %NULL + + + + + + Opens the provided file and returns the contained #GstEncodingTarget. +%NULL + + The #GstEncodingTarget contained in the file, else + + + + + The file location to load the #GstEncodingTarget from + + + + + + Adds the given @profile to the @target. Each added profile must have +a unique name within the profile. +The @target will steal a reference to the @profile. If you wish to use +the profile after calling this method, you should increase its reference +count. + + %TRUE if the profile was added, else %FALSE. + + + + + the #GstEncodingProfile to add + + + + + + #GST_ENCODING_CATEGORY_DEVICE. + + The category of the @target. For example: + + + + + + The description of the @target. + + + + + + The name of the @target. + + + + + + The matching #GstEncodingProfile, or %NULL. + + + + + the name of the profile to retrieve + + + + + + #GstEncodingProfile(s) this @target handles. + + A list of + + + + + + + Saves the @target to a default user-local directory. + + %TRUE if the target was correctly saved, else %FALSE. + + + + + Saves the @target to the provided file location. + + %TRUE if the target was correctly saved, else %FALSE. + + + + + the location to store the @target at. + + + + + + + Variant of #GstEncodingProfile for video streams, allows specifying the @pass. + + Creates a new #GstEncodingVideoProfile +All provided allocatable arguments will be internally copied, so can be +safely freed/unreferenced after calling this method. +If you wish to control the pass number (in case of multi-pass scenarios), +please refer to the gst_encoding_video_profile_set_pass() documentation. +If you wish to use/force a constant framerate please refer to the +gst_encoding_video_profile_set_variableframerate() documentation. + + the newly created #GstEncodingVideoProfile. + + + + + the #GstCaps + + + + the preset(s) to use on the encoder, can be #NULL + + + + the #GstCaps used to restrict the input to the encoder, can be NULL. See gst_encoding_profile_get_restriction() for more details. + + + + the number of time this stream must be used. 0 means any number of times (including never) + + + + + + 1 for multi-pass. 0 if this is not a multi-pass profile + + The pass number if this is part of a multi-pass profile. Starts at + + + + + + Whether non-constant video framerate is allowed for encoding. + + + + + Sets the pass number of this video profile. The first pass profile should have +this value set to 1. If this video profile isn't part of a multi-pass profile, +you may set it to 0 (the default value). + + + + + + the pass number for this profile + + + + + + If set to %TRUE, then the incoming streamm will be allowed to have non-constant +framerate. If set to %FALSE (default value), then the incoming stream will +be normalized by dropping/duplicating frames in order to produce a +constance framerate. + + + + + + a boolean + + + + + + + Opaque context structure for the plugin installation. Use the provided +API to set details on it. + + Creates a new #GstInstallPluginsContext. +gst_install_plugins_context_free() when no longer needed + + a new #GstInstallPluginsContext. Free with + + + + + Frees a #GstInstallPluginsContext. + + + + + + This function is for X11-based applications (such as most Gtk/Qt +applications on linux/unix) only. You can use it to tell the external +installer the XID of your main application window. That way the installer +can make its own window transient to your application window during the +installation. +If set, the XID will be passed to the installer via a --transient-for=XID +command line option. +Gtk+/Gnome application should be able to obtain the XID of the top-level +window like this: +<programlisting> +##include &lt;gtk/gtk.h&gt; +##ifdef GDK_WINDOWING_X11 +##include &lt;gdk/gdkx.h&gt; +##endif +... +##ifdef GDK_WINDOWING_X11 +xid = GDK_WINDOW_XWINDOW (GTK_WIDGET (application_window)-&gt;window); +##endif +... +</programlisting> + + + + + + the XWindow ID (XID) of the top-level application + + + + + + + The prototype of the callback function that will be called once the +external plugin installer program has returned. You only need to provide +a callback function if you are using the asynchronous interface. + + + + + + whether the installation of the requested plugins succeeded or not + + + + the user data passed to gst_install_plugins_async() + + + + + + Result codes returned by gst_install_plugins_async() and +gst_install_plugins_sync(), and also the result code passed to the +#GstInstallPluginsResultFunc specified with gst_install_plugin_async(). +These codes indicate success or failure of starting an external installer +program and to what extent the requested plugins could be installed. + + + + + + + + + + + + + + + + + + + + + + + + + + Sets the level and profile on @caps if it can be determined from +gst_codec_utils_aac_get_profile() for more details on the parameters. +If mpegversion is 4, the "base-profile" field is also set in @caps. + + %TRUE if the level and profile could be set, %FALSE otherwise. + + + + + the #GstCaps to which level and profile fields are to be added + + + + a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1 (see below for a more details). + + + + Length of @audio_config in bytes + + + + + + Determines the level of a stream as defined in ISO/IEC 14496-3. For AAC LC +streams, the constraints from the AAC audio profile are applied. For AAC +Main, LTP, SSR and others, the Main profile is used. +The @audio_config parameter follows the following format, starting from the +most significant bit of the first byte: +<itemizedlist> +<listitem><para> +Bit 0:4 contains the AudioObjectType +</para></listitem> +<listitem><para> +Bit 5:8 contains the sample frequency index (if this is 0xf, then the +next 24 bits define the actual sample frequency, and subsequent +fields are appropriately shifted). +</para></listitem> +<listitem><para> +Bit 9:12 contains the channel configuration +</para></listitem> +</itemizedlist> +<note> +HE-AAC support has not yet been implemented. +</note> +determined. + + The level as a const string and %NULL if the level could not be + + + + + a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1. + + + + Length of @audio_config in bytes + + + + + + Returns the profile of the given AAC stream as a string. The profile is +determined using the AudioObjectType field which is in the first 5 bits of +<note> +HE-AAC support has not yet been implemented. +</note> +determined. + + The profile as a const string and %NULL if the profile could not be + + + + + a pointer to the AudioSpecificConfig as specified in the Elementary Stream Descriptor (esds) in ISO/IEC 14496-1 (see gst_codec_utils_aac_get_level() for a more details). + + + + Length of @audio_config in bytes + + + + + + Translates the sample rate index found in AAC headers to the actual sample +rate. + + The sample rate if @sr_idx is valid, 0 otherwise. + + + + + Sample rate index as from the AudioSpecificConfig (MPEG-4 container) or ADTS frame header + + + + + + Sets the level and profile in @caps if it can be determined from @sps. See +gst_codec_utils_h264_get_level() and gst_codec_utils_h264_get_profile() +for more details on the parameters. + + %TRUE if the level and profile could be set, %FALSE otherwise. + + + + + the #GstCaps to which the level and profile are to be added + + + + Pointer to the sequence parameter set for the stream. + + + + Length of the data available in @sps. + + + + + + Converts the level indication (level_idc) in the stream's +sequence parameter set into a string. The SPS is expected to have the +same format as for gst_codec_utils_h264_get_profile(). + + The level as a const string, or %NULL if there is an error. + + + + + Pointer to the sequence parameter set for the stream. + + + + Length of the data available in @sps. + + + + + + Converts the profile indication (profile_idc) in the stream's +sequence parameter set into a string. The SPS is expected to have the +following format, as defined in the H.264 specification. The SPS is viewed +as a bitstream here, with bit 0 being the most significant bit of the first +byte. +<itemizedlist> +<listitem><para>Bit 0:7 - Profile indication</para></listitem> +<listitem><para>Bit 8 - constraint_set0_flag</para></listitem> +<listitem><para>Bit 9 - constraint_set1_flag</para></listitem> +<listitem><para>Bit 10 - constraint_set2_flag</para></listitem> +<listitem><para>Bit 11 - constraint_set3_flag</para></listitem> +<listitem><para>Bit 12 - constraint_set3_flag</para></listitem> +<listitem><para>Bit 13:15 - Reserved</para></listitem> +<listitem><para>Bit 16:24 - Level indication</para></listitem> +</itemizedlist> + + The profile as a const string, or %NULL if there is an error. + + + + + Pointer to the sequence parameter set for the stream. + + + + Length of the data available in @sps. + + + + + + Sets the level and profile in @caps if it can be determined from +gst_codec_utils_mpeg4video_get_profile() for more details on the +parameters. + + %TRUE if the level and profile could be set, %FALSE otherwise. + + + + + the #GstCaps to which the level and profile are to be added + + + + Pointer to the visual object sequence for the stream. + + + + Length of the data available in @sps. + + + + + + Converts the level indication in the stream's visual object sequence into +a string. @vis_obj_seq is expected to be the data following the visual +object sequence start code. Only the first byte +(profile_and_level_indication) is used. + + The level as a const string, or NULL if there is an error. + + + + + Pointer to the visual object sequence for the stream. + + + + Length of the data available in @sps. + + + + + + Converts the profile indication in the stream's visual object sequence into +a string. @vis_obj_seq is expected to be the data following the visual +object sequence start code. Only the first byte +(profile_and_level_indication) is used. + + The profile as a const string, or NULL if there is an error. + + + + + Pointer to the visual object sequence for the stream. + + + + Length of the data available in @sps. + + + + + + List all available #GstEncodingTarget for the specified category, or all categories +if @categoryname is %NULL. + + The list of #GstEncodingTarget + + + + + + + The category, for ex: #GST_ENCODING_CATEGORY_DEVICE. Can be %NULL. + + + + + + Lists all #GstEncodingTarget categories present on disk. +of #GstEncodingTarget categories. + + A list + + + + + + + Requests plugin installation without blocking. Once the plugins have been +installed or installation has failed, @func will be called with the result +of the installation and your provided @user_data pointer. +This function requires a running GLib/Gtk main loop. If you are not +running a GLib/Gtk main loop, make sure to regularly call +g_main_context_iteration(NULL,FALSE). +The installer strings that make up @detail are typically obtained by +calling gst_missing_plugin_message_get_installer_detail() on missing-plugin +messages that have been caught on a pipeline's bus or created by the +application via the provided API, such as gst_missing_element_message_new(). +It is possible to request the installation of multiple missing plugins in +one go (as might be required if there is a demuxer for a certain format +installed but no suitable video decoder and no suitable audio decoder). + + result code whether an external installer could be started + + + + + NULL-terminated array of installer string details (see below) + + + + a #GstInstallPluginsContext, or NULL + + + + the function to call when the installer program returns + + + + the user data to pass to @func when called, or NULL + + + + + + Checks whether plugin installation (initiated by this application only) +is currently in progress. + + TRUE if plugin installation is in progress, otherwise FALSE + + + + + Convenience function to return the descriptive string associated +with a status code. This function returns English strings and +should not be used for user messages. It is here only to assist +in debugging. + + a descriptive string for the status code in @ret + + + + + the return status code + + + + + + Checks whether plugin installation is likely to be supported by the +current environment. This currently only checks whether the helper script +that is to be provided by the distribution or operating system vendor +exists. + + TRUE if plugin installation is likely to be supported. + + + + + Requests plugin installation and block until the plugins have been +installed or installation has failed. +This function should almost never be used, it only exists for cases where +a non-GLib main loop is running and the user wants to run it in a separate +thread and marshal the result back asynchronously into the main thread +using the other non-GLib main loop. You should almost always use +gst_install_plugins_async() instead of this function. + + the result of the installation. + + + + + NULL-terminated array of installer string details + + + + a #GstInstallPluginsContext, or NULL + + + + + + Checks whether @msg is a missing plugins message. + + %TRUE if @msg is a missing-plugins message, otherwise %FALSE. + + + + + a #GstMessage + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions in +the case where the application knows exactly what kind of plugin it is +missing. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + the (fixed) caps for which a decoder element is needed + + + + + + Creates a missing-plugin message for @element to notify the application +that a decoder element for a particular set of (fixed) caps is missing. +This function is mainly for use in plugins. + + a new #GstMessage, or NULL on error + + + + + the #GstElement posting the message + + + + the (fixed) caps for which a decoder element is needed + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions in +the case where the application knows exactly what kind of plugin it is +missing. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + the name of the missing element (element factory), e.g. "videoscale" or "cdparanoiasrc" + + + + + + Creates a missing-plugin message for @element to notify the application +that a certain required element is missing. This function is mainly for +use in plugins. + + a new #GstMessage, or NULL on error + + + + + the #GstElement posting the message + + + + the name of the missing element (element factory), e.g. "videoscale" or "cdparanoiasrc" + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions in +the case where the application knows exactly what kind of plugin it is +missing. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + the (fixed) caps for which an encoder element is needed + + + + + + Creates a missing-plugin message for @element to notify the application +that an encoder element for a particular set of (fixed) caps is missing. +This function is mainly for use in plugins. + + a new #GstMessage, or NULL on error + + + + + the #GstElement posting the message + + + + the (fixed) caps for which an encoder element is needed + + + + + + Returns a localised string describing the missing feature, for use in +error dialogs and the like. Should never return NULL unless @msg is not +a valid missing-plugin message. +This function is mainly for applications that need a human-readable string +describing a missing plugin, given a previously collected missing-plugin +message +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + a missing-plugin #GstMessage of type #GST_MESSAGE_ELEMENT + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + a missing-plugin #GstMessage of type #GST_MESSAGE_ELEMENT + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions in +the case where the application knows exactly what kind of plugin it is +missing. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + the URI protocol the missing source needs to implement, e.g. "http" or "mms" + + + + + + Creates a missing-plugin message for @element to notify the application +that a sink element for a particular URI protocol is missing. This +function is mainly for use in plugins. + + a new #GstMessage, or NULL on error + + + + + the #GstElement posting the message + + + + the URI protocol the missing sink needs to implement, e.g. "http" or "smb" + + + + + + Returns an opaque string containing all the details about the missing +element to be passed to an external installer called via +gst_install_plugins_async() or gst_install_plugins_sync(). +This function is mainly for applications that call external plugin +installation mechanisms using one of the two above-mentioned functions in +the case where the application knows exactly what kind of plugin it is +missing. +with g_free() when not needed any longer. + + a newly-allocated detail string, or NULL on error. Free string + + + + + the URI protocol the missing source needs to implement, e.g. "http" or "mms" + + + + + + Creates a missing-plugin message for @element to notify the application +that a source element for a particular URI protocol is missing. This +function is mainly for use in plugins. + + a new #GstMessage, or NULL on error + + + + + the #GstElement posting the message + + + + the URI protocol the missing source needs to implement, e.g. "http" or "mms" + + + + + + Adds a codec tag describing the format specified by @caps to @taglist. + + TRUE if a codec tag was added, FALSE otherwise. + + + + + a #GstTagList + + + + a GStreamer codec tag such as #GST_TAG_AUDIO_CODEC, #GST_TAG_VIDEO_CODEC or #GST_TAG_CODEC + + + + the (fixed) #GstCaps for which a codec tag should be added. + + + + + + Returns a localised (as far as this is possible) string describing the +media format specified in @caps, for use in error dialogs or other messages +to be seen by the user. Should never return NULL unless @caps is invalid. +Also see the convenience function +gst_pb_utils_add_codec_description_to_tag_list(). +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the (fixed) #GstCaps for which an format description is needed + + + + + + Returns a localised string describing an decoder for the format specified +in @caps, for use in error dialogs or other messages to be seen by the user. +Should never return NULL unless @factory_name or @caps are invalid. +This function is mainly for internal use, applications would typically +use gst_missing_plugin_message_get_description() to get a description of +a missing feature from a missing-plugin message. +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the (fixed) #GstCaps for which an decoder description is needed + + + + + + Returns a localised string describing the given element, for use in +error dialogs or other messages to be seen by the user. Should never +return NULL unless @factory_name is invalid. +This function is mainly for internal use, applications would typically +use gst_missing_plugin_message_get_description() to get a description of +a missing feature from a missing-plugin message. +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the name of the element, e.g. "gnomevfssrc" + + + + + + Returns a localised string describing an encoder for the format specified +in @caps, for use in error dialogs or other messages to be seen by the user. +Should never return NULL unless @factory_name or @caps are invalid. +This function is mainly for internal use, applications would typically +use gst_missing_plugin_message_get_description() to get a description of +a missing feature from a missing-plugin message. +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the (fixed) #GstCaps for which an encoder description is needed + + + + + + Returns a localised string describing a sink element handling the protocol +specified in @protocol, for use in error dialogs or other messages to be +seen by the user. Should never return NULL unless @protocol is invalid. +This function is mainly for internal use, applications would typically +use gst_missing_plugin_message_get_description() to get a description of +a missing feature from a missing-plugin message. +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the protocol the sink element needs to handle, e.g. "http" + + + + + + Returns a localised string describing a source element handling the protocol +specified in @protocol, for use in error dialogs or other messages to be +seen by the user. Should never return NULL unless @protocol is invalid. +This function is mainly for internal use, applications would typically +use gst_missing_plugin_message_get_description() to get a description of +a missing feature from a missing-plugin message. +string with g_free() when not needed any longer. + + a newly-allocated description string, or NULL on error. Free + + + + + the protocol the source element needs to handle, e.g. "http" + + + + + + Initialises the base utils support library. This function is not +thread-safe. Applications should call it after calling gst_init(), +plugins should call it from their plugin_init function. +This function may be called multiple times. It will do nothing if the +library has already been initialised. + + + + + + Gets the version number of the GStreamer Plugins Base libraries. + + + + + + pointer to a guint to store the major version number, or %NULL + + + + pointer to a guint to store the minor version number, or %NULL + + + + pointer to a guint to store the micro version number, or %NULL + + + + pointer to a guint to store the nano version number, or %NULL + + + + + + This function returns a string that is useful for describing this version +strings, logging, about dialogs ... + + a newly allocated string describing this version of gst-plugins-base + + + + + diff --git a/unmaintained/gstreamer/pbutils/ffi/ffi.factor b/unmaintained/gstreamer/plugins/pbutils/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/pbutils/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/pbutils/ffi/ffi.factor diff --git a/unmaintained/gstreamer/pbutils/pbutils.factor b/unmaintained/gstreamer/plugins/pbutils/pbutils.factor similarity index 100% rename from unmaintained/gstreamer/pbutils/pbutils.factor rename to unmaintained/gstreamer/plugins/pbutils/pbutils.factor diff --git a/unmaintained/gstreamer/plugins/riff/GstRiff-0.10.gir b/unmaintained/gstreamer/plugins/riff/GstRiff-0.10.gir new file mode 100644 index 0000000000..7e1aa305bb --- /dev/null +++ b/unmaintained/gstreamer/plugins/riff/GstRiff-0.10.gir @@ -0,0 +1,834 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + fourCC codec for this codec. + + + + pointer to the strh stream header structure. + + + + pointer to the strf stream header structure, including any data that is within the range of strf.size, but excluding any additional data withint this chunk but outside strf.size. + + + + a #GstBuffer containing the additional data in the strf chunk outside reach of strf.size. Ususally a palette. + + + + a #GstBuffer containing the data in the strd stream header chunk. Usually codec initialization data. + + + + if given, will be filled with a human-readable codec name. + + + + + + + + + + + Initialize riff library. + + + + + + Reads a single chunk. + + FALSE on error, TRUE otherwise + + + + + caller element (used for debugging). + + + + input buffer. + + + + offset in the buffer in the caller. Is incremented by the read size by this function. + + + + fourcc (returned by this function0 of the chunk. + + + + buffer (returned by the function) containing the chunk data, which may be NULL if chunksize == 0 + + + + + + Reads the first few bytes from the provided buffer, checks +if this stream is a RIFF stream, and determines document type. +This function takes ownership of @buf so it should not be used anymore +after calling this function. +caller should error out; we already throw an error), or TRUE +if it is. + + FALSE if this is not a RIFF stream (in which case the + + + + + caller element (used for debugging/error). + + + + input buffer from which the file header will be parsed, should be at least 12 bytes long. + + + + a fourcc (returned by this function) to indicate the type of document (according to the header). + + + + + + Parses stream metadata from input data. + + + + + + caller element (used for debugging/error). + + + + input data to be used for parsing, stripped from header. + + + + a pointer to a taglist (returned by this function) containing information about this stream. May be NULL if no supported tags were found. + + + + + + Parses an audio stream´s strf structure plus optionally some +extradata from input data. This function takes ownership of @buf. +use. +should be skipped on error, but it is not fatal. + + TRUE if parsing succeeded, otherwise FALSE. The stream + + + + + caller element (used for debugging/error). + + + + input data to be used for parsing, stripped from header. + + + + a pointer (returned by this function) to a filled-in strf/auds structure. Caller should free it. + + + + a pointer (returned by this function) to a buffer containing extradata for this particular stream (e.g. codec initialization data). + + + + + + Parses a interleaved (also known as "complex") stream´s strf +structure plus optionally some extradata from input data. This +function takes ownership of @buf. + + TRUE if parsing succeeded, otherwise FALSE. + + + + + caller element (used for debugging/error). + + + + input data to be used for parsing, stripped from header. + + + + a pointer (returned by this function) to a filled-in strf/iavs structure. Caller should free it. + + + + a pointer (returned by this function) to a buffer containing extradata for this particular stream (e.g. codec initialization data). + + + + + + Parses a video stream´s strf structure plus optionally some +extradata from input data. This function takes ownership of @buf. +should be skipped on error, but it is not fatal. + + TRUE if parsing succeeded, otherwise FALSE. The stream + + + + + caller element (used for debugging/error). + + + + input data to be used for parsing, stripped from header. + + + + a pointer (returned by this function) to a filled-in strf/vids structure. Caller should free it. + + + + a pointer (returned by this function) to a buffer containing extradata for this particular stream (e.g. palette, codec initialization data). + + + + + + Parses a strh structure from input data. Takes ownership of @buf. +should be skipped on error, but it is not fatal. + + TRUE if parsing succeeded, otherwise FALSE. The stream + + + + + caller element (used for debugging/error). + + + + input data to be used for parsing, stripped from header. + + + + a pointer (returned by this function) to a filled-in strh structure. Caller should free it. + + + + + + Reads a single chunk of data. Since 0.10.8 'JUNK' chunks +are skipped automatically. + + flow status. + + + + + caller element (used for debugging). + + + + pad to pull data from. + + + + offset to pull from, incremented by this function. + + + + fourcc of the chunk (returned by this function). + + + + buffer (returned by this function). + + + + + + diff --git a/unmaintained/gstreamer/ffi/ffi.factor b/unmaintained/gstreamer/plugins/riff/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/riff/ffi/ffi.factor diff --git a/unmaintained/gstreamer/riff/riff.factor b/unmaintained/gstreamer/plugins/riff/riff.factor similarity index 100% rename from unmaintained/gstreamer/riff/riff.factor rename to unmaintained/gstreamer/plugins/riff/riff.factor diff --git a/unmaintained/gstreamer/plugins/rtp/GstRtp-0.10.gir b/unmaintained/gstreamer/plugins/rtp/GstRtp-0.10.gir new file mode 100644 index 0000000000..818c907315 --- /dev/null +++ b/unmaintained/gstreamer/plugins/rtp/GstRtp-0.10.gir @@ -0,0 +1,3195 @@ + + + + + + + + + + + + + + + + + + + + Create an RTP buffer and store @payload_len bytes of the adapter as the +payload. Set the timestamp on the new buffer to @timestamp before pushing +the buffer downstream. +If @payload_len is -1, all pending bytes will be flushed. If @timestamp is +-1, the timestamp will be calculated automatically. + + a #GstFlowReturn + + + + + length of payload + + + + a #GstClockTime + + + + + + Gets the internal adapter used by the depayloader. + + a #GstAdapter. + + + + + Create an RTP buffer and store @payload_len bytes of @data as the +payload. Set the timestamp on the new buffer to @timestamp before pushing +the buffer downstream. + + a #GstFlowReturn + + + + + data to set as payload + + + + length of payload + + + + a #GstClockTime + + + + + + Tells #GstBaseRTPAudioPayload that the child element is for a frame based +audio codec + + + + + + Sets the options for frame based audio codecs. + + + + + + The duraction of an audio frame in milliseconds. + + + + The size of an audio frame in bytes. + + + + + + Tells #GstBaseRTPAudioPayload that the child element is for a sample based +audio codec + + + + + + Sets the options for sample based audio codecs. + + + + + + Size per sample in bytes. + + + + + + Sets the options for sample based audio codecs. + + + + + + Size per sample in bits. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Push @out_buf to the peer of @filter. This function takes ownership of +Unlike gst_base_rtp_depayload_push_ts(), this function will not apply +any timestamp on the outgoing buffer. Subclasses should therefore timestamp +outgoing buffers themselves. + + a #GstFlowReturn. + + + + + a #GstBuffer + + + + + + Push @out_list to the peer of @filter. This function takes ownership of + + a #GstFlowReturn. + + + + + a #GstBufferList + + + + + + Push @out_buf to the peer of @filter. This function takes ownership of +Unlike gst_base_rtp_depayload_push(), this function will by default apply +the last incomming timestamp on the outgoing buffer when it didn't have a +timestamp already. The set_get_timestamp vmethod can be overwritten to change +this behaviour (and take, for example, @timestamp into account). + + a #GstFlowReturn. + + + + + an RTP timestamp to apply + + + + a #GstBuffer + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Check if the packet with @size and @duration would exceed the configured +maximum size. +configured MTU or max_ptime. + + %TRUE if the packet of @size and @duration would exceed the + + + + + a #GstBaseRTPPayload + + + + the size of the packet + + + + the duration of the packet + + + + + + Push @buffer to the peer element of the payloader. The SSRC, payload type, +seqnum and timestamp of the RTP buffer will be updated first. +This function takes ownership of @buffer. + + a #GstFlowReturn. + + + + + a #GstBaseRTPPayload + + + + a #GstBuffer + + + + + + Push @list to the peer element of the payloader. The SSRC, payload type, +seqnum and timestamp of the RTP buffer will be updated first. +This function takes ownership of @list. + + a #GstFlowReturn. + + + + + a #GstBaseRTPPayload + + + + a #GstBufferList + + + + + + Set the rtp options of the payloader. These options will be set in the caps +of the payloader. Subclasses must call this method before calling +gst_basertppayload_push() or gst_basertppayload_set_outcaps(). + + + + + + a #GstBaseRTPPayload + + + + the media type (typically "audio" or "video") + + + + if the payload type is dynamic + + + + the encoding name + + + + the clock rate of the media + + + + + + Configure the output caps with the optional parameters. +Variable arguments should be in the form field name, field type +(as a GType), value(s). The last variable argument should be NULL. + + %TRUE if the caps could be set. + + + + + a #GstBaseRTPPayload + + + + the first field name or %NULL + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Different types of feedback messages. + + + + + + + + + Data structure that points to a packet at @offset in @buffer. +The size of the structure is made public to allow stack allocations. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add a new report block to @packet with the given values. +the max MTU is exceeded or the number of report blocks is greater than +#GST_RTCP_MAX_RB_COUNT. + + %TRUE if the packet was created. This function can return %FALSE if + + + + + data source being reported + + + + fraction lost since last SR/RR + + + + the cumululative number of packets lost + + + + the extended last sequence number received + + + + the interarrival jitter + + + + the last SR packet from this source + + + + the delay since last SR packet + + + + + + Add @ssrc to the BYE @packet. +the max MTU is exceeded or the number of sources blocks is greater than +#GST_RTCP_MAX_BYE_SSRC_COUNT. + + %TRUE if the ssrc was added. This function can return %FALSE if + + + + + an SSRC to add + + + + + + Adds @len SSRCs in @ssrc to BYE @packet. +the max MTU is exceeded or the number of sources blocks is greater than +#GST_RTCP_MAX_BYE_SSRC_COUNT. + + %TRUE if the all the SSRCs were added. This function can return %FALSE if + + + + + an array of SSRCs to add + + + + number of elements in @ssrc + + + + + + Get the @nth SSRC of the BYE @packet. + + The @nth SSRC of @packet. + + + + + the nth SSRC to get + + + + + + Get the reason in @packet. +a reason string. The string must be freed with g_free() after usage. + + The reason for the BYE @packet or NULL if the packet did not contain + + + + + Get the length of the reason string. +present. + + The length of the reason string or 0 when there is no reason string + + + + + Get the number of SSRC fields in @packet. + + The number of SSRC fields in @packet. + + + + + Set the reason string to @reason in @packet. + + TRUE if the string could be set. + + + + + a reason string + + + + + + Get the Feedback Control Information attached to a RTPFB or PSFB @packet. + + a pointer to the FCI + + + + + Get the length of the Feedback Control Information attached to a +RTPFB or PSFB @packet. + + The length of the FCI in 32-bit words. + + + + + Get the media SSRC field of the RTPFB or PSFB @packet. + + the media SSRC. + + + + + Get the sender SSRC field of the RTPFB or PSFB @packet. + + the sender SSRC. + + + + + Set the length of the Feedback Control Information attached to a +RTPFB or PSFB @packet. + + %TRUE if there was enough space in the packet to add this much FCI + + + + + Length of the FCI in 32-bit words + + + + + + Set the media SSRC field of the RTPFB or PSFB @packet. + + + + + + a media SSRC + + + + + + Set the sender SSRC field of the RTPFB or PSFB @packet. + + + + + + a sender SSRC + + + + + + Set the feedback message type of the FB @packet. + + + + + + the #GstRTCPFBType to set + + + + + + Get the count field in @packet. +valid packet. + + The count field in @packet or -1 if @packet does not point to a + + + + + Get the length field of @packet. This is the length of the packet in +32-bit words minus one. + + The length field of @packet. + + + + + Get the packet padding of the packet pointed to by @packet. + + If the packet has the padding bit set. + + + + + Parse the values of the @nth report block in @packet and store the result in +the values. + + + + + + the nth report block in @packet + + + + result for data source being reported + + + + result for fraction lost since last SR/RR + + + + result for the cumululative number of packets lost + + + + result for the extended last sequence number received + + + + result for the interarrival jitter + + + + result for the last SR packet from this source + + + + result for the delay since last SR packet + + + + + + Get the number of report blocks in @packet. + + The number of report blocks in @packet. + + + + + Move the packet pointer @packet to the next packet in the payload. +Use gst_rtcp_buffer_get_first_packet() to initialize @packet. +function. + + TRUE if @packet is pointing to a valid packet after calling this + + + + + Removes the packet pointed to by @packet and moves pointer to the next one +function. + + TRUE if @packet is pointing to a valid packet after calling this + + + + + Get the ssrc field of the RR @packet. + + the ssrc. + + + + + Set the ssrc field of the RR @packet. + + + + + + the SSRC to set + + + + + + Add a new SDES entry to the current item in @packet. +reached. + + %TRUE if the item could be added, %FALSE if the MTU has been + + + + + the #GstRTCPSDESType of the SDES entry + + + + the data length + + + + the data + + + + + + Add a new SDES item for @ssrc to @packet. +items has been exceeded for the SDES packet or the MTU has been reached. + + %TRUE if the item could be added, %FALSE if the maximum amount of + + + + + the SSRC of the new item to add + + + + + + This function is like gst_rtcp_packet_sdes_get_entry() but it returns a +null-terminated copy of the data instead. use g_free() after usage. + + %TRUE if there was valid data. + + + + + result of the entry type + + + + result length of the entry data + + + + result entry data + + + + + + Move to the first SDES entry in the current item. + + %TRUE if there was a first entry. + + + + + Move to the first SDES item in @packet. + + TRUE if there was a first item. + + + + + Get the data of the current SDES item entry. @type (when not NULL) will +contain the type of the entry. @data (when not NULL) will point to @len +bytes. +When @type refers to a text item, @data will point to a UTF8 string. Note +that this UTF8 string is NOT null-terminated. Use +gst_rtcp_packet_sdes_copy_entry() to get a null-termined copy of the entry. + + %TRUE if there was valid data. + + + + + result of the entry type + + + + result length of the entry data + + + + result entry data + + + + + + Get the number of items in the SDES packet @packet. + + The number of items in @packet. + + + + + Get the SSRC of the current SDES item. + + the SSRC of the current item. + + + + + Move to the next SDES entry in the current item. + + %TRUE if there was a next entry. + + + + + Move to the next SDES item in @packet. + + TRUE if there was a next item. + + + + + Set the @nth new report block in @packet with the given values. + + + + + + the nth report block to set + + + + data source being reported + + + + fraction lost since last SR/RR + + + + the cumululative number of packets lost + + + + the extended last sequence number received + + + + the interarrival jitter + + + + the last SR packet from this source + + + + the delay since last SR packet + + + + + + Parse the SR sender info and store the values. + + + + + + result SSRC + + + + result NTP time + + + + result RTP time + + + + result packet count + + + + result octect count + + + + + + Set the given values in the SR packet @packet. + + + + + + the SSRC + + + + the NTP time + + + + the RTP time + + + + the packet count + + + + the octect count + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Structure holding default payload type information. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add a new packet of @type to @buffer. @packet will point to the newly created +packet. +if the max mtu is exceeded for the buffer. + + %TRUE if the packet could be created. This function returns %FALSE + + + + + a valid RTCP buffer + + + + the #GstRTCPType of the new packet + + + + pointer to new packet + + + + + + Finish @buffer after being constructured. This function is usually called +after gst_rtcp_buffer_new() and after adding the RTCP items to the new buffer. +The function adjusts the size of @buffer with the total length of all the +added packets. + + + + + + a buffer with an RTCP packet + + + + + + Initialize a new #GstRTCPPacket pointer that points to the first packet in + + TRUE if the packet existed in @buffer. + + + + + a valid RTCP buffer + + + + a #GstRTCPPacket + + + + + + Get the number of RTCP packets in @buffer. + + the number of RTCP packets in @buffer. + + + + + a valid RTCP buffer + + + + + + Create a new buffer for constructing RTCP packets. The packet will have a +maximum size of @mtu. + + A newly allocated buffer. + + + + + the maximum mtu size. + + + + + + Create a new buffer and set the data to a copy of @len +bytes of @data and the size to @len. The data will be freed when the buffer +is freed. + + A newly allocated buffer with a copy of @data and of size @len. + + + + + data for the new buffer + + + + the length of data + + + + + + Create a new buffer and set the data and size of the buffer to @data and @len +respectively. @data will be freed when the buffer is unreffed, so this +function transfers ownership of @data to the new buffer. + + A newly allocated buffer with @data and of size @len. + + + + + data for the new buffer + + + + the length of data + + + + + + Check if the data pointed to by @buffer is a valid RTCP packet using +gst_rtcp_buffer_validate_data(). + + TRUE if @buffer is a valid RTCP packet. + + + + + the buffer to validate + + + + + + Check if the @data and @size point to the data of a valid RTCP (compound) +packet. +Use this function to validate a packet before using the other functions in +this module. + + TRUE if the data points to a valid RTCP packet. + + + + + the data to validate + + + + the length of @data to validate + + + + + + Converts an NTP time to UNIX nanoseconds. @ntptime can typically be +the NTP time of an SR RTCP message and contains, in the upper 32 bits, the +number of seconds since 1900 and, in the lower 32 bits, the fractional +seconds. The resulting value will be the number of nanoseconds since 1970. + + the UNIX time for @ntptime in nanoseconds. + + + + + an NTP timestamp + + + + + + Get the feedback message type of the FB @packet. + + The feedback message type. + + + + + a valid RTPFB or PSFB #GstRTCPPacket + + + + + + Get the packet type of the packet pointed to by @packet. +pointing to a valid packet. + + The packet type or GST_RTCP_TYPE_INVALID when @packet is not + + + + + a valid #GstRTCPPacket + + + + + + Convert @name into a @GstRTCPSDESType. @name is typically a key in a +#GstStructure containing SDES items. +is a private sdes item. + + the #GstRTCPSDESType for @name or #GST_RTCP_SDES_PRIV when @name + + + + + a SDES name + + + + + + Converts @type to the string equivalent. The string is typically used as a +key in a #GstStructure containing SDES items. + + the string equivalent of @type + + + + + a #GstRTCPSDESType + + + + + + Converts a UNIX timestamp in nanoseconds to an NTP time. The caller should +pass a value with nanoseconds since 1970. The NTP time will, in the upper +32 bits, contain the number of seconds since 1900 and, in the lower 32 +bits, the fractional seconds. The resulting value can be used as an ntptime +for constructing SR RTCP packets. + + the NTP time for @unixtime. + + + + + an UNIX timestamp in nanoseconds + + + + + + Adds a RFC 5285 header extension with a one byte header to the end of the +RTP header. If there is already a RFC 5285 header extension with a one byte +header, the new extension will be appended. +It will not work if there is already a header extension that does not follow +the mecanism described in RFC 5285 or if there is a header extension with +a two bytes header as described in RFC 5285. In that case, use +gst_rtp_buffer_add_extension_twobytes_header() + + %TRUE if header extension could be added + + + + + the buffer + + + + The ID of the header extension (between 1 and 14). + + + + location for data + + + + the size of the data in bytes + + + + + + Adds a RFC 5285 header extension with a two bytes header to the end of the +RTP header. If there is already a RFC 5285 header extension with a two bytes +header, the new extension will be appended. +It will not work if there is already a header extension that does not follow +the mecanism described in RFC 5285 or if there is a header extension with +a one byte header as described in RFC 5285. In that case, use +gst_rtp_buffer_add_extension_onebyte_header() + + %TRUE if header extension could be added + + + + + the buffer + + + + Application specific bits + + + + The ID of the header extension + + + + location for data + + + + the size of the data in bytes + + + + + + Allocate enough data in @buffer to hold an RTP packet with @csrc_count CSRCs, +a payload length of @payload_len and padding of @pad_len. +MALLOCDATA of @buffer will be overwritten and will not be freed. +All other RTP header fields will be set to 0/FALSE. + + + + + + a #GstBuffer + + + + the length of the payload + + + + the amount of padding + + + + the number of CSRC entries + + + + + + Calculate the header length of an RTP packet with @csrc_count CSRC entries. +An RTP packet can have at most 15 CSRC entries. + + The length of an RTP header with @csrc_count CSRC entries. + + + + + the number of CSRC entries + + + + + + Calculate the total length of an RTP packet with a payload size of @payload_len, +a padding of @pad_len and a @csrc_count CSRC entries. + + The total length of an RTP header with given parameters. + + + + + the length of the payload + + + + the amount of padding + + + + the number of CSRC entries + + + + + + Calculate the length of the payload of an RTP packet with size @packet_len, +a padding of @pad_len and a @csrc_count CSRC entries. + + The length of the payload of an RTP packet with given parameters. + + + + + the length of the total RTP packet + + + + the amount of padding + + + + the number of CSRC entries + + + + + + Compare two sequence numbers, taking care of wraparounds. This function +returns the difference between @seqnum1 and @seqnum2. +are equal or a positive value if @seqnum1 is smaller than @segnum2. + + a negative value if @seqnum1 is bigger than @seqnum2, 0 if they + + + + + a sequence number + + + + a sequence number + + + + + + Get the default clock-rate for the static payload type @payload_type. +the clock-rate is undefined. + + the default clock rate or -1 if the payload type is not static or + + + + + the static payload type + + + + + + Update the @exttimestamp field with @timestamp. For the first call of the +method, @exttimestamp should point to a location with a value of -1. +This function makes sure that the returned value is a constantly increasing +value even in the case where there is a timestamp wraparound. + + The extended timestamp of @timestamp. + + + + + a previous extended timestamp + + + + a new timestamp + + + + + + Get the CSRC at index @idx in @buffer. + + the CSRC at index @idx in host order. + + + + + the buffer + + + + the index of the CSRC to get + + + + + + Get the CSRC count of the RTP packet in @buffer. + + the CSRC count of @buffer. + + + + + the buffer + + + + + + Check if the extension bit is set on the RTP packet in @buffer. + + TRUE if @buffer has the extension bit set. + + + + + the buffer + + + + + + Get the extension data. @bits will contain the extension 16 bits of custom +data. @data will point to the data in the extension and @wordlen will contain +the length of @data in 32 bits words. +If @buffer did not contain an extension, this function will return %FALSE +with @bits, @data and @wordlen unchanged. + + TRUE if @buffer had the extension bit set. + + + + + the buffer + + + + location for result bits + + + + location for data + + + + location for length of @data in 32 bits words + + + + + + Parses RFC 5285 style header extensions with a one byte header. It will +return the nth extension with the requested id. + + TRUE if @buffer had the requested header extension + + + + + the buffer + + + + The ID of the header extension to be read (between 1 and 14). + + + + Read the nth extension packet with the requested ID + + + + location for data + + + + the size of the data in bytes + + + + + + Parses RFC 5285 style header extensions with a two bytes header. It will +return the nth extension with the requested id. + + TRUE if @buffer had the requested header extension + + + + + the buffer + + + + Application specific bits + + + + The ID of the header extension to be read (between 1 and 14). + + + + Read the nth extension packet with the requested ID + + + + location for data + + + + the size of the data in bytes + + + + + + Return the total length of the header in @buffer. This include the length of +the fixed header, the CSRC list and the extension header. + + The total length of the header in @buffer. + + + + + the buffer + + + + + + Check if the marker bit is set on the RTP packet in @buffer. + + TRUE if @buffer has the marker bit set. + + + + + the buffer + + + + + + Return the total length of the packet in @buffer. + + The total length of the packet in @buffer. + + + + + the buffer + + + + + + Check if the padding bit is set on the RTP packet in @buffer. + + TRUE if @buffer has the padding bit set. + + + + + the buffer + + + + + + Get a pointer to the payload data in @buffer. This pointer is valid as long +as a reference to @buffer is held. + + A pointer to the payload data in @buffer. + + + + + the buffer + + + + + + Create a buffer of the payload of the RTP packet in @buffer. This function +will internally create a subbuffer of @buffer so that a memcpy can be +avoided. + + A new buffer with the data of the payload. + + + + + the buffer + + + + + + Get the length of the payload of the RTP packet in @buffer. + + The length of the payload in @buffer. + + + + + the buffer + + + + + + Create a subbuffer of the payload of the RTP packet in @buffer. @offset bytes +are skipped in the payload and the subbuffer will be of size @len. +If @len is -1 the total payload starting from @offset if subbuffered. + + A new buffer with the specified data of the payload. + + + + + the buffer + + + + the offset in the payload + + + + the length in the payload + + + + + + Get the payload type of the RTP packet in @buffer. + + The payload type. + + + + + the buffer + + + + + + Get the sequence number of the RTP packet in @buffer. + + The sequence number in host order. + + + + + the buffer + + + + + + Get the SSRC of the RTP packet in @buffer. + + the SSRC of @buffer in host order. + + + + + the buffer + + + + + + Get the timestamp of the RTP packet in @buffer. + + The timestamp in host order. + + + + + the buffer + + + + + + Get the version number of the RTP packet in @buffer. + + The version of @buffer. + + + + + the buffer + + + + + + Adds a RFC 5285 header extension with a one byte header to the end of the +RTP header. If there is already a RFC 5285 header extension with a one byte +header, the new extension will be appended. +It will not work if there is already a header extension that does not follow +the mecanism described in RFC 5285 or if there is a header extension with +a two bytes header as described in RFC 5285. In that case, use +gst_rtp_buffer_list_add_extension_twobytes_header() +This function will not modify the data section of the RTP buffer, only +the header. + + %TRUE if header extension could be added + + + + + a #GstBufferListIterator pointing right after the #GstBuffer where the header extension should be added + + + + The ID of the header extension (between 1 and 14). + + + + location for data + + + + the size of the data in bytes + + + + + + Adds a RFC 5285 header extension with a two bytes header to the end of the +RTP header. If there is already a RFC 5285 header extension with a two bytes +header, the new extension will be appended. +It will not work if there is already a header extension that does not follow +the mecanism described in RFC 5285 or if there is a header extension with +a one byte header as described in RFC 5285. In that case, use +gst_rtp_buffer_add_extension_onebyte_header() +This function will not modify the data section of the RTP buffer, only +the header. + + %TRUE if header extension could be added + + + + + a #GstBufferListIterator pointing right after the #GstBuffer where the header extension should be added + + + + Application specific bits + + + + The ID of the header extension + + + + location for data + + + + the size of the data in bytes + + + + + + Splits a #GstBuffer into a #GstBufferList containing separate +buffers for the header and data sections. + + a #GstBufferList + + + + + a #GstBuffer containing a RTP packet + + + + + + Parses RFC 5285 style header extensions with a one byte header. It will +return the nth extension with the requested id. + + TRUE if @buffer had the requested header extension + + + + + the bufferlist + + + + The index of the group in the #GstBufferList + + + + The ID of the header extension to be read (between 1 and 14). + + + + Read the nth extension packet with the requested ID + + + + location for data + + + + the size of the data in bytes + + + + + + Parses RFC 5285 style header extensions with a two bytes header. It will +return the nth extension with the requested id. + + TRUE if @buffer had the requested header extension + + + + + the bufferlist + + + + The index of the group in the #GstBufferList + + + + Application specific bits + + + + The ID of the header extension to be read (between 1 and 14). + + + + Read the nth extension packet with the requested ID + + + + location for data + + + + the size of the data in bytes + + + + + + Get the length of the payload of the RTP packet in @list. + + The length of the payload in @list. + + + + + the buffer list + + + + + + Get the payload type of the first RTP packet in @list. +All packets in @list should have the same payload type. + + The payload type. + + + + + the buffer list + + + + + + Get the sequence number of the first RTP packet in @list. +All packets within @list have the same sequence number. + + The seq number + + + + + the buffer list + + + + + + Get the SSRC of the first RTP packet in @list. +All RTP packets within @list have the same SSRC. + + the SSRC of @list in host order. + + + + + the buffer list + + + + + + Get the timestamp of the first RTP packet in @list. +All packets within @list have the same timestamp. + + The timestamp in host order. + + + + + the buffer list + + + + + + Set the payload type of each RTP packet in @list to @payload_type. + + + + + + the buffer list + + + + the new type + + + + + + Set the sequence number of each RTP packet in @list to @seq. + + The seq number of the last packet in the list + 1. + + + + + the buffer list + + + + the new sequence number + + + + + + Set the SSRC on each RTP packet in @list to @ssrc. + + + + + + the buffer list + + + + the new SSRC + + + + + + Set the timestamp of each RTP packet in @list to @timestamp. + + + + + + the buffer list + + + + the new timestamp + + + + + + Check if all RTP packets in the @list are valid using validate_data(). +Use this function to validate an list before using the other functions in +this module. + + TRUE if @list consists only of valid RTP packets. + + + + + the buffer list to validate + + + + + + Allocate a new #GstBuffer with enough data to hold an RTP packet with +All other RTP header fields will be set to 0/FALSE. +parameters. + + A newly allocated buffer that can hold an RTP packet with given + + + + + the length of the payload + + + + the amount of padding + + + + the number of CSRC entries + + + + + + Create a new #GstBuffer that can hold an RTP packet that is exactly +All RTP header fields will be set to 0/FALSE. + + A newly allocated buffer that can hold an RTP packet of @packet_len. + + + + + the total length of the packet + + + + the amount of padding + + + + the number of CSRC entries + + + + + + Create a new buffer and set the data to a copy of @len +bytes of @data and the size to @len. The data will be freed when the buffer +is freed. + + A newly allocated buffer with a copy of @data and of size @len. + + + + + data for the new buffer + + + + the length of data + + + + + + Create a new buffer and set the data and size of the buffer to @data and @len +respectively. @data will be freed when the buffer is unreffed, so this +function transfers ownership of @data to the new buffer. + + A newly allocated buffer with @data and of size @len. + + + + + data for the new buffer + + + + the length of data + + + + + + Set the amount of padding in the RTP packet in @buffer to + + + + + + the buffer + + + + the new amount of padding + + + + + + Modify the CSRC at index @idx in @buffer to @csrc. + + + + + + the buffer + + + + the CSRC index to set + + + + the CSRC in host order to set at @idx + + + + + + Set the extension bit on the RTP packet in @buffer to @extension. + + + + + + the buffer + + + + the new extension + + + + + + Set the extension bit of the rtp buffer and fill in the @bits and @length of the +extension header. It will refuse to set the extension data if the buffer is not +large enough. + + True if done. + + + + + the buffer + + + + the bits specific for the extension + + + + the length that counts the number of 32-bit words in the extension, excluding the extension header ( therefore zero is a valid length) + + + + + + Set the marker bit on the RTP packet in @buffer to @marker. + + + + + + the buffer + + + + the new marker + + + + + + Set the total @buffer size to @len. The data in the buffer will be made +larger if needed. Any padding will be removed from the packet. + + + + + + the buffer + + + + the new packet length + + + + + + Set the padding bit on the RTP packet in @buffer to @padding. + + + + + + the buffer + + + + the new padding + + + + + + Set the payload type of the RTP packet in @buffer to @payload_type. + + + + + + the buffer + + + + the new type + + + + + + Set the sequence number of the RTP packet in @buffer to @seq. + + + + + + the buffer + + + + the new sequence number + + + + + + Set the SSRC on the RTP packet in @buffer to @ssrc. + + + + + + the buffer + + + + the new SSRC + + + + + + Set the timestamp of the RTP packet in @buffer to @timestamp. + + + + + + the buffer + + + + the new timestamp + + + + + + Set the version of the RTP packet in @buffer to @version. + + + + + + the buffer + + + + the new version + + + + + + Check if the data pointed to by @buffer is a valid RTP packet using +validate_data(). +Use this function to validate a packet before using the other functions in +this module. + + TRUE if @buffer is a valid RTP packet. + + + + + the buffer to validate + + + + + + Check if the @data and @size point to the data of a valid RTP packet. +This function checks the length, version and padding of the packet data. +Use this function to validate a packet before using the other functions in +this module. + + TRUE if the data points to a valid RTP packet. + + + + + the data to validate + + + + the length of @data to validate + + + + + + Get the #GstRTPPayloadInfo for @media and @encoding_name. This function is +mostly used to get the default clock-rate and bandwidth for dynamic payload +types specified with @media and @encoding name. +The search for @encoding_name will be performed in a case insensitve way. + + a #GstRTPPayloadInfo or NULL when no info could be found. + + + + + the media to find + + + + the encoding name to find + + + + + + Get the #GstRTPPayloadInfo for @payload_type. This function is +mostly used to get the default clock-rate and bandwidth for static payload +types specified with @payload_type. + + a #GstRTPPayloadInfo or NULL when no info could be found. + + + + + the payload_type to find + + + + + + diff --git a/unmaintained/gstreamer/rtp/ffi/ffi.factor b/unmaintained/gstreamer/plugins/rtp/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/rtp/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/rtp/ffi/ffi.factor diff --git a/unmaintained/gstreamer/rtp/rtp.factor b/unmaintained/gstreamer/plugins/rtp/rtp.factor similarity index 100% rename from unmaintained/gstreamer/rtp/rtp.factor rename to unmaintained/gstreamer/plugins/rtp/rtp.factor diff --git a/unmaintained/gstreamer/rtsp/GstRtsp-0.10.gir b/unmaintained/gstreamer/plugins/rtsp/GstRtsp-0.10.gir similarity index 62% rename from unmaintained/gstreamer/rtsp/GstRtsp-0.10.gir rename to unmaintained/gstreamer/plugins/rtsp/GstRtsp-0.10.gir index b0cf681543..51ddff4034 100644 --- a/unmaintained/gstreamer/rtsp/GstRtsp-0.10.gir +++ b/unmaintained/gstreamer/plugins/rtsp/GstRtsp-0.10.gir @@ -2,7 +2,7 @@ - @@ -12,8 +12,7 @@ and/or use gtk-doc annotations. --> - - + @@ -26,15 +25,13 @@ and/or use gtk-doc annotations. --> - - - + c:identifier-prefixes="Gst" + c:symbol-prefixes="gst"> + Authentication methods, ordered by strength c:identifier="GST_RTSP_AUTH_DIGEST" glib:nick="digest"/> - - + Opaque RTSP connection object. + + Clear the list of authentication directives stored in @conn. + + + + + + Close the connected @conn. After this call, the connection is in the same +state as when it was first created. + + #GST_RTSP_OK on success. + + + + + Attempt to connect to the url of @conn made with gst_rtsp_connection_create(). If @timeout is #NULL this function can block forever. If @timeout contains a valid timeout, this function will return #GST_RTSP_ETIMEOUT after the timeout expired. -This function can be cancelled with gst_rtsp_connection_flush()."> - +This function can be cancelled with gst_rtsp_connection_flush(). + + #GST_RTSP_OK when a connection could be made. + a #GTimeVal timeout - - - - - - - - - - - - + + If @conn received the first tunnel connection and @conn2 received +the second tunnel connection, link the two connections together so that +After this call, @conn2 cannot be used anymore and must be freed with +gst_rtsp_connection_free(). +If @conn2 is %NULL then only the base64 decoding context will be setup for + + return GST_RTSP_OK on success. - - - - - - - - - - + + a #GstRTSPConnection or %NULL + - - + + Start or stop the flushing action on @conn. When flushing, all current +and future actions on @conn will return #GST_RTSP_EINTR until the connection +is set to non-flushing mode again. + + #GST_RTSP_OK. - - - - - - - - - - + + start or stop the flush + - - + + Close and free @conn. + + #GST_RTSP_OK on success. - - - - - - - - - + + Retrieve the IP address of the other end of @conn. +connection is closed. + + The IP address as a string. this value remains valid until the + + + + + Get the file descriptor for reading. +descriptor remains valid until the connection is closed. + + the file descriptor used for reading or -1 on error. The file + + + + + Get the tunnel session id the connection. + + returns a non-empty string if @conn is being tunneled over HTTP. + + + + + Retrieve the URL of the other end of @conn. +connection is freed. + The URL. This value remains valid until the + + + + + Get the file descriptor for writing. +descriptor remains valid until the connection is closed. + + the file descriptor used for writing or -1 on error. The file + + + + + Get the tunneling state of the connection. + + if @conn is using HTTP tunneling. + + + + + Calculate the next timeout for @conn, storing the result in @timeout. + + #GST_RTSP_OK. - - - + a timeout + Wait up to the specified @timeout for the connection to become available for at least one of the operations specified in @events. When the function returns with #GST_RTSP_OK, @revents will contain a bitmask of available operations on -This function can be cancelled with gst_rtsp_connection_flush()." - version="0.10.15"> - +This function can be cancelled with gst_rtsp_connection_flush(). + + #GST_RTSP_OK on success. + a bitmask of #GstRTSPEvent flags to check + location for result flags + a timeout - - + + Attempt to read @size bytes into @data from the connected @conn, blocking up to +the specified @timeout. @timeout can be #NULL, in which case this function +might block forever. +This function can be cancelled with gst_rtsp_connection_flush(). + + #GST_RTSP_OK on success. + + the data to read + + + + the size of @data + + + a timeout value or #NULL + + + + + + Attempt to read into @message from the connected @conn, blocking up to +the specified @timeout. @timeout can be #NULL, in which case this function +might block forever. +This function can be cancelled with gst_rtsp_connection_flush(). + + #GST_RTSP_OK on success. + + + + + the message to read + + + + a timeout value or #NULL - + c:identifier="gst_rtsp_connection_reset_timeout"> + Reset the timeout of @conn. + + #GST_RTSP_OK. - - + + Attempt to send @message to the connected @conn, blocking up to +the specified @timeout. @timeout can be #NULL, in which case this function +might block forever. +This function can be cancelled with gst_rtsp_connection_flush(). + + #GST_RTSP_OK on success. - - + + the message to send + + + + a timeout value or #NULL + - - - - - - - - - - - - - - - + + Configure @conn for authentication mode @method with @user and @pass as the +user and password respectively. + + #GST_RTSP_OK. + authentication method + the user + the password + Setup @conn with authentication directives. This is not necesary for methods #GST_RTSP_AUTH_NONE and #GST_RTSP_AUTH_BASIC. For #GST_RTSP_AUTH_DIGEST, directives should be taken from the digest challenge in the WWW-Authenticate response header and can include realm, domain, -nonce, opaque, stale, algorithm, qop as per RFC2617." - version="0.10.20"> +nonce, opaque, stale, algorithm, qop as per RFC2617. + authentication directive + value - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + By setting the HTTP mode to %TRUE the message parsing will support HTTP +messages in addition to the RTSP messages. It will also disable the +automatic handling of setting up an HTTP tunnel. - + %TRUE to enable manual HTTP mode + + + + + + Set the IP address of the server. + + + + + + an ip address + + + + + + Set the proxy host and port. + + #GST_RTSP_OK. + + + + + the proxy host + + + + the proxy port + + + + + + Configure @conn to use the specified DSCP value. + + #GST_RTSP_OK on success. + + + + + DSCP value + + Set the HTTP tunneling state of the connection. This must be configured before +the @conn is connected. - + the new state + - + + Attempt to write @size bytes of @data to the connected @conn, blocking up to +the specified @timeout. @timeout can be #NULL, in which case this function +might block forever. +This function can be cancelled with gst_rtsp_connection_flush(). - - - - - - - - - - + #GST_RTSP_OK on success. - - + + the data to write + + + + the size of @data + + + + a timeout value or #NULL + + The possible events for the connection. - + - + + + + - + @@ -446,21 +482,41 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - - + + + - - + + + + + + + + + + + + + + + + + + + + + + - + @@ -472,53 +528,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -527,19 +538,41 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - + - + + + + + + + + + + + + + + + + + + + + + + + + - + @@ -548,21 +581,44 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - - + + + - - + + + + + + + + + + + + + + + + + + + + + + - + @@ -574,57 +630,9 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -634,7 +642,7 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - + @@ -646,16 +654,37 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + + + + + + + + + + + + + + + + + + + + + - + - + @@ -667,9 +696,9 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - + - + @@ -682,8 +711,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -697,8 +726,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -715,8 +744,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -733,8 +762,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -748,9 +777,9 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - + - + @@ -763,8 +792,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -775,16 +804,14 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - - + - - + + @@ -798,8 +825,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -816,8 +843,8 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - - + + @@ -832,15 +859,15 @@ If @conn2 is %NULL then only the base64 decoding context will be setup for" - + + The possible network families. + The different transport methods. - + + An RTSP message containing request, response or data messages. Depending on +the @type, the appropriate structure may be accessed. @@ -1241,384 +1267,339 @@ the @type, the appropriate structure may be accessed."> - + - + + + - + - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Add a header with key @field and @value to @msg. This function takes a copy +of @value. + + a #GstRTSPResult. + a #GstRTSPHeaderField + the value of the header + + Append the currently configured headers in @msg to the #GString @str suitable +for transmission. + + #GST_RTSP_OK. + + + + + a string + + + + + + Dump the contents of @msg to stdout. + + #GST_RTSP_OK. + + + + + Free the memory used by @msg. + + a #GstRTSPResult. + + + + + Get the body of @msg. @data remains valid for as long as @msg is valid and +unchanged. + + #GST_RTSP_OK. + + + + + location for the data + + + + location for the size of @data + + + + + + Get the @indx header value with key @field from @msg. The result in @value +stays valid as long as it remains present in @msg. +was not found. + + #GST_RTSP_OK when @field was found, #GST_RTSP_ENOTIMPL if the key + + + + + a #GstRTSPHeaderField + + + + pointer to hold the result + + + + the index of the header + + + + + + Initialize @msg. This function is mostly used when @msg is allocated on the +stack. The reverse operation of this is gst_rtsp_message_unset(). + + a #GstRTSPResult. + + + + + Initialize a new data #GstRTSPMessage for @channel. + + a #GstRTSPResult. + + + + + a channel + + + + + + Initialize @msg as a request message with @method and @uri. To clear @msg +again, use gst_rtsp_message_unset(). + + a #GstRTSPResult. + + + + + the request method to use + + + + the uri of the request + + + + + + Initialize @msg with @code and @reason. +When @reason is #NULL, the default reason for @code will be used. +When @request is not #NULL, the relevant headers will be copied to the new +response message. + + a #GstRTSPResult. + + + + + the status code + + + + the status reason or #NULL + + + + the request that triggered the response or #NULL + + + + + + Parse the data message @msg and store the channel in @channel. + + a #GstRTSPResult. + + + + + location to hold the channel + + + + + + Parse the request message @msg and store the values @method, @uri and +value. + + a #GstRTSPResult. + + + + + location to hold the method + + + + location to hold the uri + + + + location to hold the version + + + + + + Parse the response message @msg and store the values @code, @reason and +value. + + a #GstRTSPResult. + + + + + location to hold the status code + + + + location to hold the status reason + + + + location to hold the version + + + + + + Remove the @indx header with key @field from @msg. If @indx equals -1, all +headers will be removed. + + a #GstRTSPResult. + + + + + a #GstRTSPHeaderField + + + + the index of the header + + + + + + Set the body of @msg to a copy of @data. + + #GST_RTSP_OK. + + + + + the data + + + + the size of @data + + + + + + Take the body of @msg and store it in @data and @size. After this method, +the body and size of @msg will be set to #NULL and 0 respectively. + + #GST_RTSP_OK. + + + + + location for the data + + + + location for the size of @data + + + + + + Set the body of @msg to @data and @size. This method takes ownership of + + #GST_RTSP_OK. + + + + + the data + + + + the size of @data + + + + - + Add a header with key @field and @value to @msg. This function takes +ownership of @value. + + a #GstRTSPResult. + a #GstRTSPHeaderField - + + the value of the header - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Unset the contents of @msg so that it becomes an uninitialized +#GstRTSPMessage again. This function is mostly used in combination with +gst_rtsp_message_init_request(), gst_rtsp_message_init_response() and +gst_rtsp_message_init_data() on stack allocated #GstRTSPMessage structures. + + #GST_RTSP_OK. + The different supported RTSP methods. c:identifier="GST_RTSP_POST" glib:nick="post"/> - + + The type of a message. @@ -1696,28 +1676,25 @@ the body and size of @msg will be set to #NULL and 0 respectively."> c:identifier="GST_RTSP_MESSAGE_HTTP_RESPONSE"/> - + + The transfer profile to use. - + + A type to specify a range. - + - + - + + Different possible time range units. + Result codes from the RTSP functions. glib:nick="elast"/> + The different RTSP states. c:identifier="GST_RTSP_STS_OPTION_NOT_SUPPORTED" glib:nick="option-not-supported"/> - + + A time indication. - + - + + A time range. @@ -2037,21 +2016,20 @@ the body and size of @msg will be set to #NULL and 0 respectively."> - + + Possible time types. - + + The transfer mode to use. - + + A structure holding the RTSP transport values. @@ -2068,22 +2046,22 @@ the body and size of @msg will be set to #NULL and 0 respectively."> - + - + - + - + - + @@ -2095,14 +2073,38 @@ the body and size of @msg will be set to #NULL and 0 respectively."> - + + + Convert @transport into a string that can be used to signal the transport in +an RTSP SETUP response. +is invalid. + + a string describing the RTSP transport or #NULL when the transport + + + + + Free the memory used by @transport. + + #GST_RTSP_OK. + + + + + Initialize @transport so that it can be used. + + #GST_RTSP_OK. + + + + glib:get-type="gst_rtsp_url_get_type" + c:symbol-prefix="rtsp_url"> + This structure contains the result of a parsed RTSP URL @@ -2119,7 +2121,7 @@ the body and size of @msg will be set to #NULL and 0 respectively."> - + @@ -2127,58 +2129,79 @@ the body and size of @msg will be set to #NULL and 0 respectively."> - - + + Make a copy of @url. + + a copy of @url. Free with gst_rtsp_url_free () after usage. - + + Splits the path of @url on '/' boundaries, decoding the resulting components, +The decoding performed by this routine is "URI decoding", as defined in RFC +3986, commonly known as percent-decoding. For example, a string "foo%2fbar" +will decode to "foo/bar" -- the %2f being replaced by the corresponding byte +with hex value 0x2f. Note that there is no guarantee that the resulting byte +sequence is valid in any given encoding. As a special case, %00 is not +unescaped to NUL, as that would prematurely terminate the string. +Also note that since paths usually start with a slash, the first component +will usually be the empty string. + + a string vector. g_strfreev() after usage. + + + + + + + Free the memory used by @url. - - - - - - - + + Get the port number of @url. + + #GST_RTSP_OK. - + location to hold the port + - + + Get a newly allocated string describing the request URI for @url. + a string with the request URI. g_free() after usage. + + + + + Set the port number in @url to @port. + + #GST_RTSP_OK. - - + + the port + + The supported RTSP versions. c:identifier="GST_RTSP_VERSION_1_1" glib:nick="1-1"/> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + Opaque RTSP watch object that can be used for asynchronous RTSP +operations. - - + Adds a #GstRTSPWatch to a context so that it will be executed within that context. + + the ID (greater than 0) for the watch within the GMainContext. + + a GMainContext (if NULL, the default context will be used) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + Queue @data for transmission in @watch. It will be transmitted when the connection of the @watch becomes writable. This function will take ownership of @data and g_free() it after use. The return value of this function will be used as the id argument in the -message_sent callback." - version="0.10.24" - deprecated="Use gst_rtsp_watch_write_data()"> +message_sent callback. - + an id. + - - - + the data to queue + - + the size of @data + + Queue a @message for transmission in @watch. The contents of this +message will be serialized and transmitted when the connection of the +The return value of this function will be used as the id argument in the +message_sent callback. - + an id. + + a #GstRTSPMessage + + Reset @watch, this is usually called after gst_rtsp_connection_do_tunnel() +when the file descriptors of the connection might have changed. + + + + + + Send a @message using the connection of the @watch. If it cannot be sent +immediately, it will be queued for transmission in @watch. The contents of +callback. + + #GST_RTSP_OK on success. + + + + + a #GstRTSPMessage + + + + location for a message ID or %NULL + + + + + + Decreases the reference count of @watch by one. If the resulting reference +count is zero the watch and associated memory will be destroyed. + + + + + + Write @data using the connection of the @watch. If it cannot be sent +immediately, it will be queued for transmission in @watch. The contents of +callback. +This function will take ownership of @data and g_free() it after use. + + #GST_RTSP_OK on success. + + + + + the data to queue + + + + the size of @data + + + + location for a message ID or %NULL + + + + - + + Callback functions from a #GstRTSPWatch. - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + - + - + + + + deprecated="use g_base64_decode_inplace() instead."> + Decode the base64 string pointed to by @data in-place. When @len is not #NULL +it will contain the length of the decoded data. - + + the base64 encoded data - - + + location for output length or NULL + - + Encode a sequence of binary data into its Base-64 stringified representation. +representing @data. + a newly allocated, zero-terminated Base-64 encoded string + the binary data to encode - + the length of @data + - - + Accept a new connection on @sock and create a new #GstRTSPConnection for +handling communication on new socket. + + #GST_RTSP_OK when @conn contains a valid connection. - + a socket + + storage for a #GstRTSPConnection - + Create a newly allocated #GstRTSPConnection from @url and store it in @conn. The connection will not yet attempt to connect to @url, use gst_rtsp_connection_connect(). -A copy of @url will be made."> - +A copy of @url will be made. + + #GST_RTSP_OK when @conn contains a valid connection. + a #GstRTSPUrl + storage for a #GstRTSPConnection - - + Create a new #GstRTSPConnection for handling communication on the existing +file descriptor @fd. The @initial_buffer contains any data already read from + + #GST_RTSP_OK when @conn contains a valid connection. - + a file descriptor + + the IP address of the other end - + the port used by the other end + + data already read from @fd + storage for a #GstRTSPConnection - - + + Convert @header to a #GstRTSPHeaderField. +header field is unknown. + + a #GstRTSPHeaderField for @header or #GST_RTSP_HDR_INVALID if the + a header string - - + + Convert @method to a #GstRTSPMethod. +method is unknown. + + a #GstRTSPMethod for @method or #GST_RTSP_INVALID if the + a method - + Check whether @field may appear multiple times in a message. - + %TRUE if multiple headers are allowed. + + a #GstRTSPHeaderField - + + Convert @field to a string. + a string representation of @field. + a #GstRTSPHeaderField - - + + Get the message type of @msg. + + the message type. + a #GstRTSPMessage - + + Create a new initialized #GstRTSPMessage. Free with gst_rtsp_message_free(). + a #GstRTSPResult. + + + + + a location for the new #GstRTSPMessage + + + + + + Create a new data #GstRTSPMessage with @channel and store the +result message in @msg. Free with gst_rtsp_message_free(). + + a #GstRTSPResult. + + + + + a location for the new #GstRTSPMessage + + + + the channel + + + + + + Create a new #GstRTSPMessage with @method and @uri and store the result +request message in @msg. Free with gst_rtsp_message_free(). + + a #GstRTSPResult. + + + + + a location for the new #GstRTSPMessage + + + + the request method to use + + + + the uri of the request + + + + + + Create a new response #GstRTSPMessage with @code and @reason and store the +result message in @msg. Free with gst_rtsp_message_free(). +When @reason is #NULL, the default reason for @code will be used. +When @request is not #NULL, the relevant headers will be copied to the new +response message. + + a #GstRTSPResult. + + + + + a location for the new #GstRTSPMessage + + + + the status code + + + + the status reason or #NULL + + + + the request that triggered the response or #NULL + + + + + + Convert @method to a string. + + a string representation of @method. + a #GstRTSPMethod - - + Convert @options to a string. + + a new string of @options. g_free() after usage. + one or more #GstRTSPMethod - + + Free the memory alocated by @range. + a #GstRTSPTimeRange - - + + Parse @rangestr to a #GstRTSPTimeRange. + + #GST_RTSP_OK on success. + a range string to parse + location to hold the #GstRTSPTimeRange result - - + Convert @range into a string representation. + + The string representation of @range. g_free() after usage. + a #GstRTSPTimeRange - + + Convert @code to a string. + a string representation of @code. + a #GstRTSPStatusCode - - + + Convert @result in a human readable string. + + a newly allocated string. g_free() after usage. + a #GstRTSPResult - - - - - - - - - - - - - - - - - - - - - + Get the #GStreamer element that can handle the buffers transported over It is possible that there are several managers available, use @option to selected one. -needed/available for @trans."> - +needed/available for @trans. + + #GST_RTSP_OK. + a #GstRTSPTransMode - - - + location to hold the result + - + option index. + - - + + Get the mime type of the transport mode @trans. This mime type is typically +used to generate #GstCaps on buffers. + + #GST_RTSP_OK. + a #GstRTSPTransMode - - - + location to hold the result + - - - - - - - - - - - - + + Allocate a new initialized #GstRTSPTransport. Use gst_rtsp_transport_free() +after usage. + + a #GstRTSPResult. + location to hold the new #GstRTSPTransport - - + + Parse the RTSP transport string @str into @transport. + + a #GstRTSPResult. + a transport string + a #GstRTSPTransport - - + + Parse the RTSP @urlstr into a newly allocated #GstRTSPUrl. Free after usage +with gst_rtsp_url_free(). + + a #GstRTSPResult. + the url string to parse + location to hold the result. - + + Convert @version to a string. + a string representation of @version. + a #GstRTSPVersion + + Create a watch object for @conn. The functions provided in @funcs will be +called with @user_data when activity happened on the watch. +The new watch is usually created so that it can be attached to a +maincontext with gst_rtsp_watch_attach(). +communication. Free with gst_rtsp_watch_unref () after usage. + + a #GstRTSPWatch that can be used for asynchronous RTSP + + + + + a #GstRTSPConnection + + + + watch functions + + + + user data to pass to @funcs + + + + notify when @user_data is not referenced anymore + + + + diff --git a/unmaintained/gstreamer/rtsp/ffi/ffi.factor b/unmaintained/gstreamer/plugins/rtsp/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/rtsp/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/rtsp/ffi/ffi.factor diff --git a/unmaintained/gstreamer/rtsp/rtsp.factor b/unmaintained/gstreamer/plugins/rtsp/rtsp.factor similarity index 100% rename from unmaintained/gstreamer/rtsp/rtsp.factor rename to unmaintained/gstreamer/plugins/rtsp/rtsp.factor diff --git a/unmaintained/gstreamer/plugins/sdp/GstSdp-0.10.gir b/unmaintained/gstreamer/plugins/sdp/GstSdp-0.10.gir new file mode 100644 index 0000000000..5cdb692729 --- /dev/null +++ b/unmaintained/gstreamer/plugins/sdp/GstSdp-0.10.gir @@ -0,0 +1,1220 @@ + + + + + + + + + + + + + + The contents of the SDP "a=" field which contains a key/value pair. + + + + + + + + + The contents of the SDP "b=" field which specifies the proposed bandwidth to +be used by the session or media. + + + + + + + + + The contents of the SDP "c=" field which contains connection data. + + + + + + + + + + + + + + + + + + The contents of the SDP "k=" field which is used to convey encryption +keys. + + + + + + + + + The contents of the SDP "m=" field with all related fields. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the attribute with @key and @value to @media. + + #GST_SDP_OK. + + + + + a key + + + + a value + + + + + + Add the bandwidth information with @bwtype and @bandwidth to @media. + + #GST_SDP_OK. + + + + + the bandwidth modifier type + + + + the bandwidth in kilobits per second + + + + + + Add the given connection parameters to @media. + + a #GstSDPResult. + + + + + the type of network. "IN" is defined to have the meaning "Internet". + + + + the type of address. + + + + the address + + + + the time to live of the address + + + + the number of layers + + + + + + Add the format information to @media. + + #GST_SDP_OK. + + + + + the format + + + + + + Convert the contents of @media to a text string. + + A dynamically allocated string representing the media. + + + + + Get the number of attribute fields in @media. + + the number of attributes in @media. + + + + + Get the number of bandwidth fields in @media. + + the number of bandwidths in @media. + + + + + Get the number of connection fields in @media. + + the number of connections in @media. + + + + + Get the number of formats in @media. + + the number of formats in @media. + + + + + Free all resources allocated by @media. @media should not be used anymore after +this function. This function should be used when @media was dynamically +allocated with gst_sdp_media_new(). + + a #GstSDPResult. + + + + + Get the attribute at position @idx in @media. + + the #GstSDPAttribute at position @idx. + + + + + an index + + + + + + Get the first attribute value for @key in @media. + + the first attribute value for @key. + + + + + a key + + + + + + Get the @nth attribute value for @key in @media. + + the @nth attribute value. + + + + + a key + + + + an index + + + + + + Get the bandwidth at position @idx in @media. + + the #GstSDPBandwidth at position @idx. + + + + + an index + + + + + + Get the connection at position @idx in @media. + + the #GstSDPConnection at position @idx. + + + + + an index + + + + + + Get the format information at position @idx in @media. + + the format at position @idx. + + + + + an index + + + + + + Get the information of @media + + the information of @media. + + + + + Get the encryption information from @media. + + a #GstSDPKey. + + + + + Get the media description of @media. + + the media description. + + + + + Get the number of ports for @media. + + the number of ports for @media. + + + + + Get the port number for @media. + + the port number of @media. + + + + + Get the transport protocol of @media + + the transport protocol of @media. + + + + + Initialize @media so that its contents are as if it was freshly allocated +with gst_sdp_media_new(). This function is mostly used to initialize a media +allocated on the stack. gst_sdp_media_uninit() undoes this operation. +When this function is invoked on newly allocated data (with malloc or on the +stack), its contents should be set to 0 before calling this function. + + a #GstSDPResult. + + + + + Set the media information of @media to @information. + + #GST_SDP_OK. + + + + + the media information + + + + + + Adds the encryption information to @media. + + a #GstSDPResult. + + + + + the encryption type + + + + the encryption data + + + + + + Set the media description of @media to @med. + + #GST_SDP_OK. + + + + + the media description + + + + + + Set the port information in @media. + + #GST_SDP_OK. + + + + + the port number + + + + the number of ports + + + + + + Set the media transport protocol of @media to @proto. + + #GST_SDP_OK. + + + + + the media transport protocol + + + + + + Free all resources allocated in @media. @media should not be used anymore after +this function. This function should be used when @media was allocated on the +stack and initialized with gst_sdp_media_init(). + + a #GstSDPResult. + + + + + + The contents of the SDP message. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Add the attribute with @key and @value to @msg. + + @GST_SDP_OK. + + + + + the key + + + + the value + + + + + + Add the specified bandwidth information to @msg. + + a #GstSDPResult. + + + + + the bandwidth modifier type + + + + the bandwidth in kilobits per second + + + + + + Add @email to the list of emails in @msg. + + a #GstSDPResult. + + + + + an email + + + + + + Adds @media to the array of medias in @msg. This function takes ownership of +the contents of @media so that @media will have to be reinitialized with +gst_media_init() before it can be used again. + + a #GstSDPResult. + + + + + a #GstSDPMedia to add + + + + + + Add @phone to the list of phones in @msg. + + a #GstSDPResult. + + + + + a phone + + + + + + Add time information @start and @stop to @msg. + + a #GstSDPResult. + + + + + the start time + + + + the stop time + + + + the repeat times + + + + + + Add time zone information to @msg. + + a #GstSDPResult. + + + + + the NTP time that a time zone adjustment happens + + + + the offset from the time when the session was first scheduled + + + + + + Convert the contents of @msg to a text string. + + A dynamically allocated string representing the SDP description. + + + + + Get the number of attributes in @msg. + + the number of attributes in @msg. + + + + + Get the number of bandwidth information in @msg. + + the number of bandwidth information in @msg. + + + + + Dump the parsed contents of @msg to stdout. + + a #GstSDPResult. + + + + + Get the number of emails in @msg. + + the number of emails in @msg. + + + + + Free all resources allocated by @msg. @msg should not be used anymore after +this function. This function should be used when @msg was dynamically +allocated with gst_sdp_message_new(). + + a #GstSDPResult. + + + + + Get the attribute at position @idx in @msg. + + the #GstSDPAttribute at position @idx. + + + + + the index + + + + + + Get the first attribute with key @key in @msg. + + the attribute value of the first attribute with @key. + + + + + the key + + + + + + Get the @nth attribute with key @key in @msg. + + the attribute value of the @nth attribute with @key. + + + + + the key + + + + the index + + + + + + Get the bandwidth at index @idx from @msg. + + a #GstSDPBandwidth. + + + + + the bandwidth index + + + + + + Get the connection of @msg. + + a #GstSDPConnection. The result remains valid as long as @msg is valid. + + + + + Get the email with number @idx from @msg. + + the email at position @idx. + + + + + an email index + + + + + + Get the information in @msg. + + a #GstSDPResult. + + + + + Get the encryption information from @msg. + + a #GstSDPKey. + + + + + Get the media description at index @idx in @msg. + + a #GstSDPMedia. + + + + + the index + + + + + + Get the origin of @msg. + + a #GstSDPOrigin. The result remains valid as long as @msg is valid. + + + + + Get the phone with number @idx from @msg. + + the phone at position @idx. + + + + + a phone index + + + + + + Get the session name in @msg. + + a #GstSDPResult. + + + + + Get time information with index @idx from @msg. + + a #GstSDPTime. + + + + + the time index + + + + + + Get the URI in @msg. + + a #GstSDPResult. + + + + + Get the version in @msg. + + a #GstSDPResult. + + + + + Get time zone information with index @idx from @msg. + + a #GstSDPZone. + + + + + the zone index + + + + + + Initialize @msg so that its contents are as if it was freshly allocated +with gst_sdp_message_new(). This function is mostly used to initialize a message +allocated on the stack. gst_sdp_message_uninit() undoes this operation. +When this function is invoked on newly allocated data (with malloc or on the +stack), its contents should be set to 0 before calling this function. + + a #GstSDPResult. + + + + + Get the number of media descriptions in @msg. + + the number of media descriptions in @msg. + + + + + Get the number of phones in @msg. + + the number of phones in @msg. + + + + + Configure the SDP connection in @msg with the given parameters. + + a #GstSDPResult. + + + + + the type of network. "IN" is defined to have the meaning "Internet". + + + + the type of address. + + + + the address + + + + the time to live of the address + + + + the number of layers + + + + + + Set the information in @msg. + + a #GstSDPResult. + + + + + the information + + + + + + Adds the encryption information to @msg. + + a #GstSDPResult. + + + + + the encryption type + + + + the encryption data + + + + + + Configure the SDP origin in @msg with the given parameters. + + #GST_SDP_OK. + + + + + the user name + + + + a session id + + + + a session version + + + + a network type + + + + an address type + + + + an address + + + + + + Set the session name in @msg. + + a #GstSDPResult. + + + + + the session name + + + + + + Set the URI in @msg. + + a #GstSDPResult. + + + + + the URI + + + + + + Set the version in @msg. + + a #GstSDPResult. + + + + + the version + + + + + + Get the number of time information entries in @msg. + + the number of time information entries in @msg. + + + + + Free all resources allocated in @msg. @msg should not be used anymore after +this function. This function should be used when @msg was allocated on the +stack and initialized with gst_sdp_message_init(). + + a #GstSDPResult. + + + + + Get the number of time zone information entries in @msg. + + the number of time zone information entries in @msg. + + + + + + The contents of the SDP "o=" field which gives the originator of the session +(their username and the address of the user's host) plus a session id and +session version number. + + + + + + + + + + + + + + + + + + + + + Return values for the SDP functions. + + + + + The contents of the SDP "t=" field which specify the start and stop times for +a conference session. + + + + + + + + + + + + + + The contents of the SDP "z=" field which allows the sender to +specify a list of time zone adjustments and offsets from the base +time. + + + + + + + + + + + + + + + + + + + + + + + + Check if the given @addr is a multicast address. + + TRUE when @addr is multicast. + + + + + a network type + + + + an address type + + + + an address + + + + + + Allocate a new GstSDPMedia and store the result in @media. + + a #GstSDPResult. + + + + + pointer to new #GstSDPMedia + + + + + + Creates a uri from @msg with the given @scheme. The uri has the format: +Where each value is url encoded. + + a uri for @msg. + + + + + the uri scheme + + + + the #GstSDPMessage + + + + + + Allocate a new GstSDPMessage and store the result in @msg. + + a #GstSDPResult. + + + + + pointer to new #GstSDPMessage + + + + + + Parse the contents of @size bytes pointed to by @data and store the result in + + #GST_SDP_OK on success. + + + + + the start of the buffer + + + + the size of the buffer + + + + the result #GstSDPMessage + + + + + + Parse the null-terminated @uri and store the result in @msg. +The uri should be of the form: +scheme://[address[:ttl=ttl][:noa=noa]]/[sessionname] +[#type=value *[&type=value]] +where value is url encoded. This looslely resembles +http://tools.ietf.org/html/draft-fujikawa-sdp-url-01 + + #GST_SDP_OK on success. + + + + + the start of the uri + + + + the result #GstSDPMessage + + + + + + diff --git a/unmaintained/gstreamer/sdp/ffi/ffi.factor b/unmaintained/gstreamer/plugins/sdp/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/sdp/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/sdp/ffi/ffi.factor diff --git a/unmaintained/gstreamer/sdp/sdp.factor b/unmaintained/gstreamer/plugins/sdp/sdp.factor similarity index 100% rename from unmaintained/gstreamer/sdp/sdp.factor rename to unmaintained/gstreamer/plugins/sdp/sdp.factor diff --git a/unmaintained/gstreamer/plugins/tag/GstTag-0.10.gir b/unmaintained/gstreamer/plugins/tag/GstTag-0.10.gir new file mode 100644 index 0000000000..a1a2fc486c --- /dev/null +++ b/unmaintained/gstreamer/plugins/tag/GstTag-0.10.gir @@ -0,0 +1,963 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Opaque #GstTagDemux structure. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The #GstTagDemuxClass structure. See documentation at beginning of section +for details about what subclasses need to override and do. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Result values from the parse_tag virtual function. + + + + + + Type of image contained in an image tag (specified as field in +the image buffer's caps structure) + + + + + + + + + + + + + + + + + + + + + + + Convenience function to read a string with unknown character encoding. If +the string is already in UTF-8 encoding, it will be returned right away. +If not it tries to detect byte-order-mark for UTF-16/32 cases and use that. +Otherwise, the environment will be searched for a number of environment +variables (whose names are specified in the NULL-terminated string array +are specified, the current locale will be tried. If that also doesn't work, +WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed). + + a newly-allocated string in UTF-8 encoding, or NULL + + + + + string data + + + + length of string data, or -1 if the string is NUL-terminated + + + + a NULL-terminated string array of environment variable names, or NULL + + + + + + Looks up the GStreamer tag for a ID3v2 tag. + + The corresponding GStreamer tag or NULL if none exists. + + + + + ID3v2 tag to convert to GStreamer tag + + + + + + Looks up the GStreamer tag for an ID3v2 user tag (e.g. description in +TXXX frame or owner in UFID frame). + + The corresponding GStreamer tag or NULL if none exists. + + + + + the type of ID3v2 user tag (e.g. "TXXX" or "UDIF") + + + + ID3v2 user tag to convert to GStreamer tag + + + + + + Looks up the GStreamer tag for a vorbiscomment tag. + + The corresponding GStreamer tag or NULL if none exists. + + + + + vorbiscomment tag to convert to GStreamer tag + + + + + + Returns two-letter ISO-639-1 language code given a three-letter ISO-639-2 +language code or two-letter ISO-639-1 language code (both are accepted for +convenience). +Language codes are case-sensitive and expected to be lower case. +or NULL if no mapping is known. The returned string must not be +modified or freed. + + two-letter ISO-639-1 language code string that maps to @lang_code, + + + + + ISO-639 language code (e.g. "deu" or "ger" or "de") + + + + + + Returns three-letter ISO-639-2 "bibliographic" language code given a +two-letter ISO-639-1 language code or a three-letter ISO-639-2 language +code (both are accepted for convenience). +The "bibliographic" code is derived from the English name of the language +(e.g. "ger" for German instead of "de" or "deu"). In most scenarios, the +"terminological" codes are prefered. +Language codes are case-sensitive and expected to be lower case. +or NULL if no mapping is known. The returned string must not be +modified or freed. + + three-letter ISO-639-2 language code string that maps to @lang_code, + + + + + ISO-639 language code (e.g. "deu" or "ger" or "de") + + + + + + Returns three-letter ISO-639-2 "terminological" language code given a +two-letter ISO-639-1 language code or a three-letter ISO-639-2 language +code (both are accepted for convenience). +The "terminological" code is derived from the local name of the language +(e.g. "deu" for German instead of "ger"). In most scenarios, the +"terminological" codes are prefered over the "bibliographic" ones. +Language codes are case-sensitive and expected to be lower case. +or NULL if no mapping is known. The returned string must not be +modified or freed. + + three-letter ISO-639-2 language code string that maps to @lang_code, + + + + + ISO-639 language code (e.g. "deu" or "ger" or "de") + + + + + + Returns a list of known language codes (in form of two-letter ISO-639-1 +codes). This is useful for UIs to build a list of available languages for +tagging purposes (e.g. to tag an audio track appropriately in a video or +audio editor). +with g_strfreev() when no longer needed. + + NULL-terminated string array with two-letter language codes. Free + + + + + + + Returns the name of the language given an ISO-639 language code, such +as often found in a GST_TAG_LANGUAGE tag. The name will be translated +according to the current locale (if the library was built against the +iso-codes package, otherwise the English name will be returned). +Language codes are case-sensitive and expected to be lower case. +not be mapped to a language name. The returned string must not be +modified and does not need to freed; it will stay valid until the +application is terminated. + + language name in UTF-8 format, or NULL if @language_code could + + + + + two or three-letter ISO-639 language code + + + + + + Gets the number of ID3v1 genres that can be identified. Winamp genres are +included. + + the number of ID3v1 genres that can be identified + + + + + Gets the ID3v1 genre name for a given ID. + + the genre or NULL if no genre is associated with that ID. + + + + + ID of genre to query + + + + + + Helper function for tag-reading plugins to create a #GstBuffer suitable to +add to a #GstTagList as an image tag (such as #GST_TAG_IMAGE or +#GST_TAG_PREVIEW_IMAGE) from the encoded image data and an (optional) image +type. +blob of binary image data, often accompanied by a MIME type or some other +content type string (e.g. 'png', 'jpeg', 'jpg'). Sometimes there is also an +'image type' to indicate what kind of image this is (e.g. front cover, +back cover, artist, etc.). The image data may also be an URI to the image +rather than the image itself. +In GStreamer, image tags are #GstBuffer<!-- -->s containing the raw image +data, with the buffer caps describing the content type of the image +(e.g. image/jpeg, image/png, text/uri-list). The buffer caps may contain +an additional 'image-type' field of #GST_TYPE_TAG_IMAGE_TYPE to describe +the type of image (front cover, back cover etc.). #GST_TAG_PREVIEW_IMAGE +tags should not carry an image type, their type is already indicated via +the special tag name. +This function will do various checks and typefind the encoded image +data (we can't trust the declared mime type). + + a newly-allocated image buffer for use in tag lists, or NULL + + + + + the (encoded) image + + + + the length of the encoded image data at @image_data + + + + type of the image, or #GST_TAG_IMAGE_TYPE_UNDEFINED. Pass #GST_TAG_IMAGE_TYPE_NONE if no image type should be set at all (e.g. for preview images) + + + + + + Adds an image from an ID3 APIC frame (or similar, such as used in FLAC) +to the given tag list. Also see gst_tag_image_data_to_image_buffer() for +more information on image tags in GStreamer. + + %TRUE if the image was processed, otherwise %FALSE + + + + + a tag list + + + + the (encoded) image + + + + the length of the encoded image data at @image_data + + + + picture type as per the ID3 (v2.4.0) specification for the APIC frame (0 = unknown/other) + + + + + + Parses the IFD and IFD tags data contained in the buffer and puts it +on a taglist. The base_offset is used to subtract from the offset in +the tag entries and be able to get the offset relative to the buffer +start + + The parsed taglist + + + + + The exif buffer + + + + byte order of the data + + + + Offset from the tiff header to this buffer + + + + + + Parses the exif tags starting with a tiff header structure. + + The taglist + + + + + The exif buffer + + + + + + Creates a new tag list that contains the information parsed out of a +vorbiscomment packet. +given vorbiscomment buffer or NULL on error. + + A new #GstTagList with all tags that could be extracted from the + + + + + buffer to convert + + + + identification data at start of stream + + + + length of identification data + + + + pointer to a string that should take the vendor string of this vorbis comment or NULL if you don't need it. + + + + + + Parse a xmp packet into a taglist. + + new taglist or %NULL, free the list when done + + + + + buffer + + + + + + Parses the data containing an ID3v1 tag and returns a #GstTagList from the +parsed data. + + A new tag list or NULL if the data was not an ID3v1 tag. + + + + + 128 bytes of data containing the ID3v1 tag + + + + + + Formats the tags in taglist on exif format. The resulting buffer contains +the tags IFD and is followed by the data pointed by the tag entries. + + A GstBuffer containing the tag entries followed by the tag data + + + + + The taglist + + + + byte order used in writing (G_LITTLE_ENDIAN or G_BIG_ENDIAN) + + + + Offset from the tiff header first byte + + + + + + Formats the tags in taglist into exif structure, a tiff header +is put in the beginning of the buffer. + + A GstBuffer containing the data + + + + + The taglist + + + + + + Creates a new vorbiscomment buffer from a tag list. +that could be converted from the given tag list. + + A new #GstBuffer containing a vorbiscomment buffer with all tags + + + + + tag list to convert + + + + identification data at start of stream + + + + length of identification data, may be 0 if @id_data is NULL + + + + string that describes the vendor string or NULL + + + + + + Formats a taglist as a xmp packet. + + new buffer or %NULL, unref the buffer when done + + + + + tags + + + + does the container forbid inplace editing + + + + + + Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and +separate it into its components. +If successful, @key, @lang and/or @value will be set to newly allocated +strings that you need to free with g_free() when done. @key and @lang +may also be set to NULL by this function if there is no key or no language +code in the extended comment string. + + TRUE if the string could be parsed, otherwise FALSE + + + + + an extended comment string, see #GST_TAG_EXTENDED_COMMENT + + + + return location for the comment description key, or NULL + + + + return location for the comment ISO-639 language code, or NULL + + + + return location for the actual comment string, or NULL + + + + whether to fail if strings are not in key=value form + + + + + + + + + + + Looks up the ID3v2 tag for a GStreamer tag. + + The corresponding ID3v2 tag or NULL if none exists. + + + + + GStreamer tag to convert to vorbiscomment tag + + + + + + Creates a new tag list that contains the information parsed out of a +vorbiscomment packet. +g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list) + + A #GList of newly-allowcated key=value strings. Free with + + + + + + + a #GstTagList + + + + a GStreamer tag identifier, such as #GST_TAG_ARTIST + + + + + + Looks up the vorbiscomment tag for a GStreamer tag. + + The corresponding vorbiscomment tag or NULL if none exists. + + + + + GStreamer tag to convert to vorbiscomment tag + + + + + + Convenience function using gst_tag_from_vorbis_tag(), parsing +a vorbis comment string into the right type and adding it to the +given taglist @list. +Unknown vorbiscomment tags will be added to the tag list in form +of a #GST_TAG_EXTENDED_COMMENT (since 0.10.10 at least). + + + + + + a #GstTagList + + + + a vorbiscomment tag string (key in key=value), must be valid UTF-8 + + + + a vorbiscomment value string (value in key=value), must be valid UTF-8 + + + + + + diff --git a/unmaintained/gstreamer/tag/ffi/ffi.factor b/unmaintained/gstreamer/plugins/tag/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/tag/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/tag/ffi/ffi.factor diff --git a/unmaintained/gstreamer/tag/tag.factor b/unmaintained/gstreamer/plugins/tag/tag.factor similarity index 100% rename from unmaintained/gstreamer/tag/tag.factor rename to unmaintained/gstreamer/plugins/tag/tag.factor diff --git a/unmaintained/gstreamer/plugins/video/GstVideo-0.10.gir b/unmaintained/gstreamer/plugins/video/GstVideo-0.10.gir new file mode 100644 index 0000000000..ba39781f06 --- /dev/null +++ b/unmaintained/gstreamer/plugins/video/GstVideo-0.10.gir @@ -0,0 +1,1188 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Enum value describing the most common video formats. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Helper structure representing a rectangular area. + + + + + + + + + + + + + + + The video sink instance structure. Derived video sinks should set the + + Takes @src rectangle and position it at the center of @dst rectangle with or +without @scaling. It handles clipping if the @src rectangle is bigger than +the @dst one and @scaling is set to FALSE. + + + + + + the #GstVideoRectangle describing the source area + + + + the #GstVideoRectangle describing the destination area + + + + a pointer to a #GstVideoRectangle which will receive the result area + + + + a #gboolean indicating if scaling should be applied or not + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The video sink class structure. Derived classes should override the + + + + + + + + + + + + + + + + + + + + + + + + + + + + Given the Pixel Aspect Ratio and size of an input video frame, and the +pixel aspect ratio of the intended display device, calculates the actual +display ratio the video will be rendered with. +dar_n and dar_d parameters. +The return value is FALSE in the case of integer overflow or other error. + + A boolean indicating success and a calculated Display Ratio in the + + + + + Numerator of the calculated display_ratio + + + + Denominator of the calculated display_ratio + + + + Width of the video frame in pixels + + + + Height of the video frame in pixels + + + + Numerator of the pixel aspect ratio of the input video. + + + + Denominator of the pixel aspect ratio of the input video. + + + + Numerator of the pixel aspect ratio of the display device + + + + Denominator of the pixel aspect ratio of the display device + + + + + + Converts a raw video buffer into the specified output caps. +The output caps can be any raw video formats or any image formats (jpeg, png, ...). +The width, height and pixel-aspect-ratio can also be specified in the output caps. +will point to the #GError). + + The converted #GstBuffer, or %NULL if an error happened (in which case @err + + + + + a #GstBuffer + + + + the #GstCaps to convert to + + + + the maximum amount of time allowed for the processing. + + + + + + Converts a raw video buffer into the specified output caps. +The output caps can be any raw video formats or any image formats (jpeg, png, ...). +The width, height and pixel-aspect-ratio can also be specified in the output caps. +finish after @timeout. @callback will always be called from the thread default +%GMainContext, see g_main_context_get_thread_default(). If GLib before 2.22 is used, +this will always be the global default main context. +anymore. + + + + + + a #GstBuffer + + + + the #GstCaps to convert to + + + + the maximum amount of time allowed for the processing. + + + + %GstVideoConvertFrameCallback that will be called after conversion. + + + + + + + %GDestroyNotify to be called after @user_data is not needed anymore + + + + + + Creates a new Still Frame event. If @in_still is %TRUE, then the event +represents the start of a still frame sequence. If it is %FALSE, then +the event ends a still frame sequence. +To parse an event created by gst_video_event_new_still_frame() use +gst_video_event_parse_still_frame(). + + The new GstEvent + + + + + boolean value for the still-frame state of the event. + + + + + + Parse a #GstEvent, identify if it is a Still Frame event, and +return the still-frame state from the event if it is. +If the event represents the start of a still frame, the in_still +variable will be set to TRUE, otherwise FALSE. It is OK to pass NULL for the +in_still variable order to just check whether the event is a valid still-frame +event. +Create a still frame event using gst_video_event_new_still_frame() + + %TRUE if the event is a valid still-frame event. %FALSE if not + + + + + A #GstEvent to parse + + + + A boolean to receive the still-frame status from the event, or NULL + + + + + + Converts among various #GstFormat types. This function handles +GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For +raw video, GST_FORMAT_DEFAULT corresponds to video frames. This +function can be to handle pad queries of the type GST_QUERY_CONVERT. + + TRUE if the conversion was successful. + + + + + a #GstVideoFormat + + + + the width of video + + + + the height of video + + + + frame rate numerator + + + + frame rate denominator + + + + #GstFormat of the @src_value + + + + value to convert + + + + #GstFormat of the @dest_value + + + + pointer to destination value + + + + + + Converts a FOURCC value into the corresponding #GstVideoFormat. +If the FOURCC cannot be represented by #GstVideoFormat, +#GST_VIDEO_FORMAT_UNKNOWN is returned. + + the #GstVideoFormat describing the FOURCC value + + + + + a FOURCC value representing raw YUV video + + + + + + Calculates the height of the component. See +of the component index. + + height of component @component + + + + + a #GstVideoFormat + + + + the component index + + + + the height of video + + + + + + Calculates the offset (in bytes) of the first pixel of the component +with index @component. For packed formats, this will typically be a +small integer (0, 1, 2, 3). For planar formats, this will be a +(relatively) large offset to the beginning of the second or third +component planes. See @gst_video_format_get_row_stride for a description +of the component index. + + offset of component @component + + + + + a #GstVideoFormat + + + + the component index + + + + the width of video + + + + the height of video + + + + + + Calculates the width of the component. See +of the component index. + + width of component @component + + + + + a #GstVideoFormat + + + + the component index + + + + the width of video + + + + + + Calculates the pixel stride (number of bytes from one pixel to the +pixel to its immediate left) for the video component with an index +of @component. See @gst_video_format_get_row_stride for a description +of the component index. + + pixel stride of component @component + + + + + a #GstVideoFormat + + + + the component index + + + + + + Calculates the row stride (number of bytes from one row of pixels to +the next) for the video component with an index of @component. For +YUV video, Y, U, and V have component indices of 0, 1, and 2, +respectively. For RGB video, R, G, and B have component indicies of +0, 1, and 2, respectively. Alpha channels, if present, have a component +index of 3. The @width parameter always represents the width of the +video, not the component. + + row stride of component @component + + + + + a #GstVideoFormat + + + + the component index + + + + the width of video + + + + + + Calculates the total number of bytes in the raw video format. This +number should be used when allocating a buffer for raw video. + + size (in bytes) of raw video format + + + + + a #GstVideoFormat + + + + the width of video + + + + the height of video + + + + + + Returns TRUE or FALSE depending on if the video format provides an +alpha channel. + + TRUE if @format has an alpha channel + + + + + a #GstVideoFormat + + + + + + Determine whether the video format is a grayscale format. + + TRUE if @format represents grayscale video + + + + + a #GstVideoFormat + + + + + + Determine whether the video format is an RGB format. + + TRUE if @format represents RGB video + + + + + a #GstVideoFormat + + + + + + Determine whether the video format is a YUV format. + + TRUE if @format represents YUV video + + + + + a #GstVideoFormat + + + + + + Creates a new #GstCaps object based on the parameters provided. + + a new #GstCaps object, or NULL if there was an error + + + + + the #GstVideoFormat describing the raw video format + + + + width of video + + + + height of video + + + + numerator of frame rate + + + + denominator of frame rate + + + + numerator of pixel aspect ratio + + + + denominator of pixel aspect ratio + + + + + + Creates a new #GstCaps object based on the parameters provided. + + a new #GstCaps object, or NULL if there was an error + + + + + the #GstVideoFormat describing the raw video format + + + + width of video + + + + height of video + + + + numerator of frame rate + + + + denominator of frame rate + + + + numerator of pixel aspect ratio + + + + denominator of pixel aspect ratio + + + + #TRUE if the format is interlaced + + + + + + Determines the #GstVideoFormat of @caps and places it in the location +pointed to by @format. Extracts the size of the video and places it +in the location pointed to by @width and @height. If @caps does not +represent one of the raw video formats listed in #GstVideoFormat, the +function will fail and return FALSE. + + TRUE if @caps was parsed correctly. + + + + + the #GstCaps to parse + + + + the #GstVideoFormat of the video represented by @caps (output) + + + + the width of the video represented by @caps, may be NULL (output) + + + + the height of the video represented by @caps, may be NULL (output) + + + + + + Extracts whether the caps represents interlaced content or not and places it +in @interlaced. + + TRUE if @caps was parsed correctly. + + + + + the fixed #GstCaps to parse + + + + whether @caps represents interlaced video or not, may be NULL (output) + + + + + + Converts a #GstVideoFormat value into the corresponding FOURCC. Only +a few YUV formats have corresponding FOURCC values. If @format has +no corresponding FOURCC value, 0 is returned. + + the FOURCC corresponding to @format + + + + + a #GstVideoFormat video format + + + + + + A convenience function to retrieve a GValue holding the framerate +from the caps on a pad. +The pad needs to have negotiated caps containing a framerate property. +do not contain a framerate. + + NULL if the pad has no configured caps or the configured caps + + + + + pointer to a #GstPad + + + + + + Inspect the caps of the provided pad and retrieve the width and height of +the video frames it is configured for. +The pad needs to have negotiated caps containing width and height properties. + + TRUE if the width and height could be retrieved. + + + + + pointer to a #GstPad + + + + pointer to integer to hold pixel width of the video frames (output) + + + + pointer to integer to hold pixel height of the video frames (output) + + + + + + Extracts the chroma site used by the caps. Possible values are +"mpeg2" for MPEG-2 style chroma siting (co-sited horizontally, +halfway-sited vertically), "jpeg" for JPEG and Theora style +chroma siting (halfway-sited both horizontally and vertically). +Other chroma site values are possible, but uncommon. +When no chroma site is specified in the caps, it should be assumed +to be "mpeg2". +determined. + + a chroma site string, or NULL if no chroma site could be + + + + + the fixed #GstCaps to parse + + + + + + Extracts the color matrix used by the caps. Possible values are +"sdtv" for the standard definition color matrix (as specified in +Rec. ITU-R BT.470-6) or "hdtv" for the high definition color +matrix (as specified in Rec. ITU-R BT.709) +determined. + + a color matrix string, or NULL if no color matrix could be + + + + + the fixed #GstCaps to parse + + + + + + Extracts the frame rate from @caps and places the values in the locations +pointed to by @fps_n and @fps_d. Returns TRUE if the values could be +parsed correctly, FALSE if not. +This function can be used with #GstCaps that have any media type; it +is not limited to formats handled by #GstVideoFormat. + + TRUE if @caps was parsed correctly. + + + + + pointer to a #GstCaps instance + + + + pointer to integer to hold numerator of frame rate (output) + + + + pointer to integer to hold denominator of frame rate (output) + + + + + + Returns the palette data from the caps as a #GstBuffer. For +#GST_VIDEO_FORMAT_RGB8_PALETTED this is containing 256 #guint32 +values, each containing ARGB colors in native endianness. + + a #GstBuffer containing the palette data. Unref after usage. + + + + + #GstCaps to parse + + + + + + Extracts the pixel aspect ratio from @caps and places the values in +the locations pointed to by @par_n and @par_d. Returns TRUE if the +values could be parsed correctly, FALSE if not. +This function can be used with #GstCaps that have any media type; it +is not limited to formats handled by #GstVideoFormat. + + TRUE if @caps was parsed correctly. + + + + + pointer to a #GstCaps instance + + + + pointer to numerator of pixel aspect ratio (output) + + + + pointer to denominator of pixel aspect ratio (output) + + + + + + diff --git a/unmaintained/gstreamer/video/ffi/ffi.factor b/unmaintained/gstreamer/plugins/video/ffi/ffi.factor similarity index 100% rename from unmaintained/gstreamer/video/ffi/ffi.factor rename to unmaintained/gstreamer/plugins/video/ffi/ffi.factor diff --git a/unmaintained/gstreamer/video/video.factor b/unmaintained/gstreamer/plugins/video/video.factor similarity index 100% rename from unmaintained/gstreamer/video/video.factor rename to unmaintained/gstreamer/plugins/video/video.factor diff --git a/unmaintained/gstreamer/riff/GstRiff-0.10.gir b/unmaintained/gstreamer/riff/GstRiff-0.10.gir deleted file mode 100644 index d3c7519f58..0000000000 --- a/unmaintained/gstreamer/riff/GstRiff-0.10.gir +++ /dev/null @@ -1,983 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/rtp/GstRtp-0.10.gir b/unmaintained/gstreamer/rtp/GstRtp-0.10.gir deleted file mode 100644 index e72015073a..0000000000 --- a/unmaintained/gstreamer/rtp/GstRtp-0.10.gir +++ /dev/null @@ -1,2550 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/sdp/GstSdp-0.10.gir b/unmaintained/gstreamer/sdp/GstSdp-0.10.gir deleted file mode 100644 index 16f62f6f58..0000000000 --- a/unmaintained/gstreamer/sdp/GstSdp-0.10.gir +++ /dev/null @@ -1,1056 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/tag/GstTag-0.10.gir b/unmaintained/gstreamer/tag/GstTag-0.10.gir deleted file mode 100644 index f5714599bb..0000000000 --- a/unmaintained/gstreamer/tag/GstTag-0.10.gir +++ /dev/null @@ -1,797 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/unmaintained/gstreamer/video/GstVideo-0.10.gir b/unmaintained/gstreamer/video/GstVideo-0.10.gir deleted file mode 100644 index ff905a0d8f..0000000000 --- a/unmaintained/gstreamer/video/GstVideo-0.10.gir +++ /dev/null @@ -1,925 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - From 2704822cc7e6fafa7667adb38067a8663d9fe65e Mon Sep 17 00:00:00 2001 From: Anton Gorenko Date: Sun, 6 Mar 2011 01:05:02 +0600 Subject: [PATCH 76/76] gobject-introspection: internal strucs (*Class, *Iface or *Private) are generated in .private vocabularies; --- basis/gobject-introspection/ffi/ffi.factor | 29 +++++++++++++++---- .../loader/loader.factor | 1 + .../repository/repository.factor | 3 +- 3 files changed, 26 insertions(+), 7 deletions(-) diff --git a/basis/gobject-introspection/ffi/ffi.factor b/basis/gobject-introspection/ffi/ffi.factor index 53f0944c20..3b56c78a2a 100644 --- a/basis/gobject-introspection/ffi/ffi.factor +++ b/basis/gobject-introspection/ffi/ffi.factor @@ -1,10 +1,11 @@ ! Copyright (C) 2010 Anton Gorenko. ! See http://factorcode.org/license.txt for BSD license. USING: accessors alien.c-types alien.parser arrays ascii -classes.parser classes.struct combinators gobject-introspection.common -gobject-introspection.repository gobject-introspection.types kernel -locals make math.parser namespaces parser sequences -splitting.monotonic words words.constant ; +classes.parser classes.struct combinators combinators.short-circuit +gobject-introspection.common gobject-introspection.repository +gobject-introspection.types kernel locals make math.parser namespaces +parser sequences splitting.monotonic vocabs.parser words +words.constant ; IN: gobject-introspection.ffi SYMBOL: constant-prefix @@ -226,6 +227,14 @@ M: array-type field-type>c-type type>c-type ; : def-union-type ( union -- ) c-type>> void def-c-type ; +: private-record? ( record -- ? ) + { + [ struct-for>> ] + [ name>> "Class" tail? ] + [ name>> "Private" tail? ] + [ name>> "Iface" tail? ] + } 1|| ; + : def-union ( union -- ) { [ def-union-type ] @@ -286,22 +295,30 @@ M: array-type field-type>c-type type>c-type ; : defer-enums ( enums -- ) enum-info defer-types ; : defer-bitfields ( bitfields -- ) bitfield-info defer-types ; -: defer-records ( records -- ) record-info defer-types ; : defer-unions ( unions -- ) union-info defer-types ; : defer-boxeds ( boxeds -- ) boxed-info defer-types ; : defer-callbacks ( callbacks -- ) callback-info defer-types ; : defer-interfaces ( interfaces -- ) interface-info defer-types ; : defer-classes ( class -- ) class-info defer-types ; +: defer-records ( records -- ) + [ private-record? ] partition + [ begin-private record-info defer-types end-private ] + [ record-info defer-types ] bi* ; + : def-enums ( enums -- ) [ def-enum-type ] each ; : def-bitfields ( bitfields -- ) [ def-bitfield-type ] each ; -: def-records ( records -- ) [ def-record ] each ; : def-unions ( unions -- ) [ def-union ] each ; : def-boxeds ( boxeds -- ) [ def-boxed-type ] each ; : def-callbacks ( callbacks -- ) [ def-callback-type ] each ; : def-interfaces ( interfaces -- ) [ def-interface ] each ; : def-classes ( classes -- ) [ def-class ] each ; +: def-records ( records -- ) + [ private-record? ] partition + [ begin-private [ def-record ] each end-private ] + [ [ def-record ] each ] bi* ; + : def-namespace ( namespace -- ) { [ symbol-prefixes>> first >upper constant-prefix set ] diff --git a/basis/gobject-introspection/loader/loader.factor b/basis/gobject-introspection/loader/loader.factor index 3bc139e35b..aedd07231a 100644 --- a/basis/gobject-introspection/loader/loader.factor +++ b/basis/gobject-introspection/loader/loader.factor @@ -133,6 +133,7 @@ CONSTANT: type-tags [ "method" load-functions >>methods ] [ "function" load-functions >>functions ] [ "disguised" attr "1" = >>disguised? ] + [ "is-gtype-struct-for" attr >>struct-for ] } cleave ; : xml>union ( xml -- union ) diff --git a/basis/gobject-introspection/repository/repository.factor b/basis/gobject-introspection/repository/repository.factor index 4344c99526..87ebcb1308 100644 --- a/basis/gobject-introspection/repository/repository.factor +++ b/basis/gobject-introspection/repository/repository.factor @@ -66,7 +66,8 @@ TUPLE: record < type constructors methods functions - disguised? ; + disguised? + struct-for ; TUPLE: field name